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:
- 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.
- Create a Slack app for this application. You can name it whatever you'd like, but
incident-botseems to make the most sense. - Select
from an app manifestand copymanifest.yamlout 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, andSLACK_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.yamland 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.
- You can use kustomize. More details available here.
- There's optionally a Helm chart - instructions are available here.
Tests will run on each pull request and merge to the primary branch. To run them locally:
make -C backend run-testsThis 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!
A pull request template will ask required questions for each pull request. Most importantly, you should make sure to bump all version refs throughout the app. There is a script for this:
./scripts/version-bump.sh 1.4.8 1.4.9Check the current version in the version file for the current version.