ShopifyDaniella NiyonkuruExplainer
Implementing ChatOps into our Incident Management Procedure
Summary
Shopify’s incident management process separates coordination from technical remediation: the incident manager on call (IMOC) leads response, while component experts fix production issues and a Support Response Manager handles public communication. The process follows a simplified Incident Command System hierarchy and moves from detection and confirmation through communication, mitigation, verification, documentation, investigation, and root cause analysis. Its ChatOps chatbot, Spy, runs in Slack through Lita and integrates with PagerDuty, StatusPage, and GitHub via webhooks, providing commands for paging, incident startup, status communication, mitigation, and stopping incidents. Spy binds incidents to a shared #war-room, records notes and event times, generates service disruption documents, sends status-page reminders, and can summon the IMOC squad when an incident lasts beyond a specified period. The result is a more consistent response that reduces context switching and post-incident toil while supporting detailed post-mortems.
Context
The post describes Shopify’s incident management roles and workflow, then explains how the Spy chatbot supports IMOCs throughout detection, incident startup, communication, mitigation, stopping, and documentation.
Approach / What changed
Shopify uses a simplified Incident Command System with an IMOC coordinating response, a Support Response Manager handling public communication, and component experts directing technical actions. Spy extends the Slack-based ChatOps workflow through Lita, integrates with PagerDuty, StatusPage, and GitHub via webhooks, binds incidents to war-room channels, automates reminders and documentation, and exposes commands for paging, communication, and mitigation.
Takeaways
The IMOC coordinates communication, escalation, follow-through, and incident progression; component experts, rather than the IMOC, are responsible for fixing production issues.
Spy binds each incident to a #war-room Slack channel, giving responders one place for discussions and visible operational actions such as failover, deploy locks, and traffic rebalancing.
Spy captures war-room notes and event times in service disruption documents, reminds IMOCs about stale status pages, and contacts the IMOC squad to help prevent on-call fatigue.
FAQ
How does Spy keep incident response focused?
When an IMOC starts an incident, Spy binds it to a #war-room Slack channel where discussions and visible actions are centralized. This is intended to prevent independent parallel conversations and confusion about responsibilities.
What does Spy do after an incident is fixed?
After the fix is shipped and verified in production, the IMOC can use spy incident stop. Spy generates a service disruption document, adds notes marked with a notepad emoji or the spy incident note command, and sends the resulting document to the IMOC.
How does Spy support IMOC well-being?
Spy sends reminders when an incident has continued for a while without a status-page update. If the IMOC has handled an incident for a prespecified period, Spy reaches out to the IMOC squad for help.
Source and freshness
- Source
- shopify.engineering
- Published
- Added to Yomu
Summaries are generated from the original by a language model. Check the original before relying on it.
Keep reading
Related reading
The Good Stuff
Paid picks we use ourselves. Links carry a referral code — a subscription through one earns us a commission at no extra cost to you.
The best engineering reads, once a week
One useful email. Unsubscribe anytime.