Counter, gauge, histogram, summary: какой тип метрики выбрать под задачу

Типов всего четыре, и путаница между ними — самая частая причина неверных графиков. Counter только растёт и обнуляется при рестарте процесса; сырое значение счётчика бессмысленно, его всегда оборачивают в rate(). Gauge — мгновенное значение, которое может расти и падать: занятая память, длина очереди, число активных соединений; к нему применяют avg_over_time и max_over_time, но не rate(). Histogram раскладывает наблюдения по заранее заданным корзинам и отдаёт три серии — _bucket с меткой le, _sum и _count; перцентиль считается на сервере функцией histogram_quantile, поэтому гистограммы разных инстансов можно складывать. Summary считает перцентили прямо в приложении и отдаёт готовыми — дёшево по кардинальности, но складывать перцентили нескольких реплик математически нельзя. Практическое правило: для задержек берите histogram, summary — только если корзины подобрать невозможно.