Incident management for Slack (FREE SAAS BETA)
FLAG: On self-managed GitLab, this feature is not available. On GitLab.com, this feature is available. The feature is not ready for production use.
Many teams receive alerts and collaborate in real time during incidents in Slack. Use the GitLab for Slack app to:
- Create GitLab incidents from Slack.
- Receive incident notifications.
Incident management for Slack is only available for GitLab.com. Some of the functionality described might be available for the self-managed Slack app.
To stay up to date, follow epic 1211.
Manage an incident from Slack
Install the GitLab for Slack app. This way, you can use slash commands in Slack to create and update GitLab incidents.
Enable Slack notifications. Be sure to enable notifications for
Incidentevents, and to define a Slack channel to receive the relevant notifications.
Authorize GitLab to take actions on behalf of your Slack user. Each user must do this before they can use any of the incident slash commands.
To start the authorization flow, try executing a non-incident Slack slash command, like
/gitlab <project-alias> issue show <id>. The
<project-alias>you select must be a project that has the GitLab for Slack app set up. For more information, see issue 377548.
After the GitLab for Slack app is configured, you can also use any of the existing Slack slash commands.
Declare an incident
To declare a GitLab incident from Slack:
In Slack, in any channel or DM, enter the
/gitlab incident declareslash command.
From the modal, select the relevant incident details, including:
- The incident title and description.
- The project where the incident should be created.
- The severity of the incident.
If there is an existing incident template for your project, that template is automatically applied to the description text box. The template is applied only if the description text box is empty.
You can also include GitLab quick actions in the description text box. For example, entering
/link https://example.slack.com/archives/123456789 Dedicated Slack channeladds a dedicated Slack channel to the incident you create. For a complete list of quick actions for incidents, see Use GitLab quick actions.
Optional. Add a link to an existing Zoom meeting.
If the incident is successfully created, Slack shows a confirmation notification.
Use GitLab quick actions
Use quick actions in the description text box when creating a GitLab incident from Slack. The following quick actions might be most relevant to you:
/assign @user1 @user2
|Adds an assignee to the GitLab incident.
/label ~label1 ~label2
|Adds labels to the GitLab incident.
/link <URL> <text>
|Adds a link to a dedicated Slack channel, runbook, or any relevant resource to the
Related resources section of an incident.
|Adds a Zoom meeting link to the incident.
Send GitLab incident notifications to Slack
If you have enabled notifications for incidents, you should receive notifications to the selected Slack channel every time an incident is opened, closed, or updated.