Визуализация карты соединений

Визуализация карты соединений

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

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

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

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

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

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

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

Заголовок

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

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

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

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

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

Вид

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Линия

• Тип линии: выберите форму линии соединения.
  • Линейная: прямая линия между двумя точками.
  • Сглаженная: изогнутая линия между двумя точками.
• Стиль штриха: выберите шаблон линии соединения.
  • Сплошная: непрерывная линия между двумя точками.
  • Пунктирная: пунктирная линия между двумя точками.
• Индикатор направления: где показывать индикатор направления на линии соединения.
  • Начало: отображать индикатор направления в начале линии соединения.
  • Конец: отображать индикатор направления в конце линии соединения.
  • Оба: отображать индикатор направления на обоих концах линии соединения.
• Толщина: толщина линии соединения (1–64 px).

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

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

Цвет

Цвета линий

Выберите, как окрашивать линии соединения:

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

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

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

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

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

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

• Выберите Цвет и добавьте строку настраиваемого цвета со значением 0, оператором ≥ и нужным оттенком зелёного. Если Color value равно 0 или больше, линия соединения будет зелёной.
• Выберите Цвет и добавьте строку настраиваемого цвета со значением 4 000, оператором ≥ и нужным оттенком жёлтого. Если Color value равно 4 000 или больше, линия соединения будет жёлтой.
• Выберите Цвет и добавьте строку настраиваемого цвета со значением 5 000, оператором ≥ и нужным оттенком красного. Если Color value равно 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 МБ.
• Выборка (только для логов и спанов): приводит к выбору подмножества записей логов или спанов.