monitoring-conventions ยท diff
git:20261014.53504f8 to git:20261014.c8129da
2 added, 1 removed. Audit A to A.
What this update changes in the checks
No check changed: every fixed check gives the same answer before and after this update.
A tripped check is a label, not a verdict: read the matched text and the lines below. This week's updates that newly trip a check.
---
name: monitoring-conventions
- description: "Monitoring and alerting conventions: alert on symptoms, prevent alert fatigue, runbooks, health vs readiness checks. Use when editing infrastructure code (CDK, Terraform, serverless config, CI workflows) or adding metrics and alerts."
+ 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.
---
+
# 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 P1 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.