Гистограммные метрики - История изменений

IKuznetsov в 17:52, 22 октября 2026

2026-10-22T17:52:11Z

← Предыдущая версия		Версия от 17:52, 22 октября 2026
Строка 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>). Визуализация распределения вхождений по корзинам за заданный период времени (обычно с помощью визуализации столбчатой диаграммы) в настоящее время не поддерживается. Для получения дополнительной информации см. '''Редактирование визуализаций для Блокнотов и Дашбордов'''.

IKuznetsov: Новая страница: « = Гистограммные метрики = Гистограммные метрики — это мощный способ фиксации распределения значений для заданного измерения, например времени отклика, размера запросов или длительности. В отличие от счётчика, который измеряет общий итог в одном знач...»

2026-10-13T23:20:15Z

Новая страница: « = Гистограммные метрики = Гистограммные метрики — это мощный способ фиксации распределения значений для заданного измерения, например времени отклика, размера запросов или длительности. В отличие от счётчика, который измеряет общий итог в одном знач...»

Новая страница

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

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

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

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

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

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

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

* Кумулятивные гистограммы не загружаются (аналогично кумулятивным счётчикам).
* Точки данных гистограммы без <code>sum</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 percentile</code>, необходимая для запроса гистограмм, доступна только клиентам '''DPS''' с тарифной картой «Метрики на платформе». Для получения дополнительной информации см. '''Обзор метрик (DPS)'''.