# loki-logging

Скилл помогает настроить Grafana Loki, Promtail и запросы LogQL прямо в проекте, без похода в документацию.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 330 установок · ★ 1177
- Автор: devops-skills
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/BagelHole/DevOps-Security-Agent-Skills/tree/HEAD/devops/observability/loki-logging/SKILL.md
- Обновлён: 2026-05-22
- HTML: https://affpapa.org/nevibecode/skills/loki-logging

## Что делает

Скилл описывает сборку логов на Grafana Loki: развёртывание через Docker Compose, конфигурацию самого Loki, настройку Promtail как агента сбора и подключение Grafana для просмотра. Внутри есть готовые файлы `docker-compose.yml`, `loki-config.yaml` и `promtail-config.yaml`, а также примеры манифестов для Kubernetes и установка через Helm-чарт `loki-stack`.

Отдельный блок посвящён LogQL: базовые селекторы по меткам, фильтры по содержимому строк, разбор JSON, метрические запросы вроде `rate` и `count_over_time`, агрегации с `quantile_over_time` и `topk`. Пайплайны Promtail разбирают JSON, вытаскивают поля регуляркой и превращают их в метки.

Чтобы это заработало, нужен Docker или Kubernetes, Grafana для визуализации и Promtail либо другой отправитель логов. Конфигурация Loki в примере держит данные на файловой системе с retention 168h — для продакшена это повод проверить хранилище и ретеншн под свои объёмы.

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

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add BagelHole/DevOps-Security-Agent-Skills --skill loki-logging -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add BagelHole/DevOps-Security-Agent-Skills --skill loki-logging -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add BagelHole/DevOps-Security-Agent-Skills --skill loki-logging -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install BagelHole/DevOps-Security-Agent-Skills loki-logging
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add BagelHole/DevOps-Security-Agent-Skills --skill loki-logging -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/BagelHole/DevOps-Security-Agent-Skills --path devops/observability/loki-logging
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add BagelHole/DevOps-Security-Agent-Skills --skill loki-logging -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/BagelHole/DevOps-Security-Agent-Skills/tree/HEAD/devops/observability/loki-logging/SKILL.md

## Когда брать
- поднять Loki и Promtail через Docker Compose
- написать запрос LogQL для подсчёта ошибок по сервисам
- настроить сбор логов контейнеров Docker с метками
- развернуть стек логирования в Kubernetes через Helm
- разобрать JSON-логи приложений и вынести уровень в метку

## Примеры запросов агенту
- Настрой сбор логов в Kubernetes через Loki и Promtail
- Напиши LogQL-запрос, который покажет долю ошибок за последние 5 минут
- Добавь в пайплайн Promtail разбор JSON и метку level

## Похожие
- [loki](https://affpapa.org/nevibecode/skills/loki.md) — скилл · 7500 установок
- [loki-label-analyzer](https://affpapa.org/nevibecode/skills/loki-label-analyzer.md) — скилл · 6300 установок
- [logql-generator](https://affpapa.org/nevibecode/skills/logql-generator.md) — скилл · 597 установок
- [qdrant-monitoring](https://affpapa.org/nevibecode/skills/qdrant-qdrant-monitoring.md) — скилл · 1500 установок
- [grafana-dashboard](https://affpapa.org/nevibecode/skills/grafana-dashboard.md) — скилл · 494 установки
- [monitor-setup](https://affpapa.org/nevibecode/commands/monitor-setup.md) — команда · ★ 41729

Из того же набора: [bagelhole/devops-security-agent-skills](https://affpapa.org/nevibecode/by/bagelhole/devops-security-agent-skills.md) — 127 карточек

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

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