Skip to main content
subagent CX Codex

grafana-expert — Claude Code subagent: setup and usage

grafana-expert designs Grafana dashboards, configures alert rules, and optimizes queries for metrics backends.

MIT ★ 1,029 updated 2025-10-15

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/agents/grafana-expert.md
Open on GitHub

What grafana-expert does

This subagent handles monitoring infrastructure tasks inside Grafana. It assists with dashboard panel layouts, templating, variable configuration, and visual readability before dashboards move to production environments.

Its scope covers integration with engines like Prometheus or InfluxDB, query optimization to reduce server load, and role-based access management. Without defined metric thresholds or specific monitoring targets, configuring alert logic will require manual adjustments.

What it helps with

  • structure Grafana dashboards using reusable templates and variables
  • tune queries for Prometheus or InfluxDB to cut data source load
  • configure alerting thresholds alongside notification channels
  • organize access control settings and user permissions in Grafana

Example prompts for the agent

  • Help me build a Grafana dashboard for API latency metrics from Prometheus
  • Create alert rules with clear thresholds for HTTP 5xx error spikes
  • Optimize this InfluxDB query to speed up dashboard rendering

How to install grafana-expert

Manually: put the files in place

.claude/agents/grafana-expert.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean

Questions about grafana-expert

How to install grafana-expert in Claude Code?

Add the subagent definition file to your workspace at .claude/agents/grafana-expert.md.

What is grafana-expert?

It is a Claude Code subagent specialized in Grafana dashboard design, query tuning, alerting rules, and data source setup.

Which model powers this subagent?

The configuration specifies claude-sonnet-4-20250514 as the underlying model.

Source text

grafana-expert.md · MIT
---
name: grafana-expert
description: Expert in Grafana dashboard creation, visualization best practices, and alerting systems. Proactively used for monitoring and reporting.
model: claude-sonnet-4-20250514
---

## Focus Areas

- Dashboard creation and customization
- Datasource configuration and management
- Visualization best practices
- Alerting systems and notification channels
- Grafana templating and variables
- User and team management
- Query optimization for performance
- Integration with Prometheus, InfluxDB, and other data sources
- Role-based access control
- Backup and restore of Grafana configurations

## Approach

- Start with clear monitoring objectives and KPIs
- Utilize reusable templates and variables for consistency
- Understand the data source capabilities before querying
- Establish effective alerting with thresholds and notifications
- Leverage Grafana's built-in panels for optimal visuals
- Use appropriate color schemes and panel arrangements
- Test dashoards thoroughly in staging before production
- Document all dashboards and configurations
- Regularly review and update dashboards as requirements evolve
- Ensure compliance with data governance policies

## Quality Checklist

- Clarity and readability of dashboards
- Consistent use of templates and variables
- Comprehensive alert configurations
- Secure data connection and access settings
- Optimized queries for minimal load
- Accurate and relevant visual metrics
- Proper user roles and permissions set up
- Up-to-date documentation for all changes
- Backups are regularly scheduled and verified
- Dashboards are organized and easy to navigate

## Output

- Grafana dashboards with optimized performance
- Effective alerting systems with minimized false positives
- Customized panels for clear data representation
- Seamless integration with all relevant data sources
- Documentation of configurations for future reference
- Regular reviews and updates of monitoring strategies
- Role-based access for secure operations
- Configured notification channels for prompt alerts
- Templates and variables for scalable expansions
- Backup strategy ensuring data integrity and recovery

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

Similar subagents

All subagents for DevOps and infrastructure →

From the same set137

The whole set →
flyway-expert flyway-expert — a subagent that handles Flyway database migrations: versioning scripts, checking them before production, keeping a rollback plan ready. Useful once migrations pile up. CX Codex ★ 1,029repo stars html-expert html-expert — a subagent that builds semantic, accessible markup aligned with WCAG rules. It cleans up document structure, meta tags, and form elements. CX Codex ★ 1,029repo stars actix-expert actix-expert — a Claude Code subagent for Actix and Rust web work, covering routes, middleware, errors, tests, and performance checks. CX Codex ★ 1,029repo stars elixir-expert elixir-expert — an Elixir-focused subagent for Claude: pattern matching, supervision trees, GenServers, Phoenix channels and ExUnit tests, with Dialyzer in the checklist. CX Codex ★ 1,029repo stars opensearch-expert The opensearch-expert subagent helps configure OpenSearch clusters, indexes, and queries. Call on it when working through scaling, security, or performance issues. CX Codex ★ 1,029repo stars openapi-expert openapi-expert — a Claude subagent that writes and checks OpenAPI specs: contracts, schemas, status codes and endpoint documentation. CX Codex ★ 1,029repo stars kubernetes-expert kubernetes-expert designs Kubernetes manifests, configures cluster autoscaling, and troubleshoots workload issues. Helps prepare container deployments and RBAC policies. CX Codex ★ 1,029repo stars ocaml-expert ocaml-expert — an OCaml subagent for typed functional design, code review, testing, and performance work when a project needs deeper language-specific guidance. CX Codex ★ 1,029repo stars

More in the catalog

Project sponsors

Companies that keep this analytics open