/wheel-of-misfortune

A role-playing game for incident management training

Primary LanguageHTMLMIT LicenseMIT

Wheel of Misfortune

Wheel of Misfortune is a game that aims to build confidence in on-call engineers via simulated outage scenarios. With the game, you practice problem debugging under stress, understanding the incident management protocol, and effective communication with other engineers of your team and organization. It is a great way to train new hires, interns, and seasoned engineers to become well-rounded on-call engineers.

The game is inspired by the Site Reliability Engineering book.

Demo website

Instructions

Terminology

  • Scenario: A past or fictional incident case.
  • Game Master: The host-coordinator of the session.
  • Volunteer: The trainee on-call engineer.

Feel free to fork the repository or download the stable release. Copy the general_incidents.json.sample file to general_incidents.json, inside the incidents/ directory, and insert your incident scenarios into it.

To run the game locally on your computer please navigate the the main directory of the downloaded project i.e. wheel-of-misfortune-5.0/ and from here start a web server i.e. python -m SimpleHTTPServer after that open the http://localhost:8000 using your web browser.

The file has the following format:

  • ID: the unique ID of the outage (you can just auto-increment).
  • title: the title of the incident.
  • scenario: the description of the incident. It is useful to include URLs from monitoring systems, dashboards, time-series databases and playbooks.
  • inkstory: the path to an Ink story file in JSON format.

You can also use general_incidents.jsonnet as an example, in case you want to generate your incident scenarios using Jsonnet.

Ink

Ink is a scripting language for writing interactive narrative stories. It enables us to write interactive incident response narratives for team or individual trainings. You can use Inky to write an interactive narrative for an incident and then export the story as JSON. Then, you can store the story file inside the incidents/ folder and associate the Ink story file with an Incident scenario using the inkstory key. You can read an example incident narrative here.

Role Playing

Game Master

  1. Choose a volunteer to be the primary on-call engineer in front of the group.
  2. Find a balance between the volunteer's experience and the incident's difficulty.
  3. Assist volunteer by answering questions that may arise in each theoretical action or dashboard observation.
  • Engage with the rest of the team and ask for different ways to debug the problem following the volunteer's explanation.
  • Team members may be made available over time for assistance in various topics.
  1. At the end, have a debrief on the learnings of the session.

Volunteer

  1. Spin the wheel and attempt to fix the theoretical outage scenario.
  2. Explain to the Game Master and the rest of the group what actions you would take (lookup queries, checks in dashboards, etc.) to find the root causes, and eventually solve the incident.
  3. Always keep an eye on the time, since it is a simulated incident response scenario and not a routine troubleshooting process. During a real incident, you might have an SLA or SLO breach and therefore you should take timing into account.
  4. Engage with the rest of the group. Keep them in the loop. Ask questions to different members depending on their expertise.

Most importantly, have fun!

You can read a comprehensive example on how to conduct the exercise in the Google SRE book.

Featured

The Wheel of Misfortune was established as a practice in Open Practice Library and this project was featured there.

Resources