Overview
Datadog Incident Management integrates with popular collaboration tools, such as Slack, Microsoft Teams, Zoom, Jira, Confluence, ServiceNow, Google Meet, and Google Drive.
To integrate Incident Management with a third-party application, install that application’s integration in the Datadog integrations library.
Then, configure the integration for Incident Management by navigating to Incidents > Settings > Integrations.
Slack
To use Incident Management’s Slack features, you must first install the Slack integration for Datadog.
After you do that, go to Service Management > Incidents > Settings > Integrations to configure the Slack features for Incident Management.
Declaring incidents in Slack
When you connect a Slack workspace to a Datadog organization, users in the workspace can use slash commands and shortcuts related to Incident Management:
/datadog incident declares an incident/datadog incident test declares a test incident (if test incidents are enabled for the incident type)/datadog incident list shows active and stable incidents
Tip: You can start any Datadog slash command in Slack with /dd instead of /datadog.
To allow any Slack user or non-guest Slack user to declare incidents in your Slack workspace, enable “Allow Slack users to declare incidents without a connected Datadog account” in Incident Management settings.
You can also declare incidents directly from a Slack message. To do this, mouse over the Slack message, click the “More actions” button, and then select “Declare incident”. When you declare an incident in this way, Datadog posts a message to the Slack message thread indicating that you declared an incident.
Incident channels
Automatic channel creation
You can configure Incident Management to automatically create an incident Slack for each incident or for incidents meeting criteria you define.
After you enable this automation, you can define a channel name template for Datadog to follow when creating the channel. The following variables are available in channel name templates:
{{public_id}}: Incident’s numeric ID{{title}}: Incident’s title{{created}}: Incident’s creation date in format MM_DD_YYYY{{yyyy}}: Incident’s four-digit creation year{{mm}}: Incident’s two-digit creation month{{dd}}: Incident’s two-digit creation day of month{{random_adjective}}: Random adjective{{random_noun}}: Random noun
Incident commands
You can run the following commands inside the incident Slack channel to manage the incident:
| Command | Description |
|---|
/datadog | Summons the incident action tray, which you can use to perform common actions related to managing the incident |
/datadog incident update | Updates the channel’s incident |
/datadog incident private | Converts the incident to a private incident (if private incidents are enabled for the incident type) |
/datadog incident responders | Allows you to add new responders and manage responder types |
/datadog page | Pages the Datadog On-call team you select |
/datadog task | Creates a new incident task |
/datadog task list | Shows the incident’s tasks |
Tip: You can start any Datadog slash command in Slack with /dd instead of /datadog.
Channel message syncing
You can configure Incident Management to push all incident Slack channel messages to the incident timeline. Alternatively, you can configure it to sync a Slack message only when you add a 📌 reaction to it.
The author of a synced message does not need an Incident Management or Incident Response seat for the message to be recorded. In organizations with usage-based billing for Incident Management, the author is not counted as a monthly active user.
Other incident channel features
You can configure Incident Management to:
- Push incident timeline messages to the incident Slack channel
- Add important links to the incident Slack channel’s bookmarks
- Add team members to the incident channel when a Datadog team is added to the incident
- Send a notification to the Slack channel when a meeting has been started
- Automatically archive an incident Slack channel after the incident is resolved
Other Slack features
Send incident updates to a global channel: You can configure Incident Management to inform a selected channel when an incident’s state, severity, title, or incident commander changes.
To customize this behavior, deactivate this setting and define a notification rule instead.
Microsoft Teams
To use Incident Management’s Microsoft Teams features, you must first install the Microsoft Teams integration for Datadog.
After you do that, go to Service Management > Incidents > Settings > Integrations to configure the Microsoft Teams features for Incident Management.
Declaring and managing incidents in Microsoft Teams
To declare or manage an incident from a specific team:
- Add the Datadog application to the team.
- Add the Datadog tab to any channel in that team.
- From this tab, declare incidents and manage existing ones (for example, update fields, impacts, and responders).
Note: In an incident channel, the tab shows and lets you manage the incident associated with that channel. In other channels, you can only declare new incidents.
Incident channels
Automatic channel creation
You can configure Incident Management to automatically create an incident Microsoft Teams channel for each incident or for incidents meeting criteria you define.
After you enable this automation, you can define a channel name template for Datadog to follow when creating the channel. The following variables are available in channel name templates:
{{public_id}}: Incident’s numeric ID{{title}}: Incident’s title{{created}}: Incident’s creation date in format MM_DD_YYYY{{yyyy}}: Incident’s four-digit creation year{{mm}}: Incident’s two-digit creation month{{dd}}: Incident’s two-digit creation day of month{{random_adjective}}: Random adjective{{random_noun}}: Random noun
Channel message syncing
You can configure Incident Management to push all incident Microsoft Teams channel messages to the incident timeline.
The author of a synced message does not need an Incident Management or Incident Response seat for the message to be recorded. In organizations with usage-based billing for Incident Management, the author is not counted as a monthly active user.
Other incident channel features
You can configure Incident Management to:
- Automatically archive an incident channel after the incident is resolved
Other Microsoft Teams features
Send incident updates to a global channel: You can configure Incident Management to notify a selected channel when an incident’s state, severity, title, or incident commander changes.
To customize this behavior, deactivate this setting and define a notification rule instead.
Other integrations
In addition to integrating with Slack and Microsoft Teams, Incident Management also integrates with:
- PagerDuty and Opsgenie to send incident notifications to your on-call engineers.
- CoScreen to launch collaborative meetings with multi-user screen sharing, remote control, and built-in audio and video chat.
- Jira to create a Jira ticket for an incident.
- Webhooks to send incident notifications using webhooks (for example, sending SMS to Twilio).
- Statuspage to create and update Statuspage incidents.
- ServiceNow to create a ServiceNow ticket for an incident.
- Zoom to create Zoom meetings for an incident.
