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


= Визуализация точечной карты =
'''Руководство'''

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

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

=== Взаимодействие с выделением ===

* Наведите курсор, чтобы отобразить всплывающую подсказку с подробностями.
* Выберите, чтобы закрепить отображаемую всплывающую подсказку открытой; затем вы можете навести курсор на всплывающую подсказку, чтобы отобразить меню опций, специфичных для выделения.
* Доступные опции меню зависят от ваших данных и выбранной визуализации.
** Подменю поля предлагает опции, специфичные для поля, такие как:
*** '''Копировать значение''' — копирует значение поля.
*** '''Объяснить значение''' — использует ИИ для объяснения поля.
** '''Добавить команду в запрос''' — раздел команд, специфичных для поля, которые вы можете автоматически добавить в свой запрос.
** До трёх рекомендуемых приложений может быть указано на поле.

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

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

'''Пример:'''

# Определите переменные с именами <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+'''

* Уже существующие плитки и разделы считаются определёнными пользователем. Их конфигурации сопоставления данных не обновляются автоматически.
* Вновь созданные плитки и разделы применяют настройку сопоставления данных по умолчанию. Если вы не измените эти настройки вручную, они могут измениться, если новое выполнение плитки/раздела изменит результаты и появятся отсутствующие поля или новые поля, которые лучше подходят для сопоставления данных.

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

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

== Форма ==

* '''Стиль''': выберите символ для отображения в каждой сопоставленной точке.
** '''Форма''': выберите стандартную форму из списка.
** '''Значок''': выберите значок из списка.
** '''Эмодзи''': добавьте эмодзи с помощью комбинации клавиш '''WIN+.''' или '''Win+;''', либо введите символ.
* '''Размер''': установите размер отображения (в пикселях) для каждого отображаемого символа.
* '''Азимут''': установите угол, под которым визуализируются точки данных на карте.
** '''Фиксированный''': фиксированный угол (0–360), на который нужно повернуть символ. Например, 0 не повернёт символ, а 180 перевернёт символ вверх дном.
** '''Данные''': значение (0–360), сопоставленное из вашего набора данных. Выберите из списка.

== Легенда и всплывающая подсказка ==

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

== Цвет ==

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

* '''Цветовая палитра''': отображает все пузырьки в оттенке цвета из выбранной цветовой палитры. Оттенок, используемый для каждого пузырька, соответствует значению '''Значения цвета''' по отношению к другим областям.
** '''Пример'''
*** Если значения '''Значения цвета''', возвращённые вашим запросом, находятся в диапазоне от 0 до 100:
**** Пузырёк со значением, близким к 0, имеет оттенок цвета ближе к правому концу палитры.
**** Пузырёк со значением, близким к 100, имеет оттенок цвета ближе к левому концу палитры.
* '''Одноцветный''': отображает все пузырьки одним и тем же цветом. Выберите цвет из списка или введите шестнадцатеричный код цвета.
* '''Пользовательские цвета''': отображает каждый пузырёк в пользовательском цвете, определённом вами.
** Для каждого пользовательского цвета, который вы хотите добавить:
*** Выберите '''Цвет'''.
*** Введите значение, оператор и цвет для использования для этого значения и оператора.
** '''Пример'''
*** Предположим, вы хотите раскрасить пузырьки по трём уровням '''Значения цвета''':
**** '''Зелёный''', если '''Значение цвета''' меньше 4000.
**** '''Жёлтый''', если '''Значение цвета''' достигает или превышает порог 4000.
**** '''Красный''', если '''Значение цвета''' достигает или превышает порог 5000.
*** Чтобы настроить это:
**** Выберите '''Цвет''' и добавьте строку пользовательского цвета со значением 0, оператором ≥ и желаемым оттенком зелёного. Если '''Значение цвета''' равно 0 или выше, пузырёк будет зелёным.
**** Выберите '''Цвет''' и добавьте строку пользовательского цвета со значением 4000, оператором ≥ и желаемым оттенком жёлтого. Если '''Значение цвета''' равно 4000 или выше, пузырёк будет жёлтым.
**** Выберите '''Цвет''' и добавьте строку пользовательского цвета со значением 5000, оператором ≥ и желаемым оттенком красного. Если '''Значение цвета''' равно 5000 или выше, пузырёк будет красным.

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

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

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

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

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

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

* '''Единица измерения''': базовая единица, в которой были записаны значения. Она '''Нет''', если не была включена в результат '''DQL''', или автоматически определена единицей, переданной из результата '''DQL'''. Это поле не приводит к какому-либо преобразованию, но изменяет суффикс, чтобы соответствовать единице измерения.
* '''Конвертировать''': вы можете включить '''Конвертировать''' для преобразования. Например, если результат '''DQL''' определил ваше числовое значение в результате как '''Байты''', '''Конвертировать''' теперь предлагает подходящий список преобразований байтов, таких как '''Килобайт''' и '''Мегабайт'''.
** Поддерживаются только линейные и статические преобразования. Например, вы не можете преобразовать градусы Цельсия (°C) в градусы Фаренгейта (°F) или преобразовать доллары США (US$) в евро (€).
* Раздел '''Формат''' определяет, как отображается единица измерения:
** '''Десятичные знаки''': отображает количество десятичных знаков по умолчанию (степень точности) для отображения. Чтобы увидеть это в действии, измените выбор '''Десятичных знаков''' и наблюдайте изменение в визуализации.
** '''Пользовательский суффикс''': отображает суффикс для отображения после единицы измерения. Чтобы увидеть это в действии, включите '''Пользовательский суффикс''', введите строку и наблюдайте изменение в визуализации. Когда вы не находите нужную единицу измерения, вы можете использовать '''Пользовательский суффикс''', чтобы отобразить желаемую единицу измерения.
** '''Сокращать большие числа''': отображает большие числа в сокращённой форме. Например, 1053 становится 1.1K.
** '''Несколько единиц измерения''': отображает более одной единицы измерения. Включите это и выберите количество единиц измерения для отображения. Например, 90 секунд становится 1m 30s, если включено несколько единиц измерения и выбрано 2 единицы.
* Чтобы выбрать другое поле для строки, откройте правое меню в этой строке и выберите поле из доступных полей.

'''Единицы измерения и форматы: дополнительные действия'''

* Чтобы добавить строку, выберите '''Добавить''' и настройте её, как описано выше.
* '''Действия''' открывает меню дополнительных опций:
** '''Дублировать''' создаёт копию выбранной строки.
** '''Удалить''' удаляет строку.
** '''Сбросить''' сбрасывает настройки в выбранной строке к значениям по умолчанию/метаданным.

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

'''График среднего CPU across всех хостов'''

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

# В '''Дашбордах''' создайте дашборд.
# Выберите соответствующий значок и в разделе '''Библиотека''' меню выберите '''График среднего CPU across всех хостов'''.
# На панели редактирования выберите вкладку '''Визуализация''' и выберите '''Линия'''.
# Разверните '''Единицы и форматы'''.
#* Одна строка уже определена на основе метаданных из <code>avg(dt.host.cpu.usage)</code>.
# Чтобы переопределить настройки единиц измерения для этого поля, откройте левое меню в этой строке, чтобы отобразить настройки единиц измерения.
# Определите переопределение для отображаемой метрики. Вы можете наблюдать свои изменения на оси Y графика.
#* '''Единица измерения''' отображает '''Процент''', который является единицей измерения по умолчанию для выбранной метрики.
#* Включите '''Конвертировать''', чтобы попробовать настройки преобразования. Например, измените '''Авто''' на '''Один''', чтобы отобразить результат как долю от 1.
#* '''Десятичные знаки''' отображает количество десятичных знаков по умолчанию (степень точности) для отображения. Например, введите <code>Pct</code> и просмотрите дашборд, чтобы увидеть <code>Pct</code> вместо % после процентного значения.
#* Включите '''Пользовательский суффикс''', чтобы попробовать разные суффиксы для отображения после единицы измерения. Например, измените выбор '''Десятичных знаков''' и просмотрите дашборд, чтобы увидеть изменение в количестве десятичных знаков в процентном значении.
# Чтобы сбросить к значениям по умолчанию (отменить настройки переопределения для выбранной метрики), откройте меню '''Действия''' для этой строки и выберите '''Сбросить'''.

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

=== Добавление ссылки ===
'''Чтобы добавить ссылку'''

# Откройте раздел '''Ссылки''' на вкладке визуализации вашей выбранной визуализации.
# Выберите соответствующий значок, чтобы открыть '''Добавить ссылку'''.
# Настройте ссылку:
#* '''Имя''': введите описательное имя, такое как «Перейти к хосту», для отображения в меню.
#* '''Значок''': выберите значок, например «Логи», чтобы представить ссылку в меню.
#* '''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 МБ.
* '''Выборка (только логи и спаны)'''
** Приводит к выбору подмножества записей логов или спанов.