Метрики

Обзор

В разделе APM > Метрики отображаются точки данных метрик, собранные из ваших приложений и служб.

Метрика — это измерение (например, длительность запроса, количество обработанных заказов или использование памяти). Приложения отправляют свои значения в виде точек данных, содержащих значение (или агрегированные значения), измеренное в определённый момент времени. Метрика похожа на элемент данных Zabbix, а точка данных — на значение этого элемента данных.

Точка данных может иметь один из следующих типов:

  • Gauge — значение, измеренное в определённый момент времени (например, текущее использование памяти).
  • Sum — сумма измерений за определённый период времени (например, общее количество запросов).
  • Histogram — количество измерений за определённый период времени, попавших в каждый из нескольких фиксированных диапазонов значений, называемых корзинами (например, сколько запросов выполнялось от 0 до 100 мс, от 100 до 250 мс или от 250 до 500 мс).
  • Exponential histogram — аналог гистограммы, но каждая корзина шире предыдущей в одинаковое количество раз (например, 1–2 мс, 2–4 мс, 4–8 мс).

Каждая точка данных создаётся службой (например, zabbix-frontend; имя задаётся атрибутом ресурса OpenTelemetry service.name) и областью инструментирования — частью кода, которая её создала (например, библиотекой, измеряющей длительность HTTP-запросов).

Чтобы предоставить контекст для каждого измерения, точки данных также содержат ключ-значение атрибуты: атрибуты точек данных описывают, что было измерено, и позволяют различать точки данных одной и той же метрики (например, http.request.method: POST), а атрибуты ресурсов описывают службу и среду, в которой она работает (например, host.name: eabf8c2a5ddc).

Дополнительную информацию о метриках см. в документации OpenTelemetry.

Раздел APM > Метрики содержит следующие элементы:

Список метрик

Каждая строка в списке метрик представляет точку данных.

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

Список метрик может содержать следующие столбцы:

Каждый столбец, кроме Тип, соответствует столбцу в таблицах метрик (otel_metrics_gauge, otel_metrics_sum, otel_metrics_histogram и otel_metrics_exponential_histogram) источника данных телеметрии; список столбцов см. в разделе Поддерживаемые столбцы данных телеметрии. Большинство столбцов имеют те же названия, что и в источнике данных (например, Имя метрики соответствует столбцу MetricName). Если названия отличаются, столбец источника данных указан в таблице ниже.

Столбец Описание
Имя метрики Метрика, которой принадлежит точка данных (например, http.server.duration).
Тип Тип точки данных: Gauge, Sum, Histogram или Exponential histogram.
Определяется таблицей метрик, в которой хранится точка данных.
Единица измерения Единица измерения, если указана, значений метрики (например, s или By; см. UCUM).
Столбец источника данных: MetricUnit.
Имя сервиса Сервис, создавший точку данных.
Имя области Область инструментирования, создавшая точку данных.
Время начала Дата и время начала периода измерения точки данных.
Столбец источника данных: StartTimeUnix.
Сумма/значение Сумма всех измерений (Histogram, Exponential histogram) или значение (Gauge, Sum) точки данных.
Количество Количество измерений в точке данных типа Histogram или Exponential histogram.
Время Дата и время точки данных; для точек данных типов Sum, Histogram и Exponential histogram — конец периода измерения.
Столбец источника данных: TimeUnix.
Флаги Флаги точки данных:
0 - флаги не установлены.
1 - для точки данных не записано значение.
Временная характеристика агрегации Способ агрегации значений точки данных типов Sum, Histogram или Exponential histogram во времени:
Не указано - не указано.
Delta - агрегация за период с момента предыдущей точки данных.
Cumulative - агрегация за период с момента времени начала.
Описание метрики Описание метрики, если указано.
Атрибуты Атрибуты точки данных.
Нажмите кнопку с тремя точками , чтобы отобразить все атрибуты.
Атрибуты ресурса Атрибуты ресурса точки данных.
Нажмите кнопку с тремя точками , чтобы отобразить все атрибуты.
Атрибуты области Атрибуты области инструментирования.
Нажмите кнопку с тремя точками , чтобы отобразить все атрибуты.

Сведения о метрике

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

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

Раздел Описание
Основная информация Имя метрики, тип, единица измерения, имя сервиса и время начала.
Гистограмма Интервалы (например, > 5 - 10), для каждого из которых указано количество измерений.
Отображается только для точек данных типа Гистограмма.
Экспоненциальная гистограмма Интервалы (например, >= 249.7885 - 249.7887), для каждого из которых указано количество измерений.
Отображается только для точек данных типа Экспоненциальная гистограмма.
Информация о метрике Значения точки данных, зависящие от ее типа, а также описание метрики, время, флаги и URL схемы ресурса.
Атрибуты Атрибуты точки данных.
Атрибуты ресурса Атрибуты ресурса.
Атрибуты области Атрибуты области инструментирования, если они есть.
Область Имя, версия и URL схемы области инструментирования.

Использование фильтра

С помощью фильтра можно отображать только интересующие вас точки данных.

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

Поддерживаются следующие операторы:

  • Содержит - (по умолчанию) значение атрибута содержит введенную строку.
  • Равно - значение атрибута равно введенной строке.
  • Не содержит - значение атрибута не содержит введенную строку.
  • Не равно - значение атрибута не равно введенной строке.
  • Существует - атрибут с введенным ключом существует.
  • Не существует - атрибут с введенным ключом не существует.

Если вы добавили несколько условий, выберите способ их оценки:

  • И/Или - (по умолчанию) должны выполняться все условия; условия с одинаковым ключом атрибута объединяются с помощью Или.
  • Или - должно выполняться хотя бы одно условие.