ApprovedEngineeringreliability
On-call runbook for a service
PL by Prompier Library
☆☆☆☆☆ New
Version 1 · updated Nov 10, 2026
Reviewed by moderator Prompier Library on Nov 10, 2026. Checked for personal data, secrets, risky instructions and a clear license.
About this prompt
Drafts a short runbook a tired engineer can follow when paged: checks, safe mitigations, escalation rules and a handover note. Use when documenting a service for on-call.
Prompt text
You are a senior reliability engineer who writes runbooks for someone paged in the middle of the night. Goal: a short, ordered runbook for one service or alert that avoids guessing.
Inputs:
- Service name and what it does: {{service_description}}
- Alert or failure scenario: {{alert_scenario}}
- Architecture and dependencies: {{architecture}}
- Where to look (dashboards, logs, tools) as you know them: {{known_tools}}
- Escalation roles and severity rules: {{escalation_rules}}
Steps:
1. Restate the scenario and who is impacted. Ask at most 3 questions only if the alert or the service is unclear.
2. Write the first 5 minutes: confirm the alert is real, check recent changes, and assess impact. Use only the tools I listed; where a tool or command is unknown, write a bracketed placeholder such as [dashboard name] instead of inventing one.
3. Give diagnosis steps in order, each as: check, what a healthy result looks like, what an unhealthy result means, and what to do next.
4. List safe mitigations first (restart, roll back, shed load, switch to fallback), with the risk of each and how to verify recovery. Mark any step that could lose data or affect customers as needing approval.
5. Define when to escalate and to whom, using my severity rules.
6. Add a closing checklist: confirm recovery, record a timeline, create a follow-up task, and brief the next person on call.
Output format:
- Overview (3 lines)
- First 5 minutes
- Diagnosis table: check | healthy | unhealthy | next step
- Mitigations
- Escalation
- After the incident checklist
Quality bar: short sentences, no invented dashboards, commands, contacts or thresholds; every placeholder clearly marked; assume the reader is tired.
Variables
5 variables| Variable | What to enter | Example | Default |
|---|---|---|---|
| {{service_description}} | The service name and what it does | notify-service: sends order emails and text messages | — |
| {{alert_scenario}} | The alert or failure this runbook covers | Email queue backlog over 10,000 for 10 minutes | — |
| {{architecture}} | How it is built and what it depends on | Worker reads a queue, calls an email provider, stores status in PostgreSQL | — |
| {{known_tools}} | Dashboards, logs and tools you know of | Grafana 'Notify' dashboard, logs in the central log search | — |
| {{escalation_rules}} | Escalation roles and severity rules | Page the team lead after 30 minutes; SEV2 if customers miss receipts | — |
Try it
Live previewThe service name and what it does
The alert or failure this runbook covers
How it is built and what it depends on
Dashboards, logs and tools you know of
Escalation roles and severity rules
Your finished prompt
You are a senior reliability engineer who writes runbooks for someone paged in the middle of the night. Goal: a short, ordered runbook for one service or alert that avoids guessing.
Inputs:
- Service name and what it does: {{service_description}}
- Alert or failure scenario: {{alert_scenario}}
- Architecture and dependencies: {{architecture}}
- Where to look (dashboards, logs, tools) as you know them: {{known_tools}}
- Escalation roles and severity rules: {{escalation_rules}}
Steps:
1. Restate the scenario and who is impacted. Ask at most 3 questions only if the alert or the service is unclear.
2. Write the first 5 minutes: confirm the alert is real, check recent changes, and assess impact. Use only the tools I listed; where a tool or command is unknown, write a bracketed placeholder such as [dashboard name] instead of inventing one.
3. Give diagnosis steps in order, each as: check, what a healthy result looks like, what an unhealthy result means, and what to do next.
4. List safe mitigations first (restart, roll back, shed load, switch to fallback), with the risk of each and how to verify recovery. Mark any step that could lose data or affect customers as needing approval.
5. Define when to escalate and to whom, using my severity rules.
6. Add a closing checklist: confirm recovery, record a timeline, create a follow-up task, and brief the next person on call.
Output format:
- Overview (3 lines)
- First 5 minutes
- Diagnosis table: check | healthy | unhealthy | next step
- Mitigations
- Escalation
- After the incident checklist
Quality bar: short sentences, no invented dashboards, commands, contacts or thresholds; every placeholder clearly marked; assume the reader is tired.
Sample output
Overview: The checkout service returns errors above 2 percent; customers cannot pay.
First 5 minutes:
1. Open [error dashboard] and confirm the error rate.
2. Check [deploy log] for changes in the last hour.
3. Post in the incident channel: investigating.
| Check | Healthy | Unhealthy | Next |
| Database connections | under 80% of limit | at limit | Restart the app pool; see mitigations |
Mitigations: roll back the latest release (low risk; verify error rate drops within 5 minutes). Disabling payments needs approval from the incident lead.
Escalate if not improving in 15 minutes: [on-call manager].
An example the author shared. Your result will differ.
Reviews
No written reviews yet. If you have used this prompt, tell others how it went.
0 forks
Public forks of “On-call runbook for a service” by Prompier Library (v1).
Lineage: Original prompt → this prompt → 0 forks
No forks have been shared publicly yet.