Просмотр кода страницы Визуализация сотовой диаграммы


= Визуализация сотовой диаграммы =
'''Руководство'''

== Когда использовать визуализацию сотовой диаграммы ==
Визуализация сотовой диаграммы обеспечивает компактное представление метрик с высокой плотностью across множества сущностей, идеально подходящее для мониторинга инфраструктуры. Используйте её для выявления горячих точек, группировки кластеров и детализации данных.

== Взаимодействие с графиком ==

=== Взаимодействие с выделением ===

* Наведите курсор, чтобы отобразить всплывающую подсказку с подробностями.
* Выберите, чтобы закрепить отображаемую всплывающую подсказку открытой; затем вы можете навести курсор на всплывающую подсказку, чтобы отобразить меню опций, специфичных для выделения.
* Доступные опции меню зависят от ваших данных и выбранной визуализации.
* Подменю узла предлагает опции, специфичные для узла, такие как:
** '''Копировать узел''' — копирует узел.
** '''Копировать значение''' — копирует значение узла.

== Заголовок ==
Используйте поле заголовка в верхней части панели параметров (изначально '''Плитка без названия''' или '''Раздел без названия'''), чтобы добавить заголовок к вашей плитке дашборда или разделу блокнота.

* Вы можете использовать эмодзи, такие как 😃 и 🌍 и ❤️.
* Вы можете использовать переменные.

'''Пример:'''

# Определите переменные с именами <code>Status</code> и <code>Emoji</code> на вашем дашборде.
# Установите заголовок в <code>Current $Emoji status is $Status</code>.
# Установите <code>Status</code> в <code>Good</code>.
# Установите <code>Emoji</code> в 🌍.

Заголовок будет отображаться как <code>Current 🌍 status is Good</code>.

== Визуализация ==
Если вы не уверены, что выбрали правильную визуализацию, используйте селектор визуализации, чтобы попробовать разные визуализации.

== Сопоставление данных ==
Раздел '''Сопоставление данных''' показывает, как столбец вашего результата сопоставляется с визуализацией.

'''Разверните для общих правил по настройкам сопоставления данных'''

Разверните раздел '''Сопоставление данных''' настроек визуализации, чтобы увидеть, как данные в вашем результате сопоставляются с визуализацией, и настроить эти параметры при необходимости.

Обязательные поля помечены звёздочкой (*).

Типы данных отображаются рядом с именами полей в раскрывающихся списках и сопоставленных полях.

Единицы измерения отображаются, когда назначена только одна.

Поля результата группируются в '''Подходящие''' и '''Неподходящие'''. Поля помечаются как неподходящие, если их нельзя использовать для отображения данных в визуализации.

'''Автоматическое применение настроек сопоставления данных по умолчанию:'''

'''Версия Ключ-АСТРОМ 1.319+'''

* Уже существующие плитки и разделы считаются определёнными пользователем. Их конфигурации сопоставления данных не обновляются автоматически.
* Вновь созданные плитки и разделы применяют настройку сопоставления данных по умолчанию. Если вы не измените эти настройки вручную, они могут измениться, если новое выполнение плитки/раздела изменит результаты и появятся отсутствующие поля или новые поля, которые лучше подходят для сопоставления данных.

=== Настройки сопоставления данных, специфичные для визуализации ===
Для визуализации сотовой диаграммы раздел сопоставления данных включает:

* '''Значение''': числовое/строковое поле из вашего запроса, которое вы хотите сопоставить с ячейкой.
* '''Имена''': отображаемые элементы, например в легенде и именах серий.

== Параметры сотовой диаграммы ==
Чтобы быстро узнать об опциях и решить, что лучше подходит именно вам, включайте и выключайте опции и сразу наблюдайте эффект на графике. Например, лучше ли он выглядит с меткой или без? Включите и выключите эту опцию и убедитесь сами.

=== Форма ячейки ===
Вы можете установить форму ячейки: '''Шестиугольник''' (классическая форма сотовой диаграммы), '''Круг''' или '''Квадрат'''.

=== Показывать метки ===
Включите это, чтобы отображать метки в ячейках.

=== Ось времени ===
Выбирает ось X.

=== Левая ось ===
Устанавливает масштаб левой оси:

* '''Логарифмическая'''
* '''Линейная'''

=== Легенда и всплывающая подсказка ===

* '''Показывать легенду''': чтобы отобразить легенду, включите '''Показывать легенду''' и выберите '''Позицию''' легенды.
* '''Позиция''': определяет, где отображать легенду.
** '''Авто''': выбирает подходящее место в зависимости от размера визуализации и доступного места.
** '''Снизу''': отображает легенду под визуализацией.
** '''Справа''': отображает легенду справа от визуализации.
* '''Усечение текста''': определяет, как усекать текст, когда полный текст не может быть отображён.
** '''A…''': усечение с правого конца текста (когда правый конец менее важен).
** '''A…B''': усечение с середины текста (когда середина менее важна).
** '''…B''': усечение с левого конца текста (когда левый конец менее важен).
* '''Вариант всплывающей подсказки'''
** '''Сгруппированная''' отображает точки из ближайших данных.
** '''Общая''' показывает все точки для этой метки времени.
* '''Режим серии всплывающей подсказки''': определяет, показывает ли всплывающая подсказка свойства точки данных в одной или нескольких строках.
** '''Одна строка'''
** '''Несколько строк'''

=== Цвета ===
Настройки цвета для визуализации отображаются в строках.

Каждая строка связывает цветовую схему с условием/значением, относящимся к выбранному полю, отображаемому в визуализации.

Чтобы настроить параметры для строки, есть два меню настроек, которые используются в комбинации для определения того, какой цвет отображается:

* Первое меню в строке отображает выбранный цвет или цветовую палитру. Откройте это меню, чтобы отобразить три вкладки цветовых опций:
** '''Палитры''': выберите цветовую палитру для использования в этой строке.
*** '''Исключения палитры для определённых типов визуализации'''
**** '''Тепловая карта и сотовая диаграмма''': палитра применяет только первый цвет (если цветовые правила не соответствуют значениям сопоставления данных или не используется '''Имя'''), и палитра не отражается в легенде.
**** '''Категориальная''': n-й цвет в палитре применяется к n-му элементу в серии.
**** '''Категориальная для нескольких подкатегорий''': палитры применяются по бину, но не отражаются в легенде.
**** '''Таблица''': палитры не применимы к таблицам.
** '''Цвета''': выберите цвет для единообразного применения, когда это правило совпадает.
** '''Пользовательский''': укажите точный шестнадцатеричный код цвета (например, <code>#134FC9</code>) или используйте палитру цветов, чтобы выбрать цвет визуально.
* Второе меню в строке отображает условие, при котором будет отображаться цвет этой строки. Выберите текущую настройку, чтобы изменить поле, оператор и значение по мере необходимости для оценки условия.
** Поля, доступные для оценки, зависят от необработанных данных.
** '''Имя''' — это специальное свойство, созданное через настройку '''Сопоставления данных''' '''Имена'''.
** '''Значение''' — это специальное свойство, созданное через настройку '''Сопоставления данных''' '''Значения''' (только для визуализации тепловой карты).
** Доступные операторы изменяются в соответствии с оцениваемым условием.

'''Цвета: дополнительные действия'''

* Чтобы добавить строку, выберите соответствующий значок и настройте её, как описано выше.
* Чтобы переместить строку вверх или вниз в таблице, выберите и перетащите соответствующий значок.
* Соответствующий значок открывает меню дополнительных опций:
** '''Переместить вверх''' и '''Переместить вниз''' перемещают строку на одну строку вверх или вниз.
** '''Дублировать''' создаёт копию выбранной строки.
** '''Удалить раздел''' удаляет строку. Вы можете удалить все цветовые правила для таблиц и визуализаций одного значения; все остальные визуализации требуют хотя бы одного цветового правила.

Помните, что цвета применяются в том порядке, в котором они указаны в разделе '''Цвета''', сверху вниз, поэтому изменение порядка может дать вам разные результаты.

'''Цвета: примеры:'''

* '''Круговая диаграмма'''
** В этом примере визуализации круговой диаграммы мы применили:
*** '''Зелёный''' к секторам со значениями ниже 15.
*** '''Жёлтый''' к секторам со значениями 15 и выше.
*** '''Красный''' к секторам со значениями 20 и выше.
** Если вы измените порядок строк в разделе '''Цвета''', вы увидите разные цвета. Например, если вы поменяете местами строки 2 и 3 выше, все сектора со значениями 20 и выше будут окрашены в красный, но затем все сектора со значениями 15 и выше, включая все красные сектора, будут окрашены в жёлтый.
* '''Сотовая диаграмма'''
** В этом примере визуализации сотовой диаграммы мы применили:
*** '''Зелёный''' ко всем значениям <code>value.A</code>.
*** '''Жёлтый''' как маркер строки (слева) для значений <code>value.A</code> 15 и выше.
*** '''Красный''' ко всей строке для значений <code>value.A</code> 20 и выше.
** В результате получилась полностью пороговая сотовая диаграмма. Вы можете использовать другие настройки визуализации сотовой диаграммы, чтобы настроить метки, всплывающую подсказку, легенду и т. д.

== Единицы измерения и форматы ==
'''Чтобы переопределить единицы измерения и форматы по умолчанию в визуализации дашборда или блокнота'''

# Выберите соответствующий значок, чтобы отредактировать плитку визуализации.
# Выберите вкладку '''Визуализация'''.
# Разверните '''Единицы и форматы'''.

Раздел '''Единицы и форматы''' перечисляет все доступные настройки единиц измерения для документа (дашборда или блокнота). Некоторые единицы измерения могут быть уже добавлены автоматически при запросе метрик из их метаданных.

Каждая строка имеет два меню:

* Левое меню отображает настройки единиц измерения.
* Правое меню отображает поле, сопоставленное с этой единицей измерения.

Чтобы отредактировать настройки единиц измерения, откройте левое меню и просмотрите/установите следующие параметры:

* '''Единица измерения''': базовая единица, в которой были записаны значения. Она '''Нет''', если не была включена в результат '''DQL''', или автоматически определена единицей, переданной из результата '''DQL'''. Это поле не приводит к какому-либо преобразованию, но изменяет суффикс, чтобы соответствовать единице измерения.
* '''Конвертировать''': вы можете включить '''Конвертировать''' для преобразования. Например, если результат '''DQL''' определил ваше числовое значение в результате как '''Байты''', '''Конвертировать''' теперь предлагает подходящий список преобразований байтов, таких как '''Килобайт''' и '''Мегабайт'''.
** Поддерживаются только линейные и статические преобразования. Например, вы не можете преобразовать градусы Цельсия (°C) в градусы Фаренгейта (°F) или преобразовать доллары США (US$) в евро (€).
* Раздел '''Формат''' определяет, как отображается единица измерения:
** '''Десятичные знаки''': отображает количество десятичных знаков по умолчанию (степень точности) для отображения. Чтобы увидеть это в действии, измените выбор '''Десятичных знаков''' и наблюдайте изменение в визуализации.
** '''Пользовательский суффикс''': отображает суффикс для отображения после единицы измерения. Чтобы увидеть это в действии, включите '''Пользовательский суффикс''', введите строку и наблюдайте изменение в визуализации. Когда вы не находите нужную единицу измерения, вы можете использовать '''Пользовательский суффикс''', чтобы отобразить желаемую единицу измерения.
** '''Сокращать большие числа''': отображает большие числа в сокращённой форме. Например, 1053 становится 1.1K.
** '''Несколько единиц измерения''': отображает более одной единицы измерения. Включите это и выберите количество единиц измерения для отображения. Например, 90 секунд становится 1m 30s, если включено несколько единиц измерения и выбрано 2 единицы.
* Чтобы выбрать другое поле для строки, откройте правое меню в этой строке и выберите поле из доступных полей.

'''Единицы измерения и форматы: дополнительные действия'''

* Чтобы добавить строку, выберите '''Добавить''' и настройте её, как описано выше.
* '''Действия''' открывает меню дополнительных опций:
** '''Дублировать''' создаёт копию выбранной строки.
** '''Удалить''' удаляет строку.
** '''Сбросить''' сбрасывает настройки в выбранной строке к значениям по умолчанию/метаданным.

'''Единицы измерения и форматы: примеры'''

'''График среднего CPU across всех хостов'''

В этом примере используется линейный график, но параметры применяются и к другим визуализациям.

# В '''Дашбордах''' создайте дашборд.
# Выберите соответствующий значок и в разделе '''Библиотека''' меню выберите '''График среднего CPU across всех хостов'''.
# На панели редактирования выберите вкладку '''Визуализация''' и выберите '''Линия'''.
# Разверните '''Единицы и форматы'''.
#* Одна строка уже определена на основе метаданных из <code>avg(dt.host.cpu.usage)</code>.
# Чтобы переопределить настройки единиц измерения для этого поля, откройте левое меню в этой строке, чтобы отобразить настройки единиц измерения.
# Определите переопределение для отображаемой метрики. Вы можете наблюдать свои изменения на оси Y графика.
#* '''Единица измерения''' отображает '''Процент''', который является единицей измерения по умолчанию для выбранной метрики.
#* Включите '''Конвертировать''', чтобы попробовать настройки преобразования. Например, измените '''Авто''' на '''Один''', чтобы отобразить результат как долю от 1.
#* '''Десятичные знаки''' отображает количество десятичных знаков по умолчанию (степень точности) для отображения. Например, введите <code>Pct</code> и просмотрите дашборд, чтобы увидеть <code>Pct</code> вместо % после процентного значения.
#* Включите '''Пользовательский суффикс''', чтобы попробовать разные суффиксы для отображения после единицы измерения. Например, измените выбор '''Десятичных знаков''' и просмотрите дашборд, чтобы увидеть изменение в количестве десятичных знаков в процентном значении.
# Чтобы сбросить к значениям по умолчанию (отменить настройки переопределения для выбранной метрики), откройте меню '''Действия''' для этой строки и выберите '''Сбросить'''.

== Ссылки ==
Используйте раздел '''Ссылки''' для управления пользовательскими ссылками из вашего дашборда или блокнота.

=== Добавление ссылки ===
'''Чтобы добавить ссылку'''

# Откройте раздел '''Ссылки''' на вкладке визуализации вашей выбранной визуализации.
# Выберите соответствующий значок, чтобы открыть '''Добавить ссылку'''.
# Настройте ссылку:
#* '''Имя''': введите описательное имя, такое как «Перейти к хосту», для отображения в меню.
#* '''Значок''': выберите значок, например «Логи», чтобы представить ссылку в меню.
#* '''URL''': используйте динамические заполнители для вставки полей данных или переменных. Например, выберите '''Вставить заполнитель''' и добавьте заполнитель <code>:name</code> к вашему '''URL''', например <code>https://myhost/host={{:name}}</code>.
#* Используйте раздел '''Предварительный просмотр''' в нижней части, чтобы увидеть, как заполнители будут заменены фактическими данными, и протестировать вашу ссылку.
# Выберите '''Добавить ссылку''', чтобы сохранить. Ссылка теперь появится в меню всплывающей подсказки визуализации.

'''Ссылки: дополнительные действия'''

* Чтобы добавить строку, выберите соответствующий значок и настройте её, как описано в разделе «Добавить ссылку».
* Чтобы переместить строку вверх или вниз в таблице, выберите и перетащите.
* Соответствующий значок открывает меню дополнительных опций:
** '''Редактировать''' отображает поля ссылки для редактирования, как описано в разделе «Добавить ссылку».
** '''Дублировать''' создаёт копию выбранной строки.
** '''Удалить''' удаляет строку.

Подробности см. в разделе «Ссылка из визуализации через пользовательские ссылки».

== Ограничения запроса ==
Используйте раздел '''Ограничения запроса''', чтобы проверить и настроить ограничения запроса к хранилищу на раздел блокнота или плитку дашборда. Эти настройки определяют максимальные ограничения при извлечении данных. Превышение любого ограничения вызовет предупреждение.

Плитки дашборда и разделы блокнота, созданные в Ключ-АСТРОМ раньше версии 1.296, не затрагиваются. Эти существующие плитки/разделы будут возвращать те же результаты, что и раньше.

* '''Ограничение чтения данных (ГБ)'''
** Ограничение в гигабайтах для объёма данных, который будет просканирован во время чтения.
* '''Ограничение записей'''
** Максимальное количество записей результата, которое вернёт этот запрос. По умолчанию: 1 000 записей. Чтобы увидеть больше записей, вам нужно увеличить значение '''Ограничения записей'''.

Если ваш запрос не имеет ограничения, такое как<pre>
fetch logs
</pre>применяется значение '''Ограничения записей'''. По умолчанию вы увидите до 1 000 записей.

Если ваш запрос также включает ограничение, такое как<pre>
fetch logs
| limit 2000
</pre>применяется меньшее из двух значений (либо ограничение в вашем запросе, либо '''Ограничение записей''' в веб-интерфейсе).

В приведённом выше примере вы всё равно увидите только 1 000 записей, если не увеличите значение '''Ограничения записей'''.

* '''Ограничение размера результата'''
** Максимальное количество байтов результата, которое вернёт этот запрос. Для лучшей производительности с типичными запросами и меньшими документами по умолчанию установлено 1 МБ.
* '''Выборка (только логи и спаны)'''
** Приводит к выбору подмножества записей логов или спанов.