# prometheus

Справочник по PromQL, правилам алертов Prometheus и маршрутизации Alertmanager. Помогает генерировать метрики, алерты и правила записи.

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

## Что делает

Скилл содержит шаблоны запросов PromQL: селекторы мгновенных и диапазонных векторов, вычисление темпа через `rate`, агрегации `sum by` и квантили гистограмм. В него входят готовые формулы для расчёта доли ошибок 5xx, утилизации CPU и прогнозирования переполнения диска через функцию `predict_linear`.

Внутри описаны структуры правил алертинга и примеры конфигурации Alertmanager с маршрутизацией на Slack, PagerDuty или почту. Приведены команды проверки синтаксиса через `promtool check rules` и `amtool check-config`.

Для запуска инспекции через Metrics Drilldown без PromQL потребуется Grafana 12 или свежее. Скилл даёт только синтаксис и примеры: сам сервер Prometheus и консольные утилиты `promtool` должны быть уже развёрнуты в системе.

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

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- написать запрос PromQL для вычисления процента ошибок и утилизации ресурсов
- составить конфигурацию алертов для Prometheus и маршрутизацию в Alertmanager
- сформировать recording rules для предварительного расчёта тяжёлых метрик
- проверить корректность файлов правил утилитами promtool и amtool

## Примеры запросов агенту
- Напиши recording rule для вычисления p99 задержки запросов
- Составь правило алерта Prometheus на высокую долю ошибок 5xx с отправкой в Slack
- Как проверить конфигурацию alertmanager.yml с помощью amtool?

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

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

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

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