Визуализация одного значения

Визуализация одного значения

Руководство

Когда использовать визуализацию одного значения

Используйте визуализацию одного значения, когда хотите:

• Показать одно агрегированное измерение и его тенденцию во времени.
• Выразить важные бизнес-показатели (KPI).
• Выразить критически важные цели уровня сервиса (SLO), связанные с инфраструктурой.

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

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

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

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

Заголовок

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

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

Пример:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Одно значение: столбец вашего результата, отображаемый в визуализации одного значения.
• Спарклайн: значение, которое должно быть отражено в спарклайне в визуализации одного значения. Это также влияет на тенденцию, которая рассчитывается как разница между первым и последним элементами временного ряда, выбранного как спарклайн.
• Интервал: это значение сопоставляется автоматически и не может быть изменено. Оно позволяет узнать, какие поля сопоставлены для результатов на основе временных рядов. Берётся первое доступное поле интервала из набора результатов всякий раз, когда используется временной ряд (также включает данные на основе makeTimeseries).
• Тенденция: выберите Авто, чтобы автоматически рассчитать тенденцию на основе данных, предоставленных для спарклайна. Выберите Пользовательская, чтобы выбрать числовое поле.

Представление в виде сетки

Когда результат состоит из нескольких строк:

• Раньше в визуализации одного значения отображался только последний результат.
• Начиная с версии Ключ-АСТРОМ 1.324 визуализация одного значения автоматически переключается в представление в виде сетки, где каждое значение отображается как отдельное значение. Максимальное количество значений, отображаемых в сетке, — 25.

Преимущества:**

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

Если вы предпочитаете предыдущее поведение (без сетки), вы можете применить команду limit и команду сортировки в DQL или через интерфейс Explore.

Одно значение

Используйте эти параметры, чтобы указать общие параметры отображения вашей визуализации.

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

Тенденция

Чтобы включить или отключить тенденцию, используйте переключатель в правом верхнем углу. Если он включён:

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

Спарклайн

Чтобы включить или отключить спарклайн, используйте переключатель в правом верхнем углу. Если он включён:

• Вариант отображает спарклайн в формате области, линии или столбца.
• Цвет спарклайна определяет цвет спарклайна.
• Масштабировать значения определяет линейное или логарифмическое масштабирование.
• Цвет устанавливает цвет спарклайна.
• Показывать деления определяет, отображать ли значения вдоль оси X.
• Поле записи определяет поле записи для отображения в виде спарклайна на визуализации.
• Минимальное значение устанавливает минимальное значение в данных.
  • Авто выбирает подходящее минимальное значение на основе данных (0 или минимальное значение).
  • Пользовательский позволяет установить ручное минимальное значение.
• Максимальное значение устанавливает максимальное значение в данных.
  • Авто выбирает подходящее максимальное значение на основе данных (0 или максимальное значение).
  • Пользовательский позволяет установить ручное максимальное значение.

Цвета

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

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

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

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

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

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

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

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

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

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

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

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 МБ.
• Выборка (только логи и спаны)
  • Приводит к выбору подмножества записей логов или спанов.