alert-subscribe-copilot

Create, edit, and troubleshoot Nightingale alert subscription rules for event forwarding and escalation.

13.3k|1.8k|Updated Mar 3, 2020
One-click install
npx skills add https://github.com/ccfos/nightingale --skill alert-subscribe-copilot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: alert-subscribe-copilot
Source: https://github.com/ccfos/nightingale/tree/main/aiagent/skill/embedded/builtin/alert-subscribe-copilot
Command: npx skills add https://github.com/ccfos/nightingale --skill alert-subscribe-copilot

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Configuring Nightingale (n9e) alert subscription rules is error-prone: match conditions are AND'd across many gates, the new and old notification versions behave differently, and a misconfigured subscription silently forwards nothing. This Skill guides an AI assistant through creating, editing, and diagnosing alert_subscribe rules so events are correctly cloned and routed to the right notification outlets.

Core Features & Use Cases

  • Subscription creation: Assemble a valid subscription config (severities, tags, busi_groups, for_duration, notify_rule_ids) and persist it via the built-in create_alert_subscribe tool, returning a clickable link to the rule.
  • Proposal-based editing: Apply incremental patches with update_alert_subscribe (disable/enable, adjust escalation thresholds, switch notification outlets) with user confirmation handled by the system.
  • Troubleshooting chain: Diagnose "subscribed but received nothing" by walking the engine's matching gates in order (disabled, datasource, prod, cate, tags, business group name, duration, severity, downstream notification rule).
  • Use Case: A user asks to escalate CPU alerts to a supervisor only after they persist unrecovered for 5 minutes; the Skill builds a subscription with for_duration=300 pointing at the escalation notification rule.

Quick Start

Ask the assistant to create an alert subscription that forwards all Critical alerts to your on-call notification rule in a chosen business group.

Frequently Asked Questions about alert-subscribe-copilot

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

FAQPage Schema
How do I create an alert subscription rule in Nightingale?

Determine the business group with list_busi_groups, pick the notification outlet with list_notify_rules, then call create_alert_subscribe with a config containing severities and notify_rule_ids. The tool returns the rule ID and a URL linking to the edit page.

How do I set up alert escalation in Nightingale after N minutes?

Set the for_duration field (in seconds) on a subscription rule so events are forwarded only after persisting longer than that threshold. The alert rule itself must have repeated notifications configured, otherwise the event never recurs for the escalation to match.

Why is my Nightingale alert subscription not receiving events?

Check the matching gates in order: disabled flag, datasource_ids, prod, cate, AND'd tags, business group name match, for_duration versus elapsed alert time, and severities. If all pass, verify the downstream notification rule referenced by notify_rule_ids is correctly configured.

Does a Nightingale alert subscription replace the original notification?

No. The original event follows its own notification path, and the subscription clones a copy that is forwarded additionally through the subscription's notify_rule_ids. The cloned event's callbacks are cleared by default to avoid re-hitting the original webhooks.

Can a subscription rule rewrite alert severity or notification channels?

Only in the old version (notify_version=0) via redefine_severity and redefine_channels. Under notify_version=1, validation clears those fields, so severity and channel routing must be configured at the notification rule layer instead.

How long does a Nightingale subscription rule change take to take effect?

Changes take effect within at most 9 seconds because the in-memory subscription cache polls on a 9-second cycle. No restart of the Nightingale server is required after creating or updating a rule.