# logql-generator

Пошагово строит запросы LogQL, метрики и правила алертов для Grafana Loki. Пригодится при настройке мониторинга и разборе инцидентов по логам.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 597 установок · ★ 327
- Автор: akin-ozer
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/akin-ozer/cc-devops-skills/tree/HEAD/devops-skills-plugin/skills/logql-generator/SKILL.md
- Обновлён: 2026-07-26
- HTML: https://affpapa.org/nevibecode/skills/logql-generator

## Что делает

Скилл ведёт через восемь этапов формирования запроса к Grafana Loki. Сначала он выясняет цель, формат логов (JSON, logfmt или plain text) и селекторы потоков. Затем проверяет версии Loki и Grafana. Если версия неизвестна, скилл по умолчанию собирает совместимый запрос и не использует операторы вроде `|>`, `!>` или `approx_topk`.

Перед генерацией сложных выражений скилл блокирует ответ и сверяется с локальными файлами `examples/common_queries.logql` и `references/best_practices.md`. При их отсутствии результат помечается как непроверенный. При нехватке документации запускается поиск. Готовый запрос выводится сразу либо разбирается по шагам с фильтрами и агрегациями.

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

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add akin-ozer/cc-devops-skills --skill logql-generator -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add akin-ozer/cc-devops-skills --skill logql-generator -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add akin-ozer/cc-devops-skills --skill logql-generator -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install akin-ozer/cc-devops-skills logql-generator
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add akin-ozer/cc-devops-skills --skill logql-generator -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/akin-ozer/cc-devops-skills --path devops-skills-plugin/skills/logql-generator
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add akin-ozer/cc-devops-skills --skill logql-generator -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/akin-ozer/cc-devops-skills/tree/HEAD/devops-skills-plugin/skills/logql-generator/SKILL.md

## Когда брать
- составить LogQL-запрос для расчёта доли ошибок сервиса
- собрать метрику для графика на дашборде Grafana
- настроить правило алерта по логам с агрегацией по времени
- разобрать структурированные логи через парсеры json или logfmt

## Примеры запросов агенту
- Напиши LogQL-запрос для расчёта доли ошибок по сервисам за 15 минут
- Помоги составить запрос для алерта в Loki по кодам ответа 500
- Построй пошаговый LogQL-запрос с парсингом JSON для поиска таймаутов

## Похожие
- [loki](https://affpapa.org/nevibecode/skills/loki.md) — скилл · 7500 установок
- [loki-logging](https://affpapa.org/nevibecode/skills/loki-logging.md) — скилл · 330 установок
- [loki-label-analyzer](https://affpapa.org/nevibecode/skills/loki-label-analyzer.md) — скилл · 6300 установок
- [dashboard-builder](https://affpapa.org/nevibecode/skills/dashboard-builder.md) — скилл · 4800 установок
- [qdrant-monitoring](https://affpapa.org/nevibecode/skills/qdrant-qdrant-monitoring.md) — скилл · 1500 установок
- [observability-designer](https://affpapa.org/nevibecode/skills/observability-designer.md) — скилл · 671 установка

Из того же набора: [akin-ozer/cc-devops-skills](https://affpapa.org/nevibecode/by/akin-ozer/cc-devops-skills.md) — 29 карточек

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

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