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

IKuznetsov в 20:18, 28 сентября 2026

2026-09-28T20:18:04Z

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

2026-09-28T20:15:37Z

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

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

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

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

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

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

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

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

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

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

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

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

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

==== Вид ====

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

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

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

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

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

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

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

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

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

'''Пример сопоставления данных: линейный график, раскрывающийся список 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''' ваше числовое значение определено как <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 МБ.
* '''Выборка (только для логов и спанов)''': приводит к выбору подмножества записей логов или спанов.

← Предыдущая версия		Версия от 20:18, 28 сентября 2026
Строка 1:		Строка 1:

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

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

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

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

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

	* '''Цветовая палитра''': отображает все линии соединения оттенком из выбранной цветовой палитры. Оттенок каждой линии соединения соответствует значению '''~~Color value~~''' относительно других областей.		* '''Цветовая палитра''': отображает все линии соединения оттенком из выбранной цветовой палитры. Оттенок каждой линии соединения соответствует значению '''Значение цвета''' относительно других областей.
	** Пример: если значения '''~~Color value~~''', возвращённые запросом, находятся в диапазоне от 0 до 100:		** Пример: если значения '''Значение цвета''', возвращённые запросом, находятся в диапазоне от 0 до 100:
	*** Линия соединения со значением около 0 получает оттенок ближе к правому краю палитры.		*** Линия соединения со значением около 0 получает оттенок ближе к правому краю палитры.
	*** Линия соединения со значением около 100 получает оттенок ближе к левому краю палитры.		*** Линия соединения со значением около 100 получает оттенок ближе к левому краю палитры.
Строка 116:		Строка 114:
	* Введите значение, оператор и цвет для этого значения и оператора.		* Введите значение, оператор и цвет для этого значения и оператора.

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

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

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

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

	==== Единицы измерения и форматы ====		==== Единицы измерения и форматы ====
Строка 194:		Строка 192:
	** '''Имя''': введите описательное имя, например «Go to Host», для отображения в меню.		** '''Имя''': введите описательное имя, например «Go to Host», для отображения в меню.
	** '''Значок''': выберите значок, например «Logs», для представления ссылки в меню.		** '''Значок''': выберите значок, например «Logs», для представления ссылки в меню.
	** '''URL''': используйте динамические плейсхолдеры для вставки полей данных или переменных. Например, выберите '''Вставить плейсхолдер''' и добавьте плейсхолдер <code>:name</code> в URL, например <code>https://myhost/host=~~{{:name}}~~</code>.		** '''URL''': используйте динамические плейсхолдеры для вставки полей данных или переменных. Например, выберите '''Вставить плейсхолдер''' и добавьте плейсхолдер <code>:name</code> в URL, например <code><nowiki>https://myhost/host=Name</nowiki></code>.
	* Используйте раздел '''Предварительный просмотр''' внизу, чтобы увидеть, как плейсхолдеры заменяются фактическими данными, и проверить ссылку.		* Используйте раздел '''Предварительный просмотр''' внизу, чтобы увидеть, как плейсхолдеры заменяются фактическими данными, и проверить ссылку.
	* Выберите '''Добавить ссылку''', чтобы сохранить. Теперь ссылка появится в меню подсказки визуализации.		* Выберите '''Добавить ссылку''', чтобы сохранить. Теперь ссылка появится в меню подсказки визуализации.