investigate-alert

Analyze Grafana alert state and query datasources to diagnose firing or pending alerts.

535|42|Updated Mar 23, 2026

Search Tags:#debugging #monitoring #troubleshooting #observability #alerts #grafana #investigate

Ready to run

npx skills add https://github.com/grafana/gcx --skill investigate-alert-grafana

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: investigate-alert
Source: https://github.com/grafana/gcx/tree/main/claude-plugin/skills/investigate-alert
Command: npx skills add https://github.com/grafana/gcx --skill investigate-alert-grafana

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Grafana alerts can be complex to interpret; this skill helps operators quickly determine why an alert is firing or pending, its scope, and impact.

Core Features & Use Cases

Analyze alert state (firing or pending) and correlate with dashboards and queries.
Propose actionable next steps and potential runbooks for remediation.
Assist operators in debugging alert behavior and root-cause analysis.

Quick Start

Describe the alert you want to investigate and gcx will fetch its current state and suggested next steps.

Frequently Asked Questions about investigate-alert

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I diagnose why a Grafana alert is firing or pending?▼

Diagnosing a Grafana alert involves analyzing its firing or pending state, querying datasources, and correlating dashboards to identify root causes and next steps.

What is the best way to troubleshoot Grafana alert behavior?▼

Troubleshooting Grafana alert behavior requires analyzing alert states and correlating them with dashboards and queries to propose remediation steps and runbooks.

Do I need gcx configured to investigate Grafana alerts?▼

Yes, you need gcx installed with configured context and permissions to investigate Grafana alerts; if not configured, you must run setup-gcx first.

Can I get suggested remediation runbooks for a firing Grafana alert?▼

Yes, investigating a Grafana alert provides actionable next steps and potential runbooks for remediation by correlating alert states with queried datasource data.

What should I do if my Grafana alert investigation is not working?▼

If Grafana alert investigation is not working, verify gcx is installed and configured with proper context and permissions, as the skill depends on querying datasources through gcx.