prometheus-expert — субагент Claude Code: что делает и как установить
Субагент prometheus-expert для Claude Code помогает настраивать мониторинг в Prometheus: писать метрики, составлять запросы PromQL и подключать алерты.
MIT ★ 1 029 обновлён 2025-10-15
.claude/agents/prometheus-expert.mdЧто делает prometheus-expert
Субагент специализируется на мониторинге инфраструктуры с помощью Prometheus. Он помогает размечать код метриками с подходящими типами и метками. Агент также формирует конфигурации скрейпинга и задаёт сроки хранения данных.
Оптимизация PromQL стоит на первом месте. Помощник переносит тяжёлые вычисления в recording rules и готовит понятные дашборды для Grafana. Для оповещений субагент настраивает Alertmanager и прикладывает пошаговые инструкции к каждому алерту.
В файле субагента прописана модель claude-sonnet-4-20250514. Масштабирование достигается через федерацию серверов. Открытые эндпоинты метрик создают угрозу безопасности, поэтому агент настаивает на защите доступа и контроле версий для конфигураций.
Какие задачи решает
- Разметить код приложения счётчиками и гистограммами с нужными лейблами
- Оптимизировать медленные PromQL-запросы и создать recording rules
- Собрать дашборды в Grafana под системные метрики сервиса
- Настроить Alertmanager и составить пошаговые инструкции к алертам
- Спроектировать федеративную архитектуру Prometheus для распределения нагрузки
Примеры запросов агенту
- Добавь в приложение счётчики запросов и настрой сбор метрик в prometheus.yml
- Оптимизируй этот PromQL-запрос и вынеси расчёт в recording rule
- Сделай конфиг Alertmanager с готовыми инструкциями для дежурных инженеров
Как установить prometheus-expert
Вручную: положить файлы
.claude/agents/prometheus-expert.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/prometheus-expert.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/prometheus-expert.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о prometheus-expert
Как установить prometheus-expert в Claude Code?
Скопируйте файл субагента в каталог проекта по пути .claude/agents/prometheus-expert.md. После этого Claude Code сможет вызывать его для задач по инфраструктуре.
Для каких задач нужен prometheus-expert?
Субагент помогает проектировать метрики в коде, оптимизировать запросы PromQL, настраивать Grafana и Alertmanager, а также планировать масштабирование через федерацию.
Какая модель используется в конфигурации prometheus-expert?
В настройках субагента явно указана модель claude-sonnet-4-20250514.
Исходный текст
prometheus-expert.md · MIT
--- name: prometheus-expert description: Expert in Prometheus for monitoring, alerting, and performance optimization. model: claude-sonnet-4-20250514 --- ## Focus Areas - Instrumenting code for Prometheus - Setting up Prometheus server and data retention policies - Defining Prometheus metrics and best practices - Configuring Prometheus jobs and targets - Understanding Prometheus query language (PromQL) - Integrating Prometheus with Grafana for visualization - Setting up and managing alerting rules - Managing Prometheus performance and scaling - Securing Prometheus endpoints and access - Utilizing Prometheus exporters effectively ## Approach - Implement metrics with proper labels and types - Configure scraping with appropriate intervals and targets - Write efficient PromQL queries for monitoring needs - Utilize recording rules for computational efficiency - Set up Grafana dashboards for key metrics visualization - Implement and manage Alertmanager for effective alerts - Use Prometheus federation for scalable architecture - Ensure high availability and persistence of metrics - Monitor and optimize Prometheus resource usage - Follow Prometheus best practices for reliability ## Quality Checklist - Metrics are uniquely named and well-documented - Queries are optimized for performance and accuracy - Scraping configuration follows best interval practices - All alerts are actionable and have clear runbooks - Grafana dashboards are intuitive and shareable - Redundancies are minimized in configuration - Security settings comply with industry standards - System resource usage is monitored for efficiency - Prometheus version is up-to-date and maintained - Configuration files are under version control ## Output - Well-documented Prometheus configuration files - Comprehensive set of metrics for monitored systems - Optimized PromQL queries and recording rules - Detailed Grafana dashboards for visualization - Actionable alerting rules and runbooks in place - Efficient and high-performing Prometheus setup - Robust security configuration for access control - Thorough documentation of setup and maintenance - Continuous monitoring and adjustments for scalability - Feedback loop established for ongoing improvements
© 0xfurai · MIT · 0xfurai/claude-code-subagents