monitoring-conventions · git:20261015.933b000 · 2026-10-15 · sha256 ad7dce6d8539f439
monitoring-conventions git:20261015.933b000A
Immutable. This exact content never changes and is served at /api/v1/blob/ad7dce6d8539f439.
No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_oieyylva2qxvjzqo/ad7dce6d8539f439bf766c3afe2966e306cb7148fe43592d6c9e3145ad7c4145.json
Then /plugin install monitoring-conventions@markdownregistry-oieyylva2qxvjzqo in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.
--- name: monitoring-conventions description: Alert on symptoms, prevent alert fatigue, link runbooks, and separate health from readiness checks. Use when editing infrastructure code (CDK, Terraform, serverless config, CI workflows) or adding metrics and alerts. license: MIT compatibility: "Claude Code; Codex via scripts/install-codex.sh" --- # Monitoring and alerting rules - Alert on SYMPTOMS such as error rate above 1%, p99 above 2 seconds, or a growing queue; do not page on causes such as CPU above 80% or memory use. Causes belong on dashboards. - Prevent alert fatigue. If an alert fires three times without action, tune its threshold or remove it. An ignored alert is worse than no alert. - Every paging alert links to a runbook that says what to inspect, what to restart, and whom to escalate to. Do not add an alert without a runbook. - Separate `/health` for process liveness and load balancers from `/ready` for dependency readiness and orchestration. A health check does not query the database. - Add a new metric or alert in the same change as the feature it observes. Do not defer monitoring to an unspecified later task.