Визуализация таблицы

Визуализация таблицы

Руководство

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

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

• Когда вы хотите получить первую выборку и представление о данных, возвращаемых вашим запросом или кодом. Например, покажите мне топ-100 последних строк логов для моего приложения или хоста.
• Когда вы хотите просмотреть много записей сразу. Когда плотность данных и возможность сравнить записи одну за другой важнее, чем увидеть все поля, содержащиеся в результате, одновременно.
• Когда вам нужно дополнительно исследовать данные через взаимодействия.

Взаимодействие с таблицей

Специфично для таблицы

• Щёлкните левой кнопкой мыши по заголовку столбца, чтобы локально отсортировать результаты по этому столбцу.
  • Соответствующий значок указывает, что таблица не отсортирована.
  • Соответствующий значок указывает, что таблица отсортирована по возрастанию по этому столбцу.
  • Соответствующий значок указывает, что таблица отсортирована по убыванию по этому столбцу.

Специфично для столбца

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

• Переместить влево перемещает выбранный столбец на одну позицию влево.
• Переместить вправо перемещает выбранный столбец на одну позицию вправо.
• Скрыть столбец скрывает выбранный столбец. Чтобы снова отобразить скрытый столбец, отредактируйте таблицу и в разделе Столбцы отредактируйте настройки Видимости и порядка, чтобы настроить видимые столбцы и их порядок.
• Включить перенос строк и Отключить перенос строк определяют, переносить ли текст в выбранном столбце.
• Копировать имя поля копирует имя поля выбранного столбца в буфер обмена.

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

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

Специфично для строки

Щёлкните левой кнопкой мыши в любом месте строки, чтобы выбрать всю строку. С выбранной строкой вы можете затем нажать левой кнопкой мыши и перетащить внутри ячейки этой строки, чтобы выбрать именно то, что хотите скопировать (Ctrl+C) из ячейки.

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

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

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

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

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

• Копировать значение копирует значение в ячейке в буфер обмена.
• Просмотреть в полноэкранном режиме применяется только к строкам. Он отображает содержимое ячейки в полноэкранном окне.
  • Соответствующие значки позволяют переходить от записи к записи.
  • Соответствующий значок копирует текущее значение в буфер обмена.
  • Соответствующий значок закрывает окно и возвращает к таблице.
• Рекомендуемое приложение, например Kubernetes (новое) Просмотреть рабочую нагрузку Kubernetes, может быть указано для быстрого доступа.
• Открыть с помощью передаёт всю запись в диалог Открыть с помощью, не учитывая, какое поле вы выбрали. Это приводит к более широкому диапазону возможных опций Открыть с помощью.

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

• Фильтровать результаты запроса по выбранной ячейке и соответствующему оператору (например, «Больше значения ячейки»).
• Добавить имена сущностей добавляет поиск (результат добавляется в отдельное поле с именем dt.entity.<entity>.name) фактического имени сущности, связанной с данным ID сущности.

Заголовок

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

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

Пример:

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

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

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

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

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

Столбцы

• Видимость и порядок: выберите Редактировать, чтобы настроить видимые столбцы и их порядок.
  • Когда вы скачиваете данные таблицы в файл (выберите > Скачать результат > CSV), скачивание включает только столбцы, выбранные здесь.
  • Это полезно, например, когда вы хотите скачать файл CSV, открыть его в электронной таблице и поделиться таблицей с другими, но хотите исключить неактуальные или конфиденциальные данные из скачивания.
• Перенос строк: определяет, переносить ли строки, выходящие за пределы ширины столбца.
  • Все: применяет перенос строк ко всем столбцам таблицы.
  • Пользовательский: применяет перенос строк к выбранным столбцам таблицы.
• Моноширинный шрифт: определяет, использовать ли моноширинный шрифт.
  • Все: применяет моноширинный шрифт ко всем столбцам таблицы.
  • Пользовательский: применяет моноширинный шрифт к выбранным столбцам таблицы.
• Пользовательские типы столбцов: определяет форматирование столбцов. Выберите Тип столбца, чтобы добавить строку, затем выберите один или несколько столбцов и то, как хотите отформатировать выбранные столбцы.

Результаты таблицы

Если результат таблицы содержит более 50 столбцов, ваш результат покажет только первые 50 столбцов. Если результат больше 50, вы увидите предупреждение, информирующее вас об этом. Предупреждение позволит вам Изменить видимость, где вы можете выбрать, какие столбцы должны отображаться, и изменить порядок их отображения.

Ячейки

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

Цвета

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

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

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

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

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

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

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

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

• Таблица
  • В этом примере визуализации таблицы мы применили:
    • Зелёный ко всем значениям value.A.
    • Жёлтый как маркер строки (слева) для значений value.A 15 и выше.
    • Красный ко всей строке для значений value.A 20 и выше.
  • Обратите внимание, что настройки цвета могут быть специфичны для визуализации. В этом примере таблицы мы использовали Применить к для применения цвета разными способами, специфичными для таблицы:
    • Мы выбрали Значения, чтобы применить зелёный ко всем значениям 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 МБ.
• Выборка (только логи и спаны)
  • Приводит к выбору подмножества записей логов или спанов.