# monitoring-observability

A skill for building monitoring and observability: metrics strategy, alerts, dashboards, SLOs and incident troubleshooting.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 493 installs · ★ 203
- Author: ahmedasmar
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ahmedasmar/devops-claude-skills/tree/HEAD/monitoring-observability/skills/SKILL.md
- Updated: 2026-04-11
- HTML: https://affpapa.org/en/nevibecode/skills/monitoring-observability

## What it does

The skill walks a decision tree. Setting up monitoring from scratch starts at metrics strategy design; an existing problem jumps straight to troubleshooting. It lays out the Four Golden Signals, the RED and USE methods, and PromQL snippets for request rate, error ratio and p95 latency. Separate sections cover structured logging, alert design with severity levels and multi-window burn rate, Grafana dashboard generation, and SLOs with error budgets.

Bundled scripts do the repetitive part: `scripts/log_analyzer.py` scans a log file for errors, patterns and stack traces, `scripts/alert_quality_checker.py` audits Prometheus rules for naming, required labels and the `for` clause, and `scripts/dashboard_generator.py` builds dashboard JSON from a template. There are alert templates for web apps and Kubernetes, plus an incident runbook template. Prometheus and CloudWatch queries run from the CLI through `curl` and `aws cloudwatch get-metric-statistics`.

The scripts need Python 3. CloudWatch queries expect a configured AWS CLI, and Prometheus queries need a reachable API endpoint. If you are on Datadog and the bill keeps climbing, the skill has a branch on cost optimization and moving to an open-source stack — worth doing the math on which metrics drive the volume before you migrate.

## Requirements
- Works with: Grafana, Datadog

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add ahmedasmar/devops-claude-skills --skill monitoring-observability -a claude-code
```
```bash
npx skills add ahmedasmar/devops-claude-skills --skill skills -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/skills/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/skills/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add ahmedasmar/devops-claude-skills --skill skills -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/skills/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add ahmedasmar/devops-claude-skills --skill skills -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/skills/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ahmedasmar/devops-claude-skills skills
```

2. **Manually: put the files in place**
- File: `.github/skills/skills/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add ahmedasmar/devops-claude-skills --skill skills -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/ahmedasmar/devops-claude-skills --path monitoring-observability/skills
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/skills/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add ahmedasmar/devops-claude-skills --skill skills -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/ahmedasmar/devops-claude-skills/tree/HEAD/monitoring-observability/skills/SKILL.md

## When to use it
- design a metrics set for a new service
- write an alert on error budget burn
- generate a Grafana dashboard from a template
- scan a log file for errors and stack traces
- calculate an SLO and error budget

## Example prompts
- help me design metrics for a new API using the Four Golden Signals
- run alert_quality_checker against my Prometheus rules
- generate a Grafana dashboard for the payment_api service

## Similar
- [qdrant-monitoring](https://affpapa.org/en/nevibecode/skills/qdrant-qdrant-monitoring.md) — skill · 1500 installs
- [alloy](https://affpapa.org/en/nevibecode/skills/alloy.md) — skill · 5000 installs
- [redis-observability](https://affpapa.org/en/nevibecode/skills/redis-observability.md) — skill · 2300 installs
- [observability-designer](https://affpapa.org/en/nevibecode/skills/observability-designer.md) — skill · 671 installs
- [application-performance-observability-engineer](https://affpapa.org/en/nevibecode/agents/application-performance-observability-engineer.md) — subagent · ★ 41729
- [grafana-dashboard](https://affpapa.org/en/nevibecode/skills/grafana-dashboard.md) — skill · 494 installs

## Other versions with the same name
- [monitoring-observability · akillness](https://affpapa.org/en/nevibecode/skills/akillness-monitoring-observability.md) — 369 installs

From the same set: [ahmedasmar/devops-claude-skills](https://affpapa.org/en/nevibecode/by/ahmedasmar/devops-claude-skills.md) — 2 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md