Every alert carries the link to its runbook
At 3am the responder needs to know what this alert means, what to check first, and what to do, in that order, without searching.
annotations:
summary: "checkout p99 above 1.5s for 5m"
runbook: https://wiki.example.com/runbooks/checkout-latencyIf an alert has no runbook, either write one or delete the alert. An alert nobody knows how to act on is noise with a pager attached.
observabilitysre