incident-bot

Incident management framework centered around a ChatOps bot for Slack to allow your teams to easily and effectively identify and manage technical incidents impacting your cloud infrastructure, your products, or your customers' ability to use your applications and services.

Check out Incident Bot's Documentation

Need support or just want to chat with us? Join us on Discord.

Interacting with the bot is incredibly easy through the use of modals and simplified commands:

Featuring a rich web management UI:

Features at a Glance

• Helps you declare and run incidents - All the automation you'll need to organize, strategize, and explain
  • Create a a war room Slack channel - Create a Slack channel automatically and prepopulate with key information and manage all of your incidents in a centralized digest channel
  • Control from start to finish - Shift the incident through status and severity from a management menu - never leave the channel
• Helps you find the right people to assist - Page teams, automatically add groups or users, and start putting out fires
  • Manage user participation - Invite key users to an incident channel automatically - users can be elected to roles or can claim them
  • Send out internal updates - Keep your internal users up to date via the incident digest channel
• Handles organizing facts, documentation, and evidence - Automatically build a postmortem doc with a timeline, attach evidence, and collect relevant data
• Integrates with your favorite tools
  • Confluence - Automatically format and create a postmortem document in Confluence
  • Jira - Create and associate Issues for your incidents directly from the channel
  • PagerDuty - Automatically invite specific teams to a new incident or page a team at incident creation
  • Statuspage - Create and manage a Statuspage incident directly within the Slack channel
  • Zoom - Create a Zoom meeting for each incident and populate the channel with the link

New features are being added all the time.

Quick Start

• Create a Slack app for this application. You can name it whatever you'd like, but incident-bot seems to make the most sense.
• Select from an app manifest and copy manifest.yaml out of this repository and paste it in to automatically configure the app.
• You'll need the app token, bot token, and user token for your application and provide those as SLACK_APP_TOKEN, SLACK_BOT_TOKEN, and SLACK_USER_TOKEN - these can be found within the app's configuration page in Slack.
• You'll need a Postgres instance to connect to.
• Configure the app using config.yaml and deploy it to Kubernetes, Docker, or whichever platform you choose.

Full setup documentation is available here

You have the option to download source from the latest release and build your own image as well.

Kubernetes

• You can use kustomize. More details available here.
• There's optionally a Helm chart - instructions are available here.

Testing

Tests will run on each pull request and merge to the primary branch. To run them locally:

make -C backend run-tests

Feedback

This application is not meant to solve every problem with regard to incident management. It was created as an open-source alternative to paid solutions that integrate with Slack.

If you encounter issues with functionality or wish to see new features, please open an issue and let us know!