oncall-triage

Triage Grafana OnCall alert groups and acknowledge, silence, or resolve active pages via gcx.

1|Updated May 25, 2020
One-click install
npx skills add https://github.com/titaneric/dotfiles --skill oncall-triage-titaneric
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oncall-triage
Source: https://github.com/titaneric/dotfiles/tree/main/dot_agents/skills/oncall-triage
Command: npx skills add https://github.com/titaneric/dotfiles --skill oncall-triage-titaneric

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When you are on call and something is paging, you need to quickly see what is actively firing in Grafana OnCall, understand each alert group, and take action (acknowledge, silence, resolve) without fumbling through the UI or raw APIs. ## Core Features & Use Cases - List Active Alert Groups: Query firing, acknowledged, and silenced alert groups with filters for team, integration, state, and age, matching the OnCall UI defaults. - Drill Into Details: Inspect a group's severity, labels, timestamps, and pivot links to the Grafana alert rule, dashboard, and SLO for root-cause follow-up. - Take Action Safely: Acknowledge, silence, resolve, or delete alert groups individually or in bulk, with mandatory confirmation for multi-target operations. - Use Case: You get paged at 3 AM and ask "what's firing in OnCall right now?" — the Skill lists active pages, drills into the noisiest group, and silences it for an hour while you investigate the linked dashboard. ## Quick Start Ask the assistant to show what is currently paging in Grafana OnCall and acknowledge the alert group you specify.

Frequently Asked Questions about oncall-triage

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

FAQPage Schema
How do I see what is currently paging in Grafana OnCall?

Run gcx irm oncall alert-groups list to show active alert groups in firing, acknowledged, or silenced state, matching the OnCall UI defaults. Narrow results with --team, --integration, --state, --mine, or --max-age flags.

How do I silence or acknowledge a Grafana OnCall alert group from the CLI?

Use gcx irm oncall alert-groups acknowledge <id> or silence <id> --duration 3600 for a single group. Bulk actions use filter flags instead of an ID and require --yes confirmation when more than one group matches.

What is the difference between OnCall alert groups and Grafana alert rules?

Alert groups are post-routing aggregations of alert deliveries that answer what is paging right now. Alert rules answer why a rule is evaluating to firing; use the investigate-alert skill for rule-side root cause analysis.

Can I filter OnCall alert groups by title or keyword?

There is no built-in title filter. Fetch JSON with gcx irm oncall alert-groups list -o json, filter with jq on the title field, then loop the matching IDs through the desired action verb.

Why does a bulk acknowledge fail in agent mode?

Bulk actions matching more than one alert group require the --yes flag in agent mode as a safety guard. Confirm the filter scope with the user first, then re-run the command with --yes.