observability

Investigate metrics, logs, traces, and alerts with read-only triage and gated change controls.

Updated May 11, 2026
One-click install
npx skills add https://github.com/cloudofgeorge/AI-hands-Engineer --skill observability-cloudofgeorge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: observability
Source: https://github.com/cloudofgeorge/AI-hands-Engineer/tree/main/skills/engineering/domains/infrastructure/observability
Command: npx skills add https://github.com/cloudofgeorge/AI-hands-Engineer --skill observability-cloudofgeorge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It prevents unsafe monitoring changes during incidents by enforcing evidence-based, read-only triage of alerts, dashboards, and telemetry before any silence, threshold, or routing mutation is approved. ## Core Features & Use Cases - Read-only alert triage: Correlate alert history, queries, labels, SLI/SLO definitions, deploys, logs, and traces before proposing changes. - Alert quality diagnosis: Handle alert storms, flapping, false positives, missing alerts, and telemetry cost/cardinality issues without removing detection coverage. - Gated change control: Require explicit operator confirmation with target, evidence, risk, diff, verification, and rollback details for any silence, rule, routing, or retention change. - Use Case: During a noisy PagerDuty storm after a deploy, use this Skill to confirm the alert's label set and query history, correlate with the rollout, and propose a narrow time-boxed silence with an owner and expiry instead of blanket muting. ## Quick Start Use the observability skill to triage the firing high-error-rate alert for the payments service and tell me whether a silence is justified.

Frequently Asked Questions about observability

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

FAQPage Schema
How do I triage a noisy or flapping Prometheus alert?

Start read-only: inspect the alert's exact label set, query history, for and keep_firing_for durations, and evaluation intervals, then correlate with deploys and dependency signals. Test any rule change against history and document the detection trade-off before applying it.

How do I safely silence an alert during a maintenance window?

Create a narrow, time-boxed silence with exact matchers, a named owner, an incident or change reference, and an expiry. Confirm it will not hide other services or severities, and never use broad wildcard silences or indefinite mutes.

Does promtool check rules validate my alerting queries?

No, promtool check rules only validates rule file syntax and structure. It does not verify query correctness, alert routing, cardinality, data availability, or the operational effects of reloading a live Prometheus server.

What is the difference between Alertmanager silences, inhibition, and routing?

Silences mute notifications for matching alerts within a time window, inhibition suppresses alerts when another alert is firing, and routing determines which receiver gets a notification. Record which mechanism is operating before changing any of them.

Why is an alert missing even though the service is failing?

Check target and scrape health, rule evaluation state, route and receiver configuration, alert limits, and active silences or inhibition matchers. A missing series or failed scrape can make dashboards look healthy while detection is broken.

When should I not change an alert threshold during an incident?

Never raise a threshold, delete an alert, or disable notifications as a diagnostic shortcut during an active incident. Preserve the detection signal, gather evidence first, and escalate if no safe narrow change can be defined.