Question

A retail company runs a payment API on Google Kubernetes Engine. During recent incidents, on-call engineers received alerts but wasted valuable time searching wikis and chat threads to find the correct diagnostic steps for each specific alert. The SRE lead wants each Cloud Monitoring alert notification to arrive already containing a direct link to the specific troubleshooting documentation for that alerting condition, without building a custom middleware service. What should the SRE lead do?

Accepted Answer

Add the documentation content and a URL to the alerting policy's Documentation field so the runbook link is included automatically in every notification for that policy.

Answer

Create a Pub/Sub notification channel and write a Cloud Function that appends the relevant runbook URL before forwarding the alert to email.

Answer

Configure a log-based metric that captures the runbook URL as a label and attach it to the alerting policy's threshold condition.

Answer

Store the runbook links in a Cloud Storage bucket and grant on-call engineers Viewer access so they can look them up when an alert fires.