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


== Визуализация диаграммы рассеяния ==

=== Когда использовать диаграмму рассеяния ===
Используйте диаграмму рассеяния, когда нужно:

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

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

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

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

* '''Копировать серию''' — копирует значение поля.
* '''Копировать значение''' — копирует значение поля.
* '''Копировать значение Y''' — копирует значение поля.

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

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

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

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

* Определите в дашборде переменные с именами <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+
* Уже существующие плитки и разделы считаются пользовательскими. Их конфигурации сопоставления данных не обновляются автоматически.
* Новые плитки и разделы по умолчанию применяют настройку сопоставления данных. Если вы не изменяете эти настройки вручную, они могут измениться, если новый запуск плитки/раздела изменит результаты и появятся отсутствующие поля или новые поля, которые лучше подходят для сопоставления данных.

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

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

* '''Ось X''': выберите значение для использования по оси X диаграммы рассеяния. Подходящие значения: '''Временной диапазон''', '''Числовой''' (Double и Long), '''Категориальный''' (String и Boolean).
* '''Ось Y''': выберите значение для использования по оси Y диаграммы рассеяния. Подходящие значения: '''Числовой''' (Double и Long), '''Категориальный''' (String и Boolean).
* '''Имена''': элементы, отображаемые, например, в легенде и именах серий. Подходящие поля: '''Категориальный''' (String и Boolean), '''Числовой''' (Double и Long) или '''Имя поля'''.

Возможные комбинации X/Y:
{| class="wikitable"
!Ось X
!Ось Y
|-
|Временной диапазон
|Array
|-
|Числовой
|Числовой
|-
|Числовой
|Категориальный
|-
|Категориальный
|Категориальный
|-
|Категориальный
|Числовой
|}
Примечания:

* '''Временной диапазон''' поддерживается только на оси X и представляет собой комбинацию Timestamp + Duration.
* Timestamp считается числовым типом.

==== Ось времени ====
Выбирает ось X.

==== Левая ось ====
Задаёт масштаб левой оси:

* '''Логарифмический'''
* '''Линейный'''

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

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

==== Цвета ====
Настройки цвета для визуализации отображаются в строках.

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

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

* Первое меню в строке отображает выбранный цвет или цветовую палитру. Откройте это меню, чтобы отобразить три вкладки параметров цвета:
** '''Палитры''': выберите цветовую палитру для использования в этой строке.
*** Исключения палитры для определённых типов визуализации: тепловая карта и сотовая диаграмма — палитра применяет только первый цвет (если правила цвета не соответствуют значениям сопоставления данных или не используется Name), и палитра не отражается в легенде; категориальная — n-й цвет в палитре применяется к n-му элементу в серии; категориальная для нескольких подкатегорий — палитры применяются по интервалам, но не отражаются в легенде; таблица — палитры не применимы к таблицам.
** '''Цвета''': выберите цвет для единообразного применения, когда это правило совпадает.
** '''Настраиваемый''': укажите точный шестнадцатеричный код цвета (например, <code>#134FC9</code>) или используйте палитру цветов, чтобы выбрать цвет визуально.
* Второе меню в строке отображает условие, при котором будет отображаться цвет этой строки. Выберите текущую настройку, чтобы изменить поле, оператор и значение по мере необходимости для оценки условия.
* Поля, доступные для оценки, зависят от исходных данных.
* Name — это специальное свойство, формируемое через настройку '''Сопоставление данных''' → Names.
* Value — это специальное свойство, формируемое через настройку '''Сопоставление данных''' → Values (только для визуализации тепловой карты).
* Доступные операторы меняются в соответствии с оцениваемым условием.

'''Цвета: дополнительные действия'''

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

'''Цвета: примеры:'''

==== Круговая диаграмма ====
В этом примере визуализации круговой диаграммы мы применили:

* Зелёный к срезам со значениями ниже 15.
* Жёлтый к срезам со значениями 15 или выше.
* Красный к срезам со значениями 20 или выше.

Если изменить порядок строк в разделе '''Цвета''', вы увидите другие цвета. Например, если поменять местами строки 2 и 3 выше, все срезы со значениями 20 или выше будут окрашены в красный, но затем все срезы со значениями 15 или выше, включая все красные срезы, будут окрашены в жёлтый.

'''Пример визуализации круговой диаграммы с применённой раскраской'''

==== Сотовая диаграмма ====
В этом примере визуализации сотовой диаграммы мы применили:

* Зелёный ко всем значениям <code>value.A</code>.
* Жёлтый как маркер строки (слева) для значений <code>value.A</code> 15 или выше.
* Красный ко всей строке для значений <code>value.A</code> 20 или выше.
* Результат — полностью пороговая сотовая диаграмма. Можно использовать другие настройки визуализации сотовой диаграммы для настройки меток, подсказки, легенды и т. д.

'''Пример визуализации сотовой диаграммы с применённой раскраской'''

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

Чтобы настроить порог в визуализации дашборда или блокнота:

* Выберите '''Редактировать''', чтобы редактировать плитку визуализации.
* Разверните раздел '''Пороги'''.

Не все типы визуализаций имеют настройки порогов. Только следующие визуализации имеют настройки '''Пороги''':

* Область
* Категориальная
* Линия
* Столбчатая
* Полосовая
* Гистограмма
* Диаграмма рассеяния

Для других типов визуализаций используйте раздел '''Цвета''', чтобы получить аналогичные эффекты, применяя зависящие от значений цвета к элементам визуализации, таким как строки таблицы, ячейки сотовой диаграммы и срезы круговой диаграммы.

Чтобы добавить строку, выберите '''Добавить'''.

Определите порог.

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

* Откройте первое меню, чтобы выбрать стандартный или настраиваемый цвет для отображения выбранного порога.
** Используйте вкладку '''Цвета''', чтобы выбрать из стандартных цветов. Значения динамические и зависят от выбранной темы (светлая или тёмная).
** Используйте вкладку '''Настраиваемый''', если вы предпочитаете указать точный шестнадцатеричный код цвета (например, <code>#134FC9</code>) или использовать палитру цветов для визуального выбора цвета.
* Откройте второе меню, чтобы определить условия порога для этого цвета. Это может быть диапазон или одно значение:
** Используйте вкладку '''Диапазон''', если хотите определить диапазон порога (два значения), между которыми должен применяться выбранный цвет.
*** '''Заливка''': если выключено, диапазон обозначается только на оси Y индикатором диапазона выбранного цвета. Если включено, всё в пределах диапазона также окрашивается.
*** '''Мин''': минимальное значение диапазона.
*** '''Макс''': максимальное значение диапазона.
*** '''Метка''': метка для отображения (вместе с диапазоном) при наведении курсора на индикатор диапазона на оси Y.
** Используйте вкладку '''Линия''', если хотите определить одно значение порога и метку. Это рисует линию выбранного цвета на заданном значении.

'''Пороги: дополнительные действия'''

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

'''Пороги: примеры'''

==== Линия ====
В этом примере визуализации таблицы мы применили:

* Зелёный от 0% до 75%.
* Жёлтый от 75% до 90%.
* Красный от 90% до 100%.

'''Пример визуализации линии с применёнными порогами'''

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

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

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

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

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

'''Примеры строк в настройках «Единицы измерения и форматы»'''

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

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