В этой статье поговорим о том, как пользоваться гистограммами в экспортерах Прометея (Jira, Confluence, Bitbucket, Bamboo).
Будем использовать метрику jira_request_duration_on_path в качестве примера, но Вы можете использовать тот же принцип и с другими метриками типа Гистограмма.
Вот как метрика типа Гистограмма выглядит в документации (https://confluence.cprime.io/display/CADS/PE+-+Using+Prometheus+Exporter+for+Jira):
Во втором поле, которое называется Тип, указан тип метрики Гистограмма.
Как пользоваться этой метрикой?
Метрика типа Гистограмма содержит три метрики внутри: count, sum и bucket. Поэтому Вы можете получать информацию по метрике вот так:
- jira_request_duration_on_path_count – Содержит количество событий, которые увеличили метрику. Вот пример:
Посмотрим на метрику, где метка path = “/browse” . Мы можем увидеть, что пользователи 4 раза переходили по пути с browse.
2. jira_request_duration_on_path_sum – сумма значений событий.
Вот пример:
Отсюда видно, что наши 4 перехода по ссылки с путем browse заняли 1.083622161 секунды.
3. jira_request_duration_on_path_bucket – показывает бакеты метрики.
Вот пример:
Метка “le” означает “меньше, чем количество секунд” и показывает какое количество переходов для browse заняло меньше, чем время в метке.
Например, мы видим, что 0 переходов заняли время меньше, чем 0.005 секунды. Но 2 перехода заняли время меньше, чем 0.25 секунды и 4 перехода заняли меньше, чем 0.5 секунды (Эти 4 перехода включают в себя те два перехода, которые выполнялись меньше, чем 0.25 секунды).
Как Вы видите, у нас по бакетам проходит всего 4 перехода и метрика jira_request_duration_on_path_count подтверждает это.