# promql

Пишет и проверяет запросы PromQL к Prometheus, Mimir и Grafana Cloud Metrics. Помогает, когда p95 считается неверно или запрос тормозит.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 8000 установок · ★ 290
- Автор: grafana
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/grafana/skills/tree/HEAD/skills/grafana-core/promql/SKILL.md
- Обновлён: 2026-10-25
- HTML: https://affpapa.org/nevibecode/skills/promql

## Что делает

Скилл добавляет агенту библиотеку шаблонов PromQL: `rate` против `irate` и `increase`, матчеры меток и регулярки, агрегации `sum / avg / topk / by / without`, `histogram_quantile` для классических и нативных гистограмм, отношения с защитой от деления на ноль, `absent` и `changes` для устаревших серий, смещения по времени и `predict_linear`, именование recording-правил, математика SLO и burn-rate. Отдельный раздел — поиск метки, из-за которой раздулась кардинальность.

Работает по шагам. Сначала вы формулируете выражение, потом агент проверяет синтаксис и наличие метрики через `/api/v1/query` и `/api/v1/series`, а величину сверяет в Grafana Explore с известным эталоном. Медленную панель дашборда можно превратить в recording-rule: выражение получает имя вида `job:http_request_duration_p95:rate5m`, правило загружается, новая метрика проверяется тем же запросом, и только потом панель переключается на неё.

Главная ловушка PromQL — окно. `rate()` и `increase()` требуют range vector не меньше четырёх интервалов сбора; при сборе раз в 60 секунд берите `[5m]` как минимум. Если окно меньше, вы получите «No data» и будете искать ошибку в метках, а не в окне. Ещё нужен доступ к эндпоинту Prometheus, Mimir или Grafana Cloud; для Grafana Cloud в каждый `curl` добавляется basic auth.

## Требования
- Работает с: Grafana

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add grafana/skills --skill promql -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/promql/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/promql/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add grafana/skills --skill promql -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/promql/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add grafana/skills --skill promql -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/promql/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install grafana/skills promql
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/promql/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add grafana/skills --skill promql -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/grafana/skills --path skills/grafana-core/promql
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/promql/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add grafana/skills --skill promql -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/grafana/skills/tree/HEAD/skills/grafana-core/promql/SKILL.md

## Когда брать
- посчитать долю 5xx по сервисам
- починить p95, который считается неверно
- собрать алерт по error budget
- найти метку, раздувшую кардинальность
- перевести медленный запрос дашборда в recording-rule

## Примеры запросов агенту
- посчитай error rate по сервисам за 5 минут
- почему этот запрос тормозит и что заполняет Mimir
- сделай recording-rule из этого выражения для p95

## Похожие
- [promql-cli](https://affpapa.org/nevibecode/skills/promql-cli.md) — скилл · 4400 установок
- [prometheus-grafana](https://affpapa.org/nevibecode/skills/prometheus-grafana.md) — скилл · 449 установок
- [promql-generator](https://affpapa.org/nevibecode/skills/promql-generator.md) — скилл · 615 установок
- [grafana-dashboards](https://affpapa.org/nevibecode/skills/grafana-dashboards.md) — скилл · 13097 установок
- [qdrant-monitoring](https://affpapa.org/nevibecode/skills/qdrant-qdrant-monitoring.md) — скилл · 1500 установок
- [grafana-dashboard](https://affpapa.org/nevibecode/skills/grafana-dashboard.md) — скилл · 494 установки

Из того же набора: [grafana/skills](https://affpapa.org/nevibecode/by/grafana/skills.md) — 47 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md