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
.claude/agents/grafana-expert.mdWhat 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.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/grafana-expert.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/grafana-expert.mdCursor also reads .claude/agents/
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