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

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

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

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

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

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

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

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

• Копировать серию — копирует значение поля.
• Копировать значение — копирует значение поля.
• Копировать значение 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 МБ.
• Выборка (только для логов и спанов): приводит к выбору подмножества записей логов или спанов.