Визуализация списка записей

Материал из Документация Ключ-АСТРОМ
Версия от 19:25, 28 сентября 2026; IKuznetsov (обсуждение | вклад) (Новая страница: « = Визуализация списка записей = '''Руководство''' == Когда использовать визуализацию списка записей == Используйте визуализацию списка записей: * Когда вы хотите увидеть фактические записи, возвращённые запросом, с первого взгляда. * Когда вас интересует...»)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)

Визуализация списка записей

Руководство

Когда использовать визуализацию списка записей

Используйте визуализацию списка записей:

  • Когда вы хотите увидеть фактические записи, возвращённые запросом, с первого взгляда.
  • Когда вас интересует структура записей и то, как распределены значения полей.
  • Когда вы хотите дополнительно исследовать данные через взаимодействия.

Список записей выше перечисляет записи, возвращённые запросом. Некоторые данные в примере были замаскированы.

Взаимодействие со списком записей

Специфично для поля

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

  • Копировать имя поля копирует имя поля выбранного поля в буфер обмена.
  • Объяснить значение — использует ИИ для объяснения поля.
  • Добавить команду в запрос — раздел команд, специфичных для поля, которые вы можете автоматически добавить в свой запрос, такие как:
    • Сортировать по возрастанию добавляет в ваш запрос команду сортировки <fieldname> asc.
    • Сортировать по убыванию добавляет в ваш запрос команду сортировки <fieldname> desc.
    • Суммировать подсчитывает, как часто каждое из различных значений присутствует в результате (например, подсчёт того, как часто присутствует каждый ID хоста).
    • Извлечь поля.
  • Открыть с помощью передаёт всю запись в диалог Открыть с помощью, не учитывая, какое поле вы выбрали.

Специфично для значения

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

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

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

  • Меньше
  • Меньше или равно
  • Равно
  • Больше
  • Больше или равно
  • Не равно
  • Позже чем
  • Раньше чем
  • ±5 секунд
  • Извлечь поля
  • Добавить имена сущностей добавляет поиск (результат добавляется в отдельное поле с именем dt.entity.<entity>.name) фактического имени сущности, связанной с данным ID сущности.
  • Развернуть
  • Сократить до одного значения делает ваши результаты подходящими для определённых визуализаций, таких как «Одно значение», «Таблица» или «Категориальная столбчатая диаграмма».

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

Открыть с помощью передаёт всю запись в диалог Открыть с помощью, не учитывая, какое значение вы выбрали.

Заголовок

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

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

Пример:

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

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

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

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

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

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

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