Files
nexus/sreweekly/markdown/112/03-runbook-template.md
2026-09-12 17:23:01 +08:00

2.1 KiB
Raw Permalink Blame History

Runbook Template

简介

An excellent template that you can use as a basis for writing runbooks.

正文

A Table of Contents with links to main sections

A quick description of the services. 1 to 2 sentences max. Why does this service matter? What is it's core functionality? What Features does it provide users?

Links to the Dashboards for this service

Links to the Alerts for this service

For Every Alert there should be a corresponding section in alphabetical order

Alert Description: Why do we have this alert? What does it mean? What is typically the cause of this alert?

How does this situation impact our customers? If the customers are not being impacted, this is a good indicator that the alert can be deleted.

Checklist manifesto style steps for how to resolve this alert. A person who has never worked on our stack should be able to follow these steps and remediate the incident. If it cannot be remediated, include escalation steps here.

  1. Do this
  2. Check this graph
  3. Do this thing
  4. Do this other thing
  5. Verify service has recovered

Team contact info. Potentially contact info for who to escalate to. What services do we have dependencies on? How do we escalate to them? Define this information here.

We do Production Change Management Deployments via Jira, we included a link of all the latest changes here. Recent commits, CI log etc... is incredibly helpful in understanding what code is deployed to the system, what recent changes were made.

Information on where this service is deployed, and how to access those machines.

How do you deploy this services. Favor Checklist manifesto style lists here as well.

  1. Do this thing
  2. Do this other thing
  3. Finally do this thing

Instructions on how to do a Canary Deployment

  1. Do this canary thing
  2. another canary task

Instructions on how to Rollback a Deploy.

  1. Get the rollback build here
  2. Do this thing
  3. Do this other thing.