Визуализация гистограммы

Визуализация гистограммы

Руководство

Когда использовать визуализацию гистограммы

Используйте гистограмму для визуализации распределения числовых значений.

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

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

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

Заголовок

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

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

Пример:

1. Определите переменные с именами Status и Emoji на вашем дашборде.
2. Установите заголовок в Current $Emoji status is $Status.
3. Установите Status в Good.
4. Установите Emoji в 🌍.

Заголовок будет отображаться как Current 🌍 status is Good.

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

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

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

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

Разверните для общих правил по настройкам сопоставления данных

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

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

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

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

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

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

Версия Ключ-АСТРОМ 1.319+

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

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

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

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

Ось времени

Выбирает ось X.

Левая ось

Устанавливает масштаб левой оси:

• Логарифмическая
• Линейная

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

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

Цвета

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

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

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

• Первое меню в строке отображает выбранный цвет или цветовую палитру. Откройте это меню, чтобы отобразить три вкладки цветовых опций:
  • Палитры: выберите цветовую палитру для использования в этой строке.
    • Исключения палитры для определённых типов визуализации
      • Тепловая карта и сотовая диаграмма: палитра применяет только первый цвет (если цветовые правила не соответствуют значениям сопоставления данных или не используется Имя), и палитра не отражается в легенде.
      • Категориальная: n-й цвет в палитре применяется к n-му элементу в серии.
      • Категориальная для нескольких подкатегорий: палитры применяются по бину, но не отражаются в легенде.
      • Таблица: палитры не применимы к таблицам.
  • Цвета: выберите цвет для единообразного применения, когда это правило совпадает.
  • Пользовательский: укажите точный шестнадцатеричный код цвета (например, #134FC9) или используйте палитру цветов, чтобы выбрать цвет визуально.
• Второе меню в строке отображает условие, при котором будет отображаться цвет этой строки. Выберите текущую настройку, чтобы изменить поле, оператор и значение по мере необходимости для оценки условия.
  • Поля, доступные для оценки, зависят от необработанных данных.
  • Имя — это специальное свойство, созданное через настройку Сопоставления данных Имена.
  • Значение — это специальное свойство, созданное через настройку Сопоставления данных Значения (только для визуализации тепловой карты).
  • Доступные операторы изменяются в соответствии с оцениваемым условием.

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

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

Помните, что цвета применяются в том порядке, в котором они указаны в разделе Цвета, сверху вниз, поэтому изменение порядка может дать вам разные результаты.

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

• Круговая диаграмма
  • В этом примере визуализации круговой диаграммы мы применили:
    • Зелёный к секторам со значениями ниже 15.
    • Жёлтый к секторам со значениями 15 и выше.
    • Красный к секторам со значениями 20 и выше.
  • Если вы измените порядок строк в разделе Цвета, вы увидите разные цвета. Например, если вы поменяете местами строки 2 и 3 выше, все сектора со значениями 20 и выше будут окрашены в красный, но затем все сектора со значениями 15 и выше, включая все красные сектора, будут окрашены в жёлтый.
• Сотовая диаграмма
  • В этом примере визуализации сотовой диаграммы мы применили:
    • Зелёный ко всем значениям value.A.
    • Жёлтый как маркер строки (слева) для значений value.A 15 и выше.
    • Красный ко всей строке для значений value.A 20 и выше.
  • В результате получилась полностью пороговая сотовая диаграмма. Вы можете использовать другие настройки визуализации сотовой диаграммы, чтобы настроить метки, всплывающую подсказку, легенду и т. д.

Пороги

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

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

1. Выберите соответствующий значок, чтобы отредактировать плитку визуализации.
2. Разверните раздел Пороги.

Не все типы визуализации имеют настройки порогов

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

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

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

1. Чтобы добавить строку, выберите соответствующий значок.
2. Определите порог.
   • Для каждой строки есть два меню настроек, которые используются в комбинации для определения того, какой цвет отображается, если условия порога выполнены:
     • Откройте первое меню, чтобы выбрать стандартный или пользовательский цвет для отображения для выбранного порога.
       • Используйте вкладку Цвета, чтобы выбрать из стандартных цветов. Значения динамичны и варьируются в зависимости от выбранной темы (светлой или тёмной).
       • Используйте вкладку Пользовательский, если вы предпочитаете указать точный шестнадцатеричный код цвета (например, #134FC9) или использовать палитру цветов, чтобы выбрать цвет визуально.
     • Откройте второе меню, чтобы определить условия порога для этого цвета. Это может быть диапазон или одно значение:
       • Используйте вкладку Диапазон, если хотите определить диапазон порога (два значения), между которыми должен применяться выбранный цвет.
         • Заполнено: когда это отключено, диапазон указывается только на оси Y индикатором диапазона в выбранном цвете. Когда это включено, всё в пределах диапазона также окрашивается.
         • Мин: минимальное значение диапазона.
         • Макс: максимальное значение диапазона.
         • Метка: метка для отображения (с диапазоном) при наведении курсора на индикатор диапазона оси Y.
       • Используйте вкладку Линия, если хотите определить единичное значение порога Значение и Метку. Это рисует линию выбранного цвета на значении, которое вы установили здесь.

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

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

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

• Линия
  • В этом примере визуализации таблицы мы применили:
    • Зелёный от 0 % до 75 %.
    • Жёлтый от 75 % до 90 %.
    • Красный от 90 % до 100 %.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Ссылки

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

Добавление ссылки

Чтобы добавить ссылку

1. Откройте раздел Ссылки на вкладке визуализации вашей выбранной визуализации.
2. Выберите соответствующий значок, чтобы открыть Добавить ссылку.
3. Настройте ссылку:
   • Имя: введите описательное имя, такое как «Перейти к хосту», для отображения в меню.
   • Значок: выберите значок, например «Логи», чтобы представить ссылку в меню.
   • URL: используйте динамические заполнители для вставки полей данных или переменных. Например, выберите Вставить заполнитель и добавьте заполнитель :name к вашему URL, например https://myhost/host=Name.
   • Используйте раздел Предварительный просмотр в нижней части, чтобы увидеть, как заполнители будут заменены фактическими данными, и протестировать вашу ссылку.
4. Выберите Добавить ссылку, чтобы сохранить. Ссылка теперь появится в меню всплывающей подсказки визуализации.

Ссылки: дополнительные действия

• Чтобы добавить строку, выберите соответствующий значок и настройте её, как описано в разделе «Добавить ссылку».
• Чтобы переместить строку вверх или вниз в таблице, выберите и перетащите.
• Соответствующий значок открывает меню дополнительных опций:
  • Редактировать отображает поля ссылки для редактирования, как описано в разделе «Добавить ссылку».
  • Дублировать создаёт копию выбранной строки.
  • Удалить удаляет строку.

Подробности см. в разделе «Ссылка из визуализации через пользовательские ссылки».

Ограничения запроса

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

Плитки дашборда и разделы блокнота, созданные в Ключ-АСТРОМ раньше версии 1.296, не затрагиваются. Эти существующие плитки/разделы будут возвращать те же результаты, что и раньше.

• Ограничение чтения данных (ГБ)
  • Ограничение в гигабайтах для объёма данных, который будет просканирован во время чтения.
• Ограничение записей
  • Максимальное количество записей результата, которое вернёт этот запрос. По умолчанию: 1 000 записей. Чтобы увидеть больше записей, вам нужно увеличить значение Ограничения записей.

Если ваш запрос не имеет ограничения, такое как

fetch logs

применяется значение Ограничения записей. По умолчанию вы увидите до 1 000 записей. Если ваш запрос также включает ограничение, такое как

fetch logs
| limit 2000

применяется меньшее из двух значений (либо ограничение в вашем запросе, либо Ограничение записей в веб-интерфейсе).

В приведённом выше примере вы всё равно увидите только 1 000 записей, если не увеличите значение Ограничения записей.

• Ограничение размера результата
  • Максимальное количество байтов результата, которое вернёт этот запрос. Для лучшей производительности с типичными запросами и меньшими документами по умолчанию установлено 1 МБ.
• Выборка (только логи и спаны)
  • Приводит к выбору подмножества записей логов или спанов.