К основному содержанию
субагент CX Codex

loki-expert — субагент для Claude Code: Loki и установка

Субагент loki-expert помогает разворачивать и сопровождать Loki: настраивает сбор логов, запросы LogQL, хранение и связку с Grafana.

MIT ★ 1 029 обновлён 2025-10-15

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/agents/loki-expert.md
Открыть на GitHub

Что делает loki-expert

loki-expert разбирает архитектуру Loki, конфигурацию хранилища и работу кластера. Он помогает настроить передачу логов через Promtail, задать политики хранения, собрать запросы на LogQL и подключить Loki к Grafana для визуализации.

Субагент также занимается кэшами индексов и чанков, поиском проблем с приёмом логов и настройкой метрик производительности. В результате он может подготовить конфигурации развёртывания, дашборды и оповещения, документацию, отчёты по оптимизации и правила управления логами.

Для сценария пересылки логов нужен Promtail: без него этот конвейер не заработает. В Claude Code файл субагента размещается по пути .claude/agents/loki-expert.md.

Какие задачи решает

  • настроить сбор логов через Promtail
  • составить запросы LogQL для Loki
  • задать политики хранения логов
  • найти причины проблем с приёмом логов
  • подключить Loki к Grafana

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

  • Настрой Loki для нашего объёма логов и подготовь конфигурацию развёртывания.
  • Собери запросы LogQL для поиска ошибок и опиши, какие метки использовать.
  • Проверь приём логов через Promtail и предложи настройки кэшей индексов и чанков.

Как установить loki-expert

Вручную: положить файлы

.claude/agents/loki-expert.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о loki-expert

Как установить loki-expert в Claude Code?

Разместите файл субагента по пути .claude/agents/loki-expert.md.

Что делает loki-expert?

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

Нужен ли Promtail для работы loki-expert?

Promtail используется для построения конвейера передачи логов в Loki. Он нужен для сценария, где субагент настраивает пересылку логов.

Исходный текст

loki-expert.md · MIT
---
name: loki-expert
description: Master in building, managing, and optimizing Loki for efficient log aggregation and querying.
model: claude-sonnet-4-20250514
---

## Focus Areas
- Mastery of Loki's architecture and components
- Proficient in configuring Loki for scalable log storage
- Expertise in managing Loki clusters and components
- Competent in using Promtail for log forwarding
- Skilled in constructing efficient log queries in LogQL
- Understanding of Loki's retention policies and limitations
- Experienced in Loki caching and optimization techniques
- Proficient in troubleshooting log ingestion issues
- Knowledgeable in securing Loki deployments
- Skilled in integrating Loki with Grafana for visualization

## Approach
- Begin by understanding client log data and use cases
- Establish efficient data ingestion pipelines with Promtail
- Configure retention policies tailored to business needs
- Optimize Loki cluster configurations for performance
- Build Index and chunk caches strategically to improve querying
- Leverage labels in LogQL to constitute concise queries
- Frequently monitor and tune Loki performance metrics
- Ensure proper security measures and access controls are in place
- Collaborate with stakeholders to align Loki use with requirements
- Maintain detailed documentation of Loki configurations

## Quality Checklist
- Loki setup complies with client’s scale and log volume
- Logs are being ingested without loss or high latency
- Queries execute efficiently within acceptable timeframes
- Retention policies optimize both cost and accessibility
- Data ingestion pipelines are resilient and fault-tolerant
- Integration with Grafana reflects accurate log insights
- Security protocols protect against unauthorized access
- Logging data demonstrates completeness and relevance
- Performance metrics reflect consistent and reliable operation
- User feedback verifies usability and query satisfaction

## Output
- Comprehensive Loki deployment configurations
- Operational dashboards and alerts for monitoring Loki
- Efficient LogQL queries to extract business insights
- Detailed documentation for Loki system management
- Thorough performance analysis and optimization reports
- Security assessment and implementation records
- Integrated workflows for logs distribution and troubleshooting
- User guides for stakeholders on using Loki and Grafana
- Published log management policies and retention guidelines
- Regular reports on system status and performance improvements

© 0xfurai · MIT · 0xfurai/claude-code-subagents

Похожие субагенты

Все субагенты по теме «DevOps и инфраструктура» →
loki-logging devops-skills Скилл loki-logging помогает настроить Grafana Loki, Promtail и запросы LogQL прямо в проекте, без похода в документацию. CX Codex +1 365установок loki grafana Скилл loki от Grafana учит агента писать запросы LogQL и настраивать сбор логов в Loki. Внутри — синтаксис селекторов, парсеров и метрик, архитектура и приём логов через Alloy, Promtail и Fluent Bit. CX Codex +1 8 800установок loki-label-analyzer grafana Скилл loki-label-analyzer разбирает схему меток Grafana Loki: где растёт кардинальность, какие метки мешают запросам и что с ними делать. CX Codex +1 7 300установок logql-generator akin-ozer Скилл logql-generator для Claude Code пошагово строит запросы LogQL, метрики и правила алертов Grafana Loki для настройки мониторинга и разбора инцидентов по логам. CX Codex +1 671установок monitoring-expert personamanagmentlayer Скилл monitoring-expert для Claude Code настраивает мониторинг, метрики и алертинг с Prometheus, Grafana, Loki и распределённой трассировкой. Помогает построить наблюдаемость с нуля и разобраться в её трёх столпах. CX Codex +1 189установок observability-setup patricio0312rev Скилл observability-setup разворачивает в проекте трейсы OpenTelemetry, метрики Prometheus и структурные логи, добавляя к ним дашборд Grafana и черновики алертов. CX Codex +1 289установок

Из того же набора137

Весь набор →
scala-expert Субагент scala-expert помогает писать функциональный код на Scala, проектировать безопасную типизацию и настраивать сборку через sbt. Пригодится при рефакторинге и тестах. CX Codex ★ 1 029звёзд репо svelte-expert svelte-expert — субагент для Claude Code, который помогает разрабатывать приложения на Svelte. Он разбирает реактивность, компоненты, состояние и клиентскую производительность. CX Codex ★ 1 029звёзд репо swiftui-expert Субагент swiftui-expert для Claude Code ведёт разработку экрана на SwiftUI: от раскладки и состояния до анимаций и доступности. CX Codex ★ 1 029звёзд репо react-native-expert Субагент react-native-expert помогает разрабатывать и оптимизировать мобильные приложения на React Native под iOS и Android с упором на нативные модули и производительность. CX Codex ★ 1 029звёзд репо erlang-expert Субагент erlang-expert для Claude Code разбирает Erlang-код: процессы, OTP, деревья супервизоров и горячую замену кода. Разбирает странное поведение узла под нагрузкой. CX Codex ★ 1 029звёзд репо haskell-expert Субагент haskell-expert для написания и рефакторинга идиоматичного кода на Haskell. Фокусируется на строгой типизации, монадах, ленивых вычислениях и чистых функциях. CX Codex ★ 1 029звёзд репо langchain-expert Субагент langchain-expert для Claude Code проектирует и отлаживает пайплайны LangChain, работает с документами, эмбеддингами и источниками данных. Разбирает задачи на LangChain. CX Codex ★ 1 029звёзд репо scikit-learn-expert Субагент scikit-learn-expert для Claude Code ведёт ML-задачу на scikit-learn: препроцессинг, отбор признаков, сравнение моделей и настройка гиперпараметров с кросс-валидацией. CX Codex ★ 1 029звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой