Перейти к содержанию

Шпаргалка PromQL


PromQL — язык запросов для Prometheus и Mimir. Вся книга вращается вокруг этих запросов.


Базовые операторы

rate(http_requests_total[5m])

Количество запросов в секунду (производная за интервал).


Агрегации

sum(rate(http_requests_total[5m]))
count(my_metric)
avg(my_metric)
min(my_metric)
max(my_metric)

Суммирование, подсчёт, среднее, минимум, максимум.


Группировка (by / without)

sum by(instance) (rate(http_total[5m]))
sum without(endpoint) (rate(node_disk_io_time_seconds_total[5m])))

— группировка по указанным лейблам (by) или по всем, кроме указанных (without).


Квантили гистограммы

histogram_quantile(0.9, rate(request_duration_seconds_buckets[5m]))

— p90 (90-й процентиль) задержки ответа.


Абсолютный прирост за интервал

increase(http_requests_total[24h])

Абсолютное число запросов за 24 часа.


Смещение по времени (offset)

http_requests_total offset 1d
http_requests_total[1w] offset 1w
rate(http_requests_total[5m]) - (rate(http_requests_total[5m]) offset 1w)

— сравнение с тем же периодом неделю назад.


Макросы Grafana

Макрос Описание
$__interval Шаг между точками данных
$__range Полный временной диапазон
$__rate_interval Оптимальный интервал для rate()



Далее: Шпаргалка LogQL