How do you keep runbooks useful during real incidents?
I'm a lead SRE at a large global company, and I'm struggling with the state of our runbooks and SOP documentation. Our Confluence pages are often incomplete, brittle,…
runbooks
How do you keep runbooks accurate and useful during incidents?
I'm a lead SRE at a large global company, and our runbooks and SOP documentation are becoming a real operational pain point. Engineers often have to jump back…
How detailed should a technical SOP be?
My manager rejected an SOP I wrote because it didn't include enough detail. I wrote a step like, "Check the log for entries containing 'Out of memory,'" assuming…
How detailed should a technical SOP or runbook be?
My boss rejected an SOP I wrote because it wasn't detailed enough. I documented the action as: check the log for entries containing "Out of memory." He wants…
What’s an effective way to triage service incidents versus infrastructure failures?
I work at a fast-moving startup and have been asked to improve alerting and monitoring for critical P0 infrastructure. The goal is to help engineers quickly determine whether…
What’s an effective way to triage service incidents versus infrastructure failures?
I work at a fast-moving startup and have been asked to improve alerting and monitoring for our critical P0 infrastructure. The goal is to help engineers quickly determine…
How Often Should You Test a Restore Runbook End to End?
A restore document can look correct during review while its commands, credentials, storage paths, dependencies, or recovery assumptions quietly drift. What testing cadence and evidence are enough to…
Feedback on My Disaster Recovery Plan and Runbook Structure
I'm a solo junior SRE responsible for a web application with IoT components. Our infrastructure includes Docker Swarm, Kafka, Redis, and several other clustered services. The servers are…
What workflow actually gets valuable Slack discussions into documentation?
When an important technical conversation happens in Slack—such as an architecture decision, a production debugging session, or an explanation from a senior engineer—how does your team turn it…
Looking for Alternatives to Integrate Azure Runbooks with GitHub for PS 7.4 and Python
Hey everyone! I'm facing a bit of a challenge with Azure Runbooks. The default source control integration from Microsoft only supports PowerShell 5.1, which isn't ideal since we're…
How Can I Use Custom Modules in Azure Automation Accounts?
I've previously worked with Azure Automation Accounts and runbooks on a hybrid worker setup, where it was simple to drop my module folder and .psm1 file into the…
How do you manage source control for your Automation Runbooks?
Hey everyone! I'm regularly working with some pretty complex automation scripts that need at least PowerShell 7.x and certain modules to run smoothly. I'm wondering how you all…