Гистограммные метрики: различия между версиями

Материал из Документация Ключ-АСТРОМ
ВизуальныйВики-текст
Новая страница: « = Гистограммные метрики = Гистограммные метрики — это мощный способ фиксации распределения значений для заданного измерения, например времени отклика, размера запросов или длительности. В отличие от счётчика, который измеряет общий итог в одном знач...»
 
Нет описания правки
 
Строка 22: Строка 22:
* Корзины гистограммы не отсортированы.
* Корзины гистограммы не отсортированы.
* Граничные значения корзин гистограммы <code>NaN</code> или <code>Infinite</code> недопустимы.
* Граничные значения корзин гистограммы <code>NaN</code> или <code>Infinite</code> недопустимы.
== Запрос процентилей с помощью DQL ==
'''Язык запросов Ключ-АСТРОМ (DQL)''' позволяет анализировать гистограммные метрики с помощью агрегации <code>percentile</code>. Он вычисляет запрошенный процентиль по всем корзинам для каждого временного слота. Например:<pre>timeseries percentile(http_request_duration_seconds_bucket, 99)</pre>Запрос вычисляет 99-й процентиль значений на основе загруженных корзин гистограммы. Гистограммы представляют данные в виде серии корзин, каждая из которых содержит количество значений, попадающих в определённый диапазон. Например, <code>http_request_duration_seconds_bucket</code> содержит количество длительностей запросов, сгруппированных по предопределённым диапазонам (измерение <code>le</code>). Функция <code>percentile</code> использует данные корзин для оценки запрошенного процентиля (например, 99-го процентиля). Она интерполирует значение, ниже которого находится 99% наблюдаемых точек данных, на основе кумулятивных счётчиков в корзинах гистограммы. Этот запрос особенно полезен для анализа метрик задержки или производительности, поскольку процентили дают представление о наихудших сценариях, с которыми сталкиваются пользователи.


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


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

Текущая версия от 17:52, 22 октября 2026

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Источник — https://doc.ruscomtech.ru/index.php?title=Гистограммные_метрики&oldid=7221