Исследование данных

Материал из Документация Ключ-АСТРОМ
Версия от 22:03, 16 ноября 2026; IKuznetsov (обсуждение | вклад)
(разн.) ← Предыдущая версия | Текущая версия (разн.) | Следующая версия → (разн.)

Исследование данных

Дашборды и Блокноты Ключ-АСТРОМ предлагают следующие варианты исследования данных:

  • Использовать агентный и генеративный ИИ Ключ-АСТРОМ Intelligence и естественный язык для доступа к данным, хранящимся в хранилище.
  • Начать с нашего интерфейса Explore для таких типов данных, как логи и метрики.

Начало работы

Чтобы исследовать данные, такие как логи и метрики, с помощью нашего интерфейса point-and-click

  1. В вашем документе откройте меню Добавить и выберите вариант в зависимости от того, что хотите исследовать.
    • В этом примере выберите Логи, но есть и другие варианты.

Ниже мы рассмотрим следующие варианты:

  • Логи — исследуйте логи через интерфейс. Мы используем этот вариант в следующем примере.
  • Метрики — исследуйте метрики через интерфейс.

После того как вы попробуете эти варианты, вы будете готовы исследовать следующие дополнительные варианты с минимальными пояснениями:

  • События
  • Проблемы
  • Трассировки
  • Пользовательские сессии
  • События безопасности
  • Пользовательские события

Макеты немного различаются между Дашбордами и Блокнотами, чтобы соответствовать разным контекстам, но функциональность одинакова.

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

В этом примере мы сосредоточимся на Логах. По умолчанию добавляется поле фильтра и лимит по умолчанию 20.

Щёлкните в поле фильтра и, например, выберите content как поле из списка предлагаемых полей.

Добавьте оператор и строку поиска сразу после него.

Предлагаются только операторы, relevant для типа данных.

Оператор Описание
~ Используйте тильду для сопоставления конкретного поля или для поиска по всем данным. Например, content ~ error перечисляет записи логов, содержащие «error» в поле «content».
= равно
!= не равно
< меньше
<= меньше или равно
> больше
>= больше или равно
= * любое значение
!= * не любое значение
in соответствует одному или нескольким значениям в списке значений
not in не соответствует ни одному значению в списке значений

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

Кнопка в нижней части определения открывает меню дополнительных команд, которые вы можете добавить.

Выберите любую кнопку в определении, чтобы удалить элемент, стоящий перед ней. Если вы удалите элемент, а затем передумаете, вы можете использовать кнопку, чтобы выбрать его из меню и добавить обратно в определение.

Выберите Запустить, чтобы протестировать и увидеть результаты.

Переход к полям Smartscape

В рамках постоянных улучшений платформы Ключ-АСТРОМ поля dt.entity.* теперь устарели. Чтобы обеспечить согласованность и точность ваших запросов и исследования данных, мы рекомендуем перейти на эквивалентные поля dt.smartscape.*.

Что это означает для вас Ключ-АСТРОМ автоматически использует новую нотацию Smartscape, когда это возможно, чтобы улучшить ваш опыт. Если вы видите следующее сообщение:

> «Поля dt.entity.* устарели. Пожалуйста, используйте поля dt.smartscape.* вместо них.»

это указывает на то, что поля dt.entity.* в конечном итоге будут удалены.

Что вам следует сделать

  • Обновите ваши запросы, заменив поля dt.entity.* на соответствующие поля dt.smartscape.*.
  • Просмотрите ваши дашборды и блокноты, чтобы убедиться в совместимости с новыми полями Smartscape.

Логи

Эта функциональность исследования одинакова в Дашбордах и Блокнотах. В этом примере мы используем Блокноты.

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

Готово. Вы извлекли первые 20 строк логов всего за несколько кликов.

Чтобы сделать это полезнее, теперь щёлкните в поле, чтобы получить предложения фильтров. Предложения фильтров доступны для любого поля, кроме content.

Фильтрация по log.source

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

Для этого нам нужно указать:

  • Поле, в данном случае log.source, в фильтре.
  • Желаемый оператор, такой как =.
  • Значение фильтра (строка, которая должна встречаться где-то в поле log.source).
  1. Поместите курсор в поле фильтра и начните вводить log.source или найдите его через поиск в верхней части предложений, затем выберите его.
  2. Добавьте = как оператор, выбрав его из предложений автодополнения или введя его.
  3. Введите строку, которую хотите найти.
    • В этом примере введите oneagent, чтобы получить все логи, где поле log.source содержит oneagent.
  4. Добавьте подстановочный знак * до и после вашего термина фильтра, чтобы результаты были ограничены логами, где поле log.source содержит oneagent, а не только точные совпадения.
  5. Выберите Запустить и просмотрите результаты.

Фильтрация по content

Начиная с предыдущего примера, давайте добавим фильтр content, чтобы сосредоточиться на логах, где content содержит строку crash (и, поскольку мы начинаем с предыдущих настроек, где поле log.source содержит oneagent).

  1. Поместите курсор в поле фильтра сразу после ранее добавленного фильтра log.source и либо выберите content из предлагаемых полей, либо введите его.
  2. Добавьте = как оператор.
  3. Введите строку, которую хотите найти.
    • Если вы используете Дашборды, вы также можете ссылаться на существующие переменные, введя знак $ и выбрав нужную переменную. В этом примере мы ищем логи, содержащие строку crash где-то в content, поэтому введите crash.
  4. Добавьте подстановочный знак * до и после вашего термина фильтра.
  5. Выберите Запустить и просмотрите результаты.

Теперь результаты ограничены логами, где поле log.source содержит oneagent, а content содержит строку crash. Если вы хотите искать все вхождения, где применяется либо один, либо другой фильтр, добавьте OR между двумя фильтрами.

Фильтрация по status

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

  1. Поместите курсор в поле фильтра сразу после ранее добавленного фильтра content и либо выберите status из предлагаемых полей, либо введите его.
  2. Добавьте in как оператор.
  3. Введите все статусы, по которым хотите фильтровать. Либо используйте предоставленные предложения значений, либо введите их через запятую.
  4. Выберите Запустить и просмотрите результаты.

Summarize

Чтобы суммировать результаты:

  1. Откройте меню Команды и выберите Суммировать.
  2. Укажите, как вы хотите суммировать результаты.
    • Вы можете выбрать между вариантами агрегации, а также выбрать поле, по которому агрегируются результаты.

Convert to time series

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

Чтобы преобразовать события на основе логов в формат временного ряда:

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

Bucketize

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

  1. Откройте меню Команды и выберите Bucketize.
  2. Выберите поле, для которого хотите создать бакеты.
  3. Установите значение Bucketize.

Sort

Чтобы отсортировать результаты:

  1. Выберите Сортировать.
  2. После выбора Сортировать используйте меню Сортировать по, чтобы выбрать поле, по которому хотите сортировать, и выбрать порядок — по возрастанию или по убыванию.
    • value.A выбрано по умолчанию.
    • Сортировка применяется ко всем метрикам, включённым в запрос.

Limit

Чтобы изменить лимит результатов, измените значение Лимит на максимальное количество записей, которое хотите вернуть. Если настройка Лимит не отображается, выберите Лимит и затем установите значение.

Метрики

Добавление

Эта функциональность исследования одинакова в Дашбордах и Блокнотах. В этих примерах мы используем Блокноты.

  1. Откройте Блокноты и выберите Блокнот в заголовке приложения, чтобы создать новый блокнот.
  2. В пустом блокноте откройте меню Добавить и выберите Метрики.
  3. Используйте селектор метрик, чтобы выбрать метрику, которую хотите исследовать.

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

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

Дополнительные параметры, специфичные для метрики

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

Команды, специфичные для метрики:

  • Фильтры
  • Разделить по
  • Сравнить с предыдущим периодом
  • Значение по умолчанию
  • Скорость
  • Сократить до одного значения
  • Скрыть
  • Дублировать
  • Удалить
  • Псевдоним
  • Bucketize

Глобальные команды:

  • Сортировать
  • Лимит
  • Интервал

Добавление другой метрики или выражения

  • Чтобы добавить другую метрику, выберите глобальное меню и затем Метрика.
  • Чтобы добавить выражение, выберите глобальное меню и затем Выражение.

Скрыть или показать

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

  • Чтобы скрыть метрику или выражение из результата, выберите меню для этой метрики или выражения и затем выберите Скрыть.
  • Чтобы снова показать её, выберите меню для этой метрики или выражения и затем выберите Показать.

Дублировать

Чтобы сделать копию метрики или выражения, которое вы уже добавили, выберите меню для этой метрики или выражения и затем выберите Дублировать. Отредактируйте копию по мере необходимости.

Удалить

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

Фильтр

Начиная с предыдущего примера, давайте добавим фильтр host.name, чтобы сосредоточиться на конкретных хостах, где поле host.name содержит определённое имя хоста.

  1. Выберите меню, специфичное для метрики, и затем выберите Фильтры.
  2. Поместите курсор в поле фильтра и либо выберите host.name из предлагаемых полей, либо введите его.
  3. Добавьте = как оператор.
  4. Введите имя хоста, по которому хотите фильтровать, или используйте одно из предоставленных предложений значений.
  5. Выберите Запустить и просмотрите результаты.

Примечание: в качестве альтернативы использованию автоматически обогащённых полей, таких как host.name или k8s.pod.name, имена и теги автоматически предлагаются как дополнительные значения фильтра для каждой сущности, содержащейся в ваших данных. Например, если ваши данные содержат сущность dt.entity.host, два дополнительных поля dt.entity.host.name и dt.entity.host.tags предлагаются в предложениях полей для использования в качестве фильтра.

Split by (Aggregate)

Если Разделить по не отображается:

  1. Откройте меню Команды для метрики и затем выберите Разделить по.
  2. Используйте меню Разделить по, чтобы сделать выбор агрегации.
    • Чтобы увидеть ту же метрику по хосту, мы можем агрегировать по (Разделить по) dt.entity.host и затем снова выбрать Запустить.

Теперь мы получаем отдельную линию для каждого хоста.

Compare to previous period

Чтобы сдвинуть метрику на предыдущий период и добавить её для сравнения:

  1. Выберите меню, специфичное для метрики, и затем выберите Сравнить с предыдущим периодом.
  2. В разделе Сравнить с предыдущим периодом введите число и выберите единицу измерения (секунды, минуты, часы или дни) для относительного сдвига времени.

Default value

Чтобы заменить нулевые значения в данных временного ряда значением по умолчанию:

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

Rate

Чтобы визуализировать скорость изменения метрики:

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

Reduce to single value

Чтобы сделать результаты подходящими для определённых визуализаций, таких как «Одно значение», «Таблица» или «Категориальная столбчатая диаграмма»:

  1. Выберите меню, специфичное для метрики, и затем выберите Сократить до одного значения.
  2. Используйте меню Сократить до одного значения, чтобы выбрать значение.
    • Это сокращает данные временного ряда до одного скалярного значения за выбранный временной диапазон и добавляет его как новый столбец value, который затем можно использовать для правильного сопоставления результатов с вашей визуализацией.

Alias

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

Чтобы добавить псевдоним для метрики:

  1. Выберите метрику в вашем определении запроса. Это сделает имя метрики редактируемым.
  2. Введите псевдоним и нажмите Enter.

В этом примере мы добавили метрику avg(dt.host.cpu.usage) в наш запрос, и теперь мы хотим дать ей более простое альтернативное имя, такое как Average host CPU usage, для отображения вместо avg(dt.host.cpu.usage) в разделе блокнота или плитке дашборда.

Bucketize

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

  1. Откройте меню Команды для метрики и выберите Bucketize.
  2. Установите значение Bucketize.

Выражения

Добавьте выражения, чтобы применить арифметику на основе выбранных метрик.

  1. Добавьте метрики, на которых хотите основывать ваше выражение.
  2. Например, чтобы вычислить общую ёмкость всех ваших дисков, мы можем выбрать:
    • dt.host.disk.used как нашу первую метрику, A.
    • dt.host.disk.avail как нашу вторую метрику, B.
  3. Выберите глобальное меню Источник и затем выберите Выражение.
  4. Определите ваше выражение, комбинируя ссылки из:
    • Определённых метрик, таких как A, B и C.
    • Поддерживаемых математических и логических операторов, таких как +, -, /, *, (, и ).
    • Например, чтобы вычислить общую ёмкость диска, мы просто складываем обе метрики вместе, используя A+B.
  5. Выберите Запустить и просмотрите результаты.

Sort

См. выше в разделе Логи.

Limit

Чтобы сфокусировать наше исследование, мы можем установить лимит на возвращаемые результаты. Если вы добавите несколько метрик в ваш запрос, лимит применяется ко всем из них.

  1. Выберите Лимит, чтобы добавить Лимит.
  2. Установите Лимит на максимальное количество записей, которое хотите вернуть. В этом случае мы установили лимит равным 5 и затем снова запустили его, чтобы увидеть следующие результаты.

Interval

Интервал определяет временную гранулярность для метрик, определяя, как данные группируются и агрегируются во времени. Он выражается как продолжительность каждого временного слота (например, 1h, 5m) для агрегации точек данных. Если вы добавите несколько метрик в ваш запрос, интервал применяется ко всем из них, обеспечивая согласованность гранулярности данных across всех метрик.

  1. Выберите Интервал, чтобы добавить селектор Интервал в ваш запрос.
  2. Выберите интервал.

Исследование других областей

В предыдущих разделах мы показали, как исследовать Метрики и Логи через наш интерфейс point-and-click.

Вы также можете исследовать следующие области аналогичным образом:

  • События
  • Проблемы
  • Трассировки
  • Пользовательские сессии
  • События безопасности
  • Пользовательские события

Во всех случаях функциональность одинакова.

  1. Перейдите в Блокноты или Дашборды.
  2. Создайте новый блокнот или дашборд.
  3. Выберите соответствующий значок и выберите один из вышеперечисленных вариантов (например, События), чтобы добавить соответствующий раздел блокнота или плитку дашборда.
  4. Просмотрите результаты. Если изначально результаты не отображаются, выберите Запустить.
  5. С этого момента вы можете применить то, что узнали из предыдущих примеров, чтобы сфокусировать ваше исследование.