Типы метрик
1. Counter (Счетчик)
Counter - это кумулятивная метрика, представляющая собой один монотонно возрастающий счетчик, значение которого может только увеличиваться или обнуляться при перезапуске. Например, вы можете использовать счетчик для представления количества обслуженных запросов, выполненных задач или ошибок. Не используйте счетчик для представления значения, которое может уменьшаться. Например, не используйте счетчик для количества текущих запущенных процессов; вместо него используйте индикатор.
2. Gauge (Измеритель)
Gauge - это метрика, представляющая собой одно числовое значение, которое может произвольно увеличиваться или уменьшаться. Обычно gauge используются для измерения таких величин, как температура или текущее использование памяти, а также для «подсчетов», которые могут увеличиваться и уменьшаться, например количество одновременных запросов.
3. Histogram (Гистограмма)
Histogram регистрирует отдельные измерения (например, длительности запросов или размеры ответов) и распределяет их по настраиваемым диапазонам — бакетам. Она также хранит сумму всех зафиксированных значений.
Гистограмма с базовым именем метрики <basename>
при сборе данных экспонирует несколько временных рядов:
- накопительные счётчики для каждого бакета в формате
<basename>_bucket{le="<верхняя граница включительно>"}
- суммарное значение всех зафиксированных измерений —
<basename>_sum
- общее количество зарегистрированных событий —
<basename>_count
(эквивалентно значению<basename>_bucket{le="+Inf"}
, включающему все измерения)
Для расчёта процентилей на основе гистограмм можно использовать функцию histogram_quantile()
.
Гистограммы также подходят для вычисления Apdex-индекса.
При работе с бакетами помните, что значения гистограммы накапливаются (являются кумулятивными).
4. Summary (Резюме)
Аналогично histogram, summary регистрирует отдельные измерения (например, длительности запросов или размеры ответов).
Она сохраняет общее количество событий, сумму всех зафиксированных значений, а также рассчитывает настраиваемые процентильные значения в рамках скользящего временного окна.
Summary с базовым именем метрики <basename>
при сборе данных экспонирует несколько временных рядов:
- Процентильные значения φ, вычисляемые на лету, в формате
<basename>{quantile="<φ>"}
- Сумма всех зафиксированных измерений —
<basename>_sum
- Общее число зарегистрированных событий —
<basename>_count