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

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

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

Когда использовать

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

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

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

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

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

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

Заголовок

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

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

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

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

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

Вид

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

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

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

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

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

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

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

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

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

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

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

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

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

  • Широта: Обязательно. Выберите значение из запроса, которое будет использоваться для широты каждой точки на карте.
  • Долгота: Обязательно. Выберите значение из запроса, которое будет использоваться для долготы каждой точки на карте.
  • Значение радиуса: Обязательно. Выберите значение из запроса, которое будет использоваться для радиуса пузырька вокруг каждой точки на карте.
  • Значение цвета: Необязательно. Выберите значение из запроса, которое будет использоваться для цвета пузырька вокруг каждой точки на карте.

Радиус

Настройки радиуса определяют размер пузырька.

  • Изменение размера при масштабировании: изменять ли размер пузырька при масштабировании. По умолчанию: выключено.
  • Масштаб: определяет, как масштабировать радиус пузырька.
    • Фиксированный: не масштабировать радиус пузырька.
    • Линейный: масштабировать радиус пузырька линейно (по умолчанию).
    • Логарифмический: масштабировать радиус пузырька логарифмически.
  • Минимальный радиус: минимальный радиус пузырька. По умолчанию: 10.
  • Максимальный радиус: максимальный радиус пузырька. По умолчанию: 100.

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

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

Цвет

Цвета пузырьков

Выберите, как окрашивать пузырьки:

  • Цветовая палитра: отображает все пузырьки оттенком из выбранной цветовой палитры. Оттенок каждого пузырька соответствует значению Значение цвета относительно других областей.
    • Пример: если значения Значение цвета, возвращённые запросом, находятся в диапазоне от 0 до 100:
      • Пузырёк со значением около 0 получает оттенок ближе к правому краю палитры.
      • Пузырёк со значением около 100 получает оттенок ближе к левому краю палитры.
  • Один цвет: отображает все пузырьки одним цветом. Выберите цвет из списка или введите шестнадцатеричный код цвета.
  • Настраиваемые цвета: отображает каждый пузырёк в заданном вами цвете.

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

  • Выберите Цвет.
  • Введите значение, оператор и цвет для этого значения и оператора.

Пример: предположим, вы хотите окрасить пузырьки по трём уровням Значение цвета:

  • Зелёный, если Значение цвета меньше 4 000.
  • Жёлтый, если Значение цвета достигает порога 4 000 или превышает его.
  • Красный, если Значение цвета достигает порога 5 000 или превышает его.

Чтобы настроить это:

  • Выберите Цвет и добавьте строку настраиваемого цвета со значением 0, оператором ≥ и нужным оттенком зелёного. Если Значение цвета равно 0 или больше, пузырёк будет зелёным.
  • Выберите Цвет и добавьте строку настраиваемого цвета со значением 4 000, оператором ≥ и нужным оттенком жёлтого. Если Значение цвета равно 4 000 или больше, пузырёк будет жёлтым.
  • Выберите Цвет и добавьте строку настраиваемого цвета со значением 5 000, оператором ≥ и нужным оттенком красного. Если Значение цвета равно 5 000 или больше, пузырёк будет красным.

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

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

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

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

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

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

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

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