Визуализация диаграммы древа

Материал из Документация Ключ-АСТРОМ

Диаграмма дерева

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

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

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

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

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

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

  • Копировать нод — копирует нод.
  • Копировать значение — копирует значение нода.

Заголовок

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Категория: поле для использования в качестве категории (верхний уровень иерархии).
  • Подкатегория: поле для использования в качестве подкатегории (нижний уровень иерархии).
  • Значение: числовое значение, определяющее относительные размеры категорий и подкатегорий на диаграмме дерева.
  • Цвет: как окрашивать диаграмму дерева — по Категории, Подкатегории или Значению.

Категории

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

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

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

Цвета

Выберите цветовую палитру для применения к диаграмме дерева.

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

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

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

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

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

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

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

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

  • Единица измерения: базовая единица, в которой были получены значения. Имеет значение Нет, если она не была включена в результат 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 вместо % после значения в процентах.
  • Включите Пользовательский суффикс, чтобы попробовать разные суффиксы после единицы измерения. Например, измените выбор Десятичные знаки и проверьте дашборд, чтобы увидеть изменение количества десятичных знаков в значении в процентах.
  • Чтобы сбросить к значениям по умолчанию (отменить переопределённые настройки для выбранной метрики), откройте меню Действия для этой строки и выберите Сбросить.

Ссылки

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

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

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

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

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

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