Визуализация тепловой карты: различия между версиями

Материал из Документация Ключ-АСТРОМ
← Предыдущая правка
ВизуальныйВики-текст
Нет описания правки
Нет описания правки
 
Строка 1: Строка 1:
'''''[[Применение Ключ-АСТРОМ]] / [[Применение Ключ-АСТРОМ#.D0.9D.D0.B0.D0.B1.D0.BB.D1.8E.D0.B4.D0.B0.D0.B9.D1.82.D0.B5%20.D0.B8%20.D0.B8.D1.81.D1.81.D0.BB.D0.B5.D0.B4.D1.83.D0.B9.D1.82.D0.B5|Наблюдайте и исследуйте]] / Панели мониторинга (Дашборды) / Визуализации и плитки / Визуализация тепловой карты'''''


Чтобы визуализировать результаты вашего запроса в виде тепловой карты, выберите [[Файл:Тепловая карта.png|граница|32x32пкс]] <code>Тепловая карта</code> из списка над определением запроса, в верхнем левом углу страницы.
== Визуализация тепловой карты ==


==== Пример в Визуализации метрик ====
=== Когда использовать визуализацию тепловой карты ===
[[Файл:111.png|граница]]
Визуализация тепловой карты предлагает компактное и гибкое матричное представление для визуализации агрегированных наборов данных.


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


* Если вы выбираете визуализацию и настраиваете параметры для этой визуализации, а затем переключаетесь на другую визуализацию, некоторые из ваших настроек для первой визуализации могут быть проигнорированы, поскольку они не применяются к новой выбранной визуализации. Информационный значок в списке визуализаций предупредит вас о такой возможности.  [[Файл:112.png|граница]]
=== Взаимодействие с графиком ===
* Если вы вернетесь к исходной визуализации, вам может потребоваться перенастроить некоторые параметры визуализации.


==Изменить выбор метрики==
==== Взаимодействие при выборе ====
По умолчанию эта визуализация показывает первую метрику многометрического запроса.


Чтобы выбрать другую метрику из многометрического запроса, вы можете выбрать букву рядом с метрикой, которую вы хотите визуализировать, или выбрать значок глаза [[Файл:40.png|граница|ссылка=https://doc.ruscomtech.ru/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:40.png]].
* Наведите курсор, чтобы отобразить подсказку с подробностями.
* Выберите, чтобы закрепить открытую подсказку; затем можно навести курсор на подсказку, чтобы отобразить меню параметров для выбранного элемента.
* Доступные параметры меню зависят от ваших данных и выбранной визуализации.


[[Файл:32.png|граница|ссылка=https://doc.ruscomtech.ru/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:32.png]]
* '''Копировать серию''' — копирует значение поля.
==Настройки==
* '''Копировать значение''' — копирует значение поля.
Раздел '''Настройки''' — один из расширяемых разделов на правой панели '''Визуализация метрик'''. Содержимое раздела '''Настройки''' может различаться в зависимости от выбранной вами визуализации.
* '''Копировать значение Y''' — копирует значение поля.


[[Файл:113.png|граница]]
Подменю поля предлагает параметры для конкретного поля, например:
===Разрешение===
Разрешение — это детализация визуализации по оси X (время).
*Чтобы разрешить '''Визуализации метрик''' автоматически выбирать подходящее разрешение для выбранного периода времени, в разделе '''Настройки''' установите для параметра '''Разрешение''' значение <code>Авто</code>
*Чтобы указать определенное разрешение, выберите его из списка.
Некоторые разрешения недоступны для некоторых таймфреймов. Если вы выбираете несовместимую комбинацию таймфрейма и разрешения, Ключ-АСТРОМ автоматически выбирает разрешение и отображает пояснительное сообщение, например: <code>Auto-resolution applied. Resolution value of [6 hours] applied. Selected timeframe doesn't allow for [5 minutes] resolution.</code>Чтобы переопределить автоматическое разрешение, выберите другое разрешение из списка.


Умное разрешение на плитках дашборда.
* '''Копировать значение''' — копирует значение поля.
* '''Объяснить значение''' — использует '''ИИ''' для объяснения поля.
* '''Добавить команду в запрос''' — раздел команд для конкретного поля, которые можно автоматически добавить в запрос.
* Для каждого поля может отображаться до трёх рекомендуемых приложений.
* '''Параметры визуализации''' — открывает панель редактирования, чтобы изменить параметры визуализации для выбранного элемента.
* '''Задать цвет''' — открывает панель редактирования, чтобы изменить цвет выбранного элемента.
* '''Добавить ссылку''' — подробнее см. раздел '''Ссылки'''.
* '''Открыть с помощью''' позволяет выбрать целевое приложение. Подробнее см. '''Открыть с помощью'''.


Чтобы предотвратить проблемы с производительностью на плитках дашборда, созданных с помощью Визуализации метрик, максимальное количество точек данных для запроса на плитке дашборда составляет 4000. На основе выбранного периода времени и примененного пользовательского разрешения Ключ-АСТРОМ проецирует количество точек данных для результата запроса. Если прогнозируемое количество точек данных превышает 4000, Ключ-АСТРОМ автоматически переключается на разрешение, достаточно высокое для того, чтобы количество точек данных не превышало 4000.
==== Заголовок ====
Используйте поле заголовка в верхней части панели параметров (изначально '''Плитка без названия''' или '''Раздел без названия'''), чтобы добавить заголовок к плитке дашборда или разделу блокнота.


Обратите внимание, что это не относится к визуализациям в самой Визуализации метрик, где у вас может быть более 4000 точек данных. Это относится только к плиткам дашборда, созданных с помощью Визуализации метрик, где комбинация разрешения/таймфрейма, выбранная на дашборде, приводит к более чем 4000 точек данных.
Можно использовать эмодзи, например 😃, 🌍 и ❤️. Можно использовать переменные. Пример:
===Показать легенду===
Отображать ли легенду под визуализацией.


Обратите внимание, что если легенда активна: вы можете выбрать запись легенды, чтобы включить или выключить отображение соответствующей записи.
* Определите в дашборде переменные с именами <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>.


=== Показать ярлыки ===
=== Визуализация ===
Показывать ли значение (количество) для каждого сегмента.
Если вы не уверены, что выбрали правильную визуализацию, воспользуйтесь селектором визуализации, чтобы попробовать другие варианты.


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


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


* Значение по умолчанию для каждой оси — <code>Авто</code>.
Разверните, чтобы увидеть общие правила настройки сопоставления данных.
* Чтобы вручную указать номер, введите его в стоку. Вы можете вернуть его, в <code>Авто</code> очистив это значение.


==Настройки по метрике==
Разверните раздел '''Сопоставление данных''' в настройках визуализации, чтобы увидеть, как данные результата сопоставляются с визуализацией, и при необходимости скорректировать эти настройки.
В разделе '''Настройки''' также отображаются параметры визуализации для каждой метрики, выбранной для запроса.
===Переименовать метрику===
Вы можете изменить имя метрики, отображаемое на диаграмме и в легенде диаграммы. Определение запроса сохраняет исходное имя метрики.
#В разделе '''Настройки''' выберите метрику/столбец, которую вы хотите переименовать.
#Отредактируйте имя, а затем установите флажок, чтобы сохранить новое имя.
===Единица измерения и формат===
Используйте настройки '''Единица''' и '''Формат''' , чтобы определить, как будут отображаться ваши данные. Если вы экспортируете в CSV-файл, настройки '''Единица''' и '''Формат''' также будут отражены в экспортируемых значениях.
====Единица====
Используйте настройку '''Единица''' , чтобы задать единицу измерения, в которой будет отображаться метрика.
*<code>Нет</code>= Единица измерения не отображается
*<code>Авто</code>= Ключ-АСТРОМ выбирает подходящий блок отображения
*Другие варианты выбора указывают точную единицу для отображения. Параметры здесь зависят от единицы метрики. Например, метрика времени предлагает альтернативные единицы для отображения времени.
*Чтобы добавить пользовательскую строку единицы измерения/суффикса, введите пользовательскую строку в поле '''Единица''', а затем выберите ее из списка.
*В расширенном режиме вы можете использовать <code>:setUnit(<unit>)</code>для выбора более широкого диапазона единиц измерения.
Примеры обозначения порядка величины в Ключ-АСТРОМ:
{| class="wikitable"
!Обозначение
!Фактор
!Значение
|-
|k
|10^3
|кило, тысяча
|-
|M
|10^6
|мега, миллион
|-
|G
|10^9
|гига, миллиард
|-
|T
|10^12
|тера, триллион
|}
====Формат====
Используйте настройку '''Формат''', чтобы настроить количество отображаемых десятичных знаков для выбранной метрики.
*<code>Нет</code>= Без формата.
*<code>Авто</code>= Ключ-АСТРОМ выбирает подходящий формат. Например, где <code>Нет</code> будет отображать <code>5.062357754177517 %</code>, <code>Авто</code> будет отображать <code>5.06 %</code>.
*Другие варианты выбора указывают количество отображаемых десятичных знаков: <code>0</code>, <code>0.0</code>, <code>0.00</code>, <code>0.000</code>
====Примеры====
'''Пример: байты'''


Когда основной единицей метрики являются байты :
Обязательные поля отмечены звёздочкой (*). Пример:
*Если задать для параметра '''Единица''' <code>Авто</code>  , Ключ-АСТРОМ автоматически выразит результаты в понятных человеку единицах измерения, которыми в данном случае могут быть <code>GiB</code>.  Байтовая единица может иметь как двоичную, так и десятичную основу, что определит, выберет ли Ключ-АСТРОМ, например, <code>GiB</code>или <code>GB</code>. Если в самой метрике основа не определена, используется десятичная основа.
*Если автоматически выбранная единица измерения не подходит в вашем случае, вы можете заставить Ключ-АСТРОМ выразить те же значения в определенных единицах ( '''Единица''' = <code>B</code>, <code>KiB</code>, <code>MiB</code>, или <code>GiB</code>).
*Если вы хотите увидеть необработанные данные (без преобразования), вы можете установить единицу измерения на <code>Нет</code>и увидеть результаты в базовой единице измерения метрики (в данном случае это байты).
'''Пример: доллары и центы'''


Когда основная единица измерения — доллары и центы :
'''Пример сопоставления данных: линейный график'''
*Для меньших значений, чтобы увидеть результаты, выраженные в точных долларах и центах: установите '''Единицу''' на <code>Авто</code>, а '''Формат''' — на <code>0.00</code> (чтобы для центов было два десятичных знака).
*Для больших значений, чтобы увидеть результаты, выраженные в тысячах, миллионах или миллиардах долларов без центов: установите '''Единицу''' на <code>k (тысячи)</code>, <code>M (миллион)</code>, <code>G (миллиард)</code>, и установите '''Формат''' на <code>0</code> (чтобы не видеть ничего после десятичной точки).
'''Пример: точные подсчеты'''


Когда основной единицей измерения метрики является количество :
Типы данных отображаются рядом с именами полей в раскрывающихся списках и сопоставленных полях.
*Чтобы увидеть точное количество:
**Установить '''Единицу''' <code>Авто</code>
**Установить '''Формат''' ​<code>Нет</code>
*Чтобы увидеть приблизительный подсчет:
**Установите '''Единицу''' на <code>k (тысячи)</code>, <code>M (миллион)</code>, <code>G (миллиард)</code>, или <code>T (триллион)</code>, в зависимости от величины ваших значений.
**Установите '''Формат''' на <code>0.0</code>, <code>0.00</code>, или <code>0.0000</code>, в зависимости от того, сколько десятичных знаков имеет смысл в сочетании с выбранной настройкой '''Единицей'''.
'''Пример: пороги'''


При установке пороговых значений:
Единицы измерения отображаются, если назначена только одна.
*Если вы выберете '''Единицу''' (например, <code>MiB</code>), то настройки порога будут подготовлены в соответствии с выбранной единицей измерения, поэтому вам просто нужно ввести пороговые значения, не указывая <code>MiB</code>.
*Если вы установите '''Единицу''' <code>Авто</code> (чтобы Ключ-АСТРОМ автоматически масштабировал отображаемые выходные данные), вам все равно необходимо задать пороговые значения в определенных единицах измерения, например в байтах.
===Добавить переопределение цвета===
Чтобы принудительно установить другой цвет (переопределить цветовую палитру) для определенной серии, например, выбранного хоста
#В разделе '''Настройки''' выберите '''Переопределить цвет'''.
#Выберите серию из списка
#Выберите переопределяющий цвет для этой серии
==Порог==
Раздел '''Порог''' — один из расширяемых разделов на правой панели '''Визуализации метрик'''. Содержимое этого раздела может различаться в зависимости от выбранной визуализации. Используйте настройки порога для улучшения визуализаций и плиток.


[[Файл:44.png|граница|ссылка=https://doc.ruscomtech.ru/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:44.png]]
Поля результата группируются в '''Подходящие''' и '''Неподходящие'''. Поля помечаются как неподходящие, если их нельзя использовать для отображения данных в визуализации. Пример:


Установите пороговые значения после установки единицы измерения :
'''Пример сопоставления данных: линейный график, раскрывающийся список Time'''
*Если сначала задать единицу измерения , пороговые настройки будут подготовлены в соответствии с выбранной единицей измерения.
*Если вы измените единицу измерения после установки пороговых значений, пороговые значения не будут автоматически скорректированы в соответствии с новой настройкой единицы измерения.
===Установка пороговых значений===
#В разделе '''Порог''' введите пороговые значения. <br />[[Файл:45.png|граница|ссылка=https://doc.ruscomtech.ru/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:45.png]]
#'''''необязательно''''' Настройте пороговые цвета  <br />[[Файл:46.png|граница|ссылка=https://doc.ruscomtech.ru/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:46.png]]
===Скрыть или показать пороговые цвета===
Чтобы скрыть или отобразить цвета пороговых значений, не удаляя настройки пороговых значений, в разделе '''Порог''' выберите [[Файл:40.png|граница|ссылка=https://doc.ruscomtech.ru/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:40.png]].


[[Файл:47.png|граница|ссылка=https://doc.ruscomtech.ru/index.php/%D0%A4%D0%B0%D0%B9%D0%BB:47.png]]
Автоматическое применение настроек сопоставления данных по умолчанию:
 
* Ключ-АСТРОМ версии 1.319+
* Уже существующие плитки и разделы считаются пользовательскими. Их конфигурации сопоставления данных не обновляются автоматически.
* Новые плитки и разделы по умолчанию применяют настройку сопоставления данных. Если вы не изменяете эти настройки вручную, они могут измениться, если новый запуск плитки/раздела изменит результаты и появятся отсутствующие поля или новые поля, которые лучше подходят для сопоставления данных.
 
'''Настройки сопоставления данных для конкретной визуализации'''
 
Раздел сопоставления данных для тепловой карты включает:
 
* '''Ось X''': выберите значение для использования по оси X тепловой карты.
** '''Числовой''': требует вложенных начального и конечного значений, что лучше всего достигается функцией <code>range</code> в DQL вместе с командой <code>summarize</code>.
** '''Время''': требует вложенных начальной и конечной временных меток, а также поля интервала. Это проще всего достигается с помощью команд <code>timeseries</code> или <code>makeTimeseries</code> в DQL.
** '''Строка''': требует как минимум одного строкового значения, которое можно сопоставить как категорию. Это достигается с помощью команды <code>summarize</code> в DQL вместе с определённым полем для группировки или с помощью команды <code>by</code> для указания полей, по которым следует разделять серии.
** '''Интервал''': отображается под '''Ось X''', если вы выбрали временной диапазон для оси X; это значение сопоставляется автоматически и не может быть изменено. Оно показывает, какие поля сопоставлены для результатов на основе временных рядов. Оно берёт первое доступное поле интервала из набора результатов всякий раз, когда используется временной ряд (также включает любые данные на основе <code>makeTimeseries</code>).
* '''Ось Y''': выберите значение для использования по оси Y тепловой карты.
** '''Числовой''': требует вложенных начального и конечного значений, что лучше всего достигается функцией <code>range</code> в DQL вместе с командой <code>summarize</code>.
** '''Время''': требует вложенных начальной и конечной временных меток, а также поля интервала. Это проще всего достигается с помощью команд <code>timeseries</code> или <code>makeTimeseries</code> в DQL.
** '''Строка''': требует как минимум одного строкового значения, которое можно сопоставить как категорию. Это достигается с помощью команды <code>summarize</code> в DQL вместе с определённым полем для группировки или с помощью команды <code>by</code> для указания полей, по которым следует разделять серии.
** '''Интервал''': отображается под '''Ось Y''', если вы выбрали временной диапазон для оси Y; это значение сопоставляется автоматически и не может быть изменено. Оно показывает, какие поля сопоставлены для результатов на основе временных рядов. Оно берёт первое доступное поле интервала из набора результатов всякий раз, когда используется временной ряд (также включает любые данные на основе <code>makeTimeseries</code>).
* '''Поле значения''': выберите значение (числовое или строковое поле) для отображения на тепловой карте.
 
==== Ось времени ====
Выбирает ось X.
 
==== Левая ось ====
Задаёт масштаб левой оси:
 
* '''Логарифмический'''
* '''Линейный'''
 
==== Легенда и подсказка ====
 
* '''Показывать легенду''': чтобы отображать легенду, включите '''Показывать легенду''' и выберите '''Положение''' легенды:
** '''Авто''': выбирает подходящее расположение с учётом размера визуализации и доступного пространства.
** '''Снизу''': отображает легенду под визуализацией.
** '''Справа''': отображает легенду справа от визуализации.
* '''Усечение текста''': определяет, как усекать текст, когда полный текст не помещается.
** '''A…''': обрезать справа (когда правый край менее важен).
** '''A…B''': обрезать середину (когда середина менее важна).
** '''…B''': обрезать слева (когда левый край менее важен).
* '''Вариант подсказки''':
** '''Сгруппированная''' отображает точки из ближайших данных.
** '''Общая''' показывает все точки для этой временной метки.
* '''Режим серий подсказки''': определяет, отображает ли подсказка свойства точки данных в одной или нескольких строках.
** '''Однострочный'''
** '''Многострочный'''
 
==== Цвета ====
Настройки цвета для визуализации отображаются в строках.
 
Каждая строка связывает цветовую схему с условием/значением, относящимся к выбранному полю, отображаемому в визуализации.
 
Чтобы настроить параметры строки, есть два меню настроек, которые используются в сочетании для определения отображаемого цвета:
 
* Первое меню в строке отображает выбранный цвет или цветовую палитру. Откройте это меню, чтобы отобразить три вкладки параметров цвета:
** '''Палитры''': выберите цветовую палитру для использования в этой строке.
*** Исключения палитры для определённых типов визуализации: тепловая карта и сотовая диаграмма — палитра применяет только первый цвет (если правила цвета не соответствуют значениям сопоставления данных или не используется Name), и палитра не отражается в легенде; категориальная — n-й цвет в палитре применяется к n-му элементу в серии; категориальная для нескольких подкатегорий — палитры применяются по интервалам, но не отражаются в легенде; таблица — палитры не применимы к таблицам.
** '''Цвета''': выберите цвет для единообразного применения, когда это правило совпадает.
** '''Настраиваемый''': укажите точный шестнадцатеричный код цвета (например, <code>#134FC9</code>) или используйте палитру цветов, чтобы выбрать цвет визуально.
* Второе меню в строке отображает условие, при котором будет отображаться цвет этой строки. Выберите текущую настройку, чтобы изменить поле, оператор и значение по мере необходимости для оценки условия.
* Поля, доступные для оценки, зависят от исходных данных.
* Name — это специальное свойство, формируемое через настройку '''Сопоставление данных''' → Names.
* Value — это специальное свойство, формируемое через настройку '''Сопоставление данных''' → Values (только для визуализации тепловой карты).
* Доступные операторы меняются в соответствии с оцениваемым условием.
 
'''Цвета: дополнительные действия'''
 
* Чтобы добавить строку, выберите '''Добавить''' и настройте её, как описано выше.
* Чтобы переместить строку вверх или вниз в таблице, выберите и перетащите.
* '''Действия''' открывает меню дополнительных параметров:
** Переместить вверх и Переместить вниз перемещают строку на одну позицию вверх или вниз. Это альтернативы перетаскиванию.
** Помните, что цвета применяются в порядке их перечисления в разделе '''Цвета''' сверху вниз, поэтому изменение порядка может дать другие результаты.
** Дублировать создаёт копию выбранной строки.
** Удалить раздел удаляет строку. Можно удалить все правила цвета для таблиц и визуализаций одного значения; всем остальным визуализациям нужно хотя бы одно правило цвета.
 
'''Цвета: примеры:'''
 
==== Круговая диаграмма ====
В этом примере визуализации круговой диаграммы мы применили:
 
* Зелёный к срезам со значениями ниже 15.
* Жёлтый к срезам со значениями 15 или выше.
* Красный к срезам со значениями 20 или выше.
 
Если изменить порядок строк в разделе '''Цвета''', вы увидите другие цвета. Например, если поменять местами строки 2 и 3 выше, все срезы со значениями 20 или выше будут окрашены в красный, но затем все срезы со значениями 15 или выше, включая все красные срезы, будут окрашены в жёлтый.
 
'''Пример визуализации круговой диаграммы с применённой раскраской'''
 
==== Сотовая диаграмма ====
В этом примере визуализации сотовой диаграммы мы применили:
 
* Зелёный ко всем значениям <code>value.A</code>.
* Жёлтый как маркер строки (слева) для значений <code>value.A</code> 15 или выше.
* Красный ко всей строке для значений <code>value.A</code> 20 или выше.
* Результат — полностью пороговая сотовая диаграмма. Можно использовать другие настройки визуализации сотовой диаграммы для настройки меток, подсказки, легенды и т. д.
 
'''Пример визуализации сотовой диаграммы с применённой раскраской'''
 
==== Единицы измерения и форматы ====
Чтобы переопределить единицы измерения и форматы по умолчанию в визуализации дашборда или блокнота:
 
* Выберите '''Редактировать''', чтобы редактировать плитку визуализации.
* Перейдите на вкладку '''Визуальный'''.
* Разверните '''Единицы измерения и форматы'''.
 
Раздел '''Единицы измерения и форматы''' перечисляет все доступные настройки единиц измерения для документа (дашборда или блокнота). Некоторые единицы могут уже добавляться автоматически при запросе метрик из их метаданных.
 
Каждая строка содержит два меню:
 
* Левое меню отображает настройки единиц измерения.
* Правое меню отображает поле, сопоставленное с этой единицей измерения.
 
'''Примеры строк в настройках «Единицы измерения и форматы»'''
 
Чтобы изменить настройки единиц измерения, откройте левое меню и проверьте/задайте следующие параметры:
 
* '''Единица измерения''': базовая единица, в которой были получены значения. Имеет значение '''Нет''', если она не была включена в результат '''DQL''', или определяется автоматически по единице, переданной из результата '''DQL'''. Это поле не выполняет преобразование, а изменяет суффикс в соответствии с единицей измерения.
* '''Преобразовать''': можно включить '''Преобразовать''' для преобразования. Например, если в результате '''DQL''' ваше числовое значение определено как <code>Bytes</code>, '''Преобразовать''' предложит подходящий список преобразований байтов, таких как <code>Kilobyte</code> и <code>Megabyte</code>.
* Поддерживаются только линейные и статические преобразования. Например, нельзя преобразовать <code>Degree Celsius (°C)</code> в <code>Degree Fahrenheit (°F)</code> или <code>Usd (US$)</code> в <code>Eur (€)</code>.
* Раздел '''Формат''' определяет, как отображается единица измерения:
** '''Десятичные знаки''': отображает количество десятичных знаков (степень точности) по умолчанию. Чтобы увидеть это в действии, измените выбор '''Десятичные знаки''' и понаблюдайте за изменением в визуализации.
** '''Пользовательский суффикс''': отображает суффикс после единицы измерения. Чтобы увидеть это в действии, включите '''Пользовательский суффикс''', введите строку и понаблюдайте за изменением в визуализации. Если нужной единицы нет в списке, можно использовать '''Пользовательский суффикс''' для отображения нужной единицы.
** '''Сокращать большие числа''': отображает большие числа в сокращённой форме. Например, 1053 становится 1.1K.
** '''Несколько единиц''': отображает более одной единицы измерения. Включите это и выберите количество отображаемых единиц. Например, 90 секунд становятся 1m 30s, если включено несколько единиц и выбрано 2 единицы.
* Чтобы выбрать другое поле для строки, откройте правое меню в этой строке и выберите поле из доступных.
 
'''Единицы измерения и форматы: дополнительные действия'''
 
* Чтобы добавить строку, выберите '''Добавить''' и настройте её, как описано выше.
* '''Действия''' открывает меню дополнительных параметров:
** '''Дублировать''' создаёт копию выбранной строки.
** '''Удалить''' удаляет строку.
** '''Сбросить''' сбрасывает настройки в выбранной строке до значений по умолчанию/метаданных.
 
'''Единицы измерения и форматы: примеры'''
 
==== График среднего CPU по всем хостам ====
В этом примере используется линейный график, но параметры применимы и к другим визуализациям.
 
* В разделе '''Дашборды''' создайте дашборд.
* Выберите '''Добавить''' и в разделе '''Библиотека''' меню выберите <code>Chart average CPU across all hosts</code>.
* На панели редактирования перейдите на вкладку '''Визуальный''' и выберите '''Линейный'''.
* Разверните '''Единицы измерения и форматы'''.
* Одна строка уже определена на основе метаданных из <code>avg(dt.host.cpu.usage)</code>.
* Чтобы переопределить настройки единиц измерения для этого поля, откройте левое меню в этой строке, чтобы отобразить настройки единиц измерения.
* Задайте переопределение для отображаемой метрики. Изменения можно наблюдать на оси Y графика.
* '''Единица измерения''' отображает <code>Percent</code> — единицу по умолчанию для выбранной метрики.
* Включите '''Преобразовать''', чтобы попробовать настройки преобразований. Например, измените <code>Auto</code> на <code>One</code>, чтобы отобразить результат как долю от 1.
* '''Десятичные знаки''' отображает количество десятичных знаков (степень точности) по умолчанию. Например, введите <code>Pct</code> и проверьте дашборд, чтобы увидеть <code>Pct</code> вместо <code>%</code> после значения в процентах.
* Включите '''Пользовательский суффикс''', чтобы попробовать разные суффиксы после единицы измерения. Например, измените выбор '''Десятичные знаки''' и проверьте дашборд, чтобы увидеть изменение количества десятичных знаков в значении в процентах.
* Чтобы сбросить к значениям по умолчанию (отменить переопределённые настройки для выбранной метрики), откройте меню '''Действия''' для этой строки и выберите '''Сбросить'''.
 
==== Ссылки ====
Используйте раздел '''Ссылки''' для управления настраиваемыми ссылками из дашборда или блокнота.
 
'''Добавить ссылку'''
 
Чтобы добавить ссылку:
 
* Откройте раздел '''Ссылки''' на вкладке визуализации выбранной визуализации.
* Выберите '''Добавить ссылку'''.
* Настройте ссылку:
** '''Имя''': введите описательное имя, например «Go to Host», для отображения в меню.
** '''Значок''': выберите значок, например «Logs», для представления ссылки в меню.
** '''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 МБ.
* '''Выборка (только для логов и спанов)''': приводит к выбору подмножества записей логов или спанов.

Текущая версия от 20:21, 28 сентября 2026

Визуализация тепловой карты

Когда использовать визуализацию тепловой карты

Визуализация тепловой карты предлагает компактное и гибкое матричное представление для визуализации агрегированных наборов данных.

  • Когда нужно выявить закономерности и выбросы среди метрик в больших агрегированных наборах данных.
  • Когда нужно соотнести и сравнить временные, числовые и категориальные метрики друг с другом.

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

Взаимодействие при выборе

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

Подменю поля предлагает параметры для конкретного поля, например:

  • Копировать значение — копирует значение поля.
  • Объяснить значение — использует ИИ для объяснения поля.
  • Добавить команду в запрос — раздел команд для конкретного поля, которые можно автоматически добавить в запрос.
  • Для каждого поля может отображаться до трёх рекомендуемых приложений.
  • Параметры визуализации — открывает панель редактирования, чтобы изменить параметры визуализации для выбранного элемента.
  • Задать цвет — открывает панель редактирования, чтобы изменить цвет выбранного элемента.
  • Добавить ссылку — подробнее см. раздел Ссылки.
  • Открыть с помощью позволяет выбрать целевое приложение. Подробнее см. Открыть с помощью.

Заголовок

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

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

  • Определите в дашборде переменные с именами Status и Emoji.
  • Установите заголовок Current $Emoji status is $Status.
  • Установите для Status значение Good.
  • Установите для Emoji значение 🌍.
  • Заголовок отобразится как Current 🌍 status is Good.

Визуализация

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

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

Сопоставление данных

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

Разверните, чтобы увидеть общие правила настройки сопоставления данных.

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

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

Пример сопоставления данных: линейный график

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

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

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

Пример сопоставления данных: линейный график, раскрывающийся список Time

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

  • Ключ-АСТРОМ версии 1.319+
  • Уже существующие плитки и разделы считаются пользовательскими. Их конфигурации сопоставления данных не обновляются автоматически.
  • Новые плитки и разделы по умолчанию применяют настройку сопоставления данных. Если вы не изменяете эти настройки вручную, они могут измениться, если новый запуск плитки/раздела изменит результаты и появятся отсутствующие поля или новые поля, которые лучше подходят для сопоставления данных.

Настройки сопоставления данных для конкретной визуализации

Раздел сопоставления данных для тепловой карты включает:

  • Ось X: выберите значение для использования по оси X тепловой карты.
    • Числовой: требует вложенных начального и конечного значений, что лучше всего достигается функцией range в DQL вместе с командой summarize.
    • Время: требует вложенных начальной и конечной временных меток, а также поля интервала. Это проще всего достигается с помощью команд timeseries или makeTimeseries в DQL.
    • Строка: требует как минимум одного строкового значения, которое можно сопоставить как категорию. Это достигается с помощью команды summarize в DQL вместе с определённым полем для группировки или с помощью команды by для указания полей, по которым следует разделять серии.
    • Интервал: отображается под Ось X, если вы выбрали временной диапазон для оси X; это значение сопоставляется автоматически и не может быть изменено. Оно показывает, какие поля сопоставлены для результатов на основе временных рядов. Оно берёт первое доступное поле интервала из набора результатов всякий раз, когда используется временной ряд (также включает любые данные на основе makeTimeseries).
  • Ось Y: выберите значение для использования по оси Y тепловой карты.
    • Числовой: требует вложенных начального и конечного значений, что лучше всего достигается функцией range в DQL вместе с командой summarize.
    • Время: требует вложенных начальной и конечной временных меток, а также поля интервала. Это проще всего достигается с помощью команд timeseries или makeTimeseries в DQL.
    • Строка: требует как минимум одного строкового значения, которое можно сопоставить как категорию. Это достигается с помощью команды summarize в DQL вместе с определённым полем для группировки или с помощью команды by для указания полей, по которым следует разделять серии.
    • Интервал: отображается под Ось Y, если вы выбрали временной диапазон для оси Y; это значение сопоставляется автоматически и не может быть изменено. Оно показывает, какие поля сопоставлены для результатов на основе временных рядов. Оно берёт первое доступное поле интервала из набора результатов всякий раз, когда используется временной ряд (также включает любые данные на основе makeTimeseries).
  • Поле значения: выберите значение (числовое или строковое поле) для отображения на тепловой карте.

Ось времени

Выбирает ось X.

Левая ось

Задаёт масштаб левой оси:

  • Логарифмический
  • Линейный

Легенда и подсказка

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

Цвета

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

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

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

  • Первое меню в строке отображает выбранный цвет или цветовую палитру. Откройте это меню, чтобы отобразить три вкладки параметров цвета:
    • Палитры: выберите цветовую палитру для использования в этой строке.
      • Исключения палитры для определённых типов визуализации: тепловая карта и сотовая диаграмма — палитра применяет только первый цвет (если правила цвета не соответствуют значениям сопоставления данных или не используется Name), и палитра не отражается в легенде; категориальная — n-й цвет в палитре применяется к n-му элементу в серии; категориальная для нескольких подкатегорий — палитры применяются по интервалам, но не отражаются в легенде; таблица — палитры не применимы к таблицам.
    • Цвета: выберите цвет для единообразного применения, когда это правило совпадает.
    • Настраиваемый: укажите точный шестнадцатеричный код цвета (например, #134FC9) или используйте палитру цветов, чтобы выбрать цвет визуально.
  • Второе меню в строке отображает условие, при котором будет отображаться цвет этой строки. Выберите текущую настройку, чтобы изменить поле, оператор и значение по мере необходимости для оценки условия.
  • Поля, доступные для оценки, зависят от исходных данных.
  • Name — это специальное свойство, формируемое через настройку Сопоставление данных → Names.
  • Value — это специальное свойство, формируемое через настройку Сопоставление данных → Values (только для визуализации тепловой карты).
  • Доступные операторы меняются в соответствии с оцениваемым условием.

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

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

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

Круговая диаграмма

В этом примере визуализации круговой диаграммы мы применили:

  • Зелёный к срезам со значениями ниже 15.
  • Жёлтый к срезам со значениями 15 или выше.
  • Красный к срезам со значениями 20 или выше.

Если изменить порядок строк в разделе Цвета, вы увидите другие цвета. Например, если поменять местами строки 2 и 3 выше, все срезы со значениями 20 или выше будут окрашены в красный, но затем все срезы со значениями 15 или выше, включая все красные срезы, будут окрашены в жёлтый.

Пример визуализации круговой диаграммы с применённой раскраской

Сотовая диаграмма

В этом примере визуализации сотовой диаграммы мы применили:

  • Зелёный ко всем значениям value.A.
  • Жёлтый как маркер строки (слева) для значений value.A 15 или выше.
  • Красный ко всей строке для значений value.A 20 или выше.
  • Результат — полностью пороговая сотовая диаграмма. Можно использовать другие настройки визуализации сотовой диаграммы для настройки меток, подсказки, легенды и т. д.

Пример визуализации сотовой диаграммы с применённой раскраской

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

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

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

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

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

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

Примеры строк в настройках «Единицы измерения и форматы»

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

  • Единица измерения: базовая единица, в которой были получены значения. Имеет значение Нет, если она не была включена в результат DQL, или определяется автоматически по единице, переданной из результата DQL. Это поле не выполняет преобразование, а изменяет суффикс в соответствии с единицей измерения.
  • Преобразовать: можно включить Преобразовать для преобразования. Например, если в результате DQL ваше числовое значение определено как Bytes, Преобразовать предложит подходящий список преобразований байтов, таких как Kilobyte и Megabyte.
  • Поддерживаются только линейные и статические преобразования. Например, нельзя преобразовать Degree Celsius (°C) в Degree Fahrenheit (°F) или Usd (US$) в Eur (€).
  • Раздел Формат определяет, как отображается единица измерения:
    • Десятичные знаки: отображает количество десятичных знаков (степень точности) по умолчанию. Чтобы увидеть это в действии, измените выбор Десятичные знаки и понаблюдайте за изменением в визуализации.
    • Пользовательский суффикс: отображает суффикс после единицы измерения. Чтобы увидеть это в действии, включите Пользовательский суффикс, введите строку и понаблюдайте за изменением в визуализации. Если нужной единицы нет в списке, можно использовать Пользовательский суффикс для отображения нужной единицы.
    • Сокращать большие числа: отображает большие числа в сокращённой форме. Например, 1053 становится 1.1K.
    • Несколько единиц: отображает более одной единицы измерения. Включите это и выберите количество отображаемых единиц. Например, 90 секунд становятся 1m 30s, если включено несколько единиц и выбрано 2 единицы.
  • Чтобы выбрать другое поле для строки, откройте правое меню в этой строке и выберите поле из доступных.

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

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

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

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

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

  • В разделе Дашборды создайте дашборд.
  • Выберите Добавить и в разделе Библиотека меню выберите Chart average CPU across all hosts.
  • На панели редактирования перейдите на вкладку Визуальный и выберите Линейный.
  • Разверните Единицы измерения и форматы.
  • Одна строка уже определена на основе метаданных из avg(dt.host.cpu.usage).
  • Чтобы переопределить настройки единиц измерения для этого поля, откройте левое меню в этой строке, чтобы отобразить настройки единиц измерения.
  • Задайте переопределение для отображаемой метрики. Изменения можно наблюдать на оси Y графика.
  • Единица измерения отображает Percent — единицу по умолчанию для выбранной метрики.
  • Включите Преобразовать, чтобы попробовать настройки преобразований. Например, измените Auto на One, чтобы отобразить результат как долю от 1.
  • Десятичные знаки отображает количество десятичных знаков (степень точности) по умолчанию. Например, введите Pct и проверьте дашборд, чтобы увидеть Pct вместо % после значения в процентах.
  • Включите Пользовательский суффикс, чтобы попробовать разные суффиксы после единицы измерения. Например, измените выбор Десятичные знаки и проверьте дашборд, чтобы увидеть изменение количества десятичных знаков в значении в процентах.
  • Чтобы сбросить к значениям по умолчанию (отменить переопределённые настройки для выбранной метрики), откройте меню Действия для этой строки и выберите Сбросить.

Ссылки

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

Добавить ссылку

Чтобы добавить ссылку:

  • Откройте раздел Ссылки на вкладке визуализации выбранной визуализации.
  • Выберите Добавить ссылку.
  • Настройте ссылку:
    • Имя: введите описательное имя, например «Go to Host», для отображения в меню.
    • Значок: выберите значок, например «Logs», для представления ссылки в меню.
    • URL: используйте динамические плейсхолдеры для вставки полей данных или переменных. Например, выберите Вставить плейсхолдер и добавьте плейсхолдер :name в URL, например https://myhost/host=Name.
  • Используйте раздел Предварительный просмотр внизу, чтобы увидеть, как плейсхолдеры заменяются фактическими данными, и проверить ссылку.
  • Выберите Добавить ссылку, чтобы сохранить. Теперь ссылка появится в меню подсказки визуализации.

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

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

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

Лимиты запросов

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

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

  • Лимит читаемых данных (ГБ): лимит в гигабайтах для объёма данных, который будет просканирован при чтении.
  • Лимит записей: максимальное количество записей результата, которое вернёт этот запрос. По умолчанию: 1 000 записей. Чтобы увидеть больше записей, увеличьте значение Лимит записей.
  • Если в запросе нет лимита, например:
fetch logs
  • Применяется значение Лимит записей. По умолчанию вы увидите до 1 000 записей.
  • Если запрос также содержит лимит, например:
fetch logs
| limit 2000
  • Применяется меньшее из двух значений (либо лимит в запросе, либо Лимит записей в веб-интерфейсе).
  • В приведённом выше примере вы всё равно увидите только 1 000 записей, если не увеличите значение Лимит записей.
  • Лимит размера результата: максимальное количество байт результата, которое вернёт этот запрос. Для лучшей производительности с типичными запросами и небольшими документами по умолчанию установлено значение 1 МБ.
  • Выборка (только для логов и спанов): приводит к выбору подмножества записей логов или спанов.
Источник — https://doc.ruscomtech.ru/index.php?title=Визуализация_тепловой_карты&oldid=6941