Гистограммные метрики

Гистограммные метрики

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

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

Варианты использования гистограммных метрик

• Измерение распределения времени отклика для сервисов или конечных точек.
• Отслеживание размеров запросов или полезных нагрузок.
• Анализ метрик задержки или длительности в распределённых системах.

Для более глубокого изучения гистограмм и их преимуществ см. серию публикаций в блоге OpenTelemetry.

Загрузка гистограммных метрик

Специальная конфигурация для загрузки гистограмм из OpenTelemetry (API загрузки OTLP) или источников Prometheus (Оператор) не требуется. Гистограммные метрики отправляются автоматически, когда ваша среда получает данные OpenTelemetry или Kubernetes. Экспоненциальная гистограмма OpenTelemetry не поддерживается как гистограмма: значения min|max|sum|count гистограммы загружаются, но корзины — нет.

Если происходит что-либо из перечисленного ниже, API загрузки OpenTelemetry возвращает ответ 400 или 200 с частичным успехом:

• Кумулятивные гистограммы не загружаются (аналогично кумулятивным счётчикам).
• Точки данных гистограммы без sum не загружаются. Это происходит, когда записываются отрицательные значения.
• Корзины гистограммы не отсортированы.
• Граничные значения корзин гистограммы NaN или Infinite недопустимы.

Примеры визуализации и важные предупреждения

Вы можете визуализировать гистограммные метрики в Блокнотах или Дашбордах. Однако помните о следующих ограничениях:

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

Лицензирование и тарификация

Функция timeseries percentile, необходимая для запроса гистограмм, доступна только клиентам DPS с тарифной картой «Метрики на платформе». Для получения дополнительной информации см. Обзор метрик (DPS).