AIKraft/AI/Войти
AIKraft/Skills/promql

promql

Write, validate, and optimize PromQL for Prometheus / Grafana Mimir / Grafana Cloud Metrics. Covers `rate` vs `irate` vs `increase`, label matchers and regex, `sum / avg / topk / by / without` aggregation, classic + native `histogram_quantile`, ratios with divide-by-zero guards, `absent` / `changes` for staleness, time offsets and `predict_linear`, recording-rule naming, SLO + burn-rate math, and

GLGrafana Labs official Другое

Что делает навык

Написание, валидация и оптимизация PromQL-запросов для Prometheus, Grafana Mimir и Grafana Cloud Metrics. Включает работу с агрегацией, гистограммами, защитой от деления на ноль, recording rules и расчетом SLO.

Когда применять

  • Написание запросов для расчета частоты ошибок (error rate) с защитой от деления на ноль
  • Расчет перцентилей задержки (p95) с использованием histogram_quantile
  • Конвертация медленных запросов в панели Grafana в recording rules для оптимизации
  • Валидация синтаксиса и существование метрик/лейблов через API

Как работает

  1. Указать endpoint Prometheus/Mimir/Grafana Cloud и выполнить запрос через curl к /api/v1/query
  2. Проверить существование метрик и лейблов через /api/v1/series, если результат пуст
  3. Убедиться, что для rate/increase используется range vector не менее чем в 4 раза больше scrape interval
  4. Применить агрегацию rate() до sum() и сохранить лейбл le внутри histogram_quantile
  5. Добавить защиту от деления на ноль с помощью конструкции > 0
  6. Создать recording rule для оптимизации сложных или медленных запросов

Примеры запросов агенту

Напиши PromQL для расчета частоты 5xx ошибок по сервисам с защитой от деления на ноль
Проверь синтаксис запроса sum(rate(http_requests_total[5m])) by (service) для Prometheus
Создай recording rule для расчета p95 задержки запросов с интервалом 1m

Что понадобится

  • Доступ к Prometheus / Mimir / Grafana Cloud endpoint (например, http://localhost:9090)
  • Библиотека паттернов PromQL (references/patterns.md)
  • Инструменты curl и jq для валидации запросов

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «promql» из репозитория: # https://github.com/grafana/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r promql/ ~/.claude/skills/promql/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.