IKuznetsov: Новая страница: « == Визуализация пузырьковой карты == === Когда использовать === Используйте пузырьковую карту, чтобы представить значения с помощью пузырьков разного размера и цвета. Примеры включают частоту ошибок различных сервисов, где размер пузырька представляет...»

2026-09-28T20:19:48Z

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

Новая страница

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

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

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

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

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

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

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

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

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

* Определите в дашборде переменные с именами <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>.

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

==== Вид ====

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

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

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

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

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

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

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

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

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

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

Визуализация пузырьковой карты - История изменений