Counter

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

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

Gauge

Gauge (индикатор) — это метрика, представляющая собой одно числовое значение, которое может произвольно увеличиваться или уменьшаться. Обычно индикаторы используются для измерения таких величин, как температура или текущее использование памяти, а также для «подсчетов», которые могут увеличиваться и уменьшаться, например, количество одновременных запросов.

Histogram

Histogram (гистограмма) регистрирует отдельные измерения (например, длительность запросов или размер ответов) и распределяет их по настраиваемым диапазонам — бакетам. Она также хранит сумму всех зафиксированных значений.

Гистограмма с базовым именем метрики <basename> при сборе данных экспонирует несколько временных рядов:

  • накопительные счётчики для каждого бакета в формате <basename>_bucket{le="<верхняя граница включительно>"};
  • суммарное значение всех зафиксированных измерений — <basename>_sum;
  • общее количество зарегистрированных событий — <basename>_count (эквивалентно значению <basename>_bucket{le="+Inf"}, включающему все измерения).

Для расчёта процентилей на основе гистограмм можно использовать функцию histogram_quantile().

Гистограммы также подходят для вычисления Apdex-индекса. При работе с бакетами помните, что значения гистограммы накапливаются (являются кумулятивными).

Summary

Аналогично гистограмме, summary (сводка) регистрирует отдельные измерения (например, длительность запросов или размер ответов).

Метрика сохраняет общее количество событий, сумму всех зафиксированных значений, а также рассчитывает настраиваемые процентильные значения в рамках «скользящего» временного окна.

Сводка с базовым именем метрики <basename> при сборе данных экспонирует несколько временных рядов:

  • процентильные значения φ, вычисляемые на лету, в формате <basename>{quantile="<φ>"};
  • сумма всех зафиксированных измерений — <basename>_sum;
  • общее число зарегистрированных событий — <basename>_count.