Connect Slack to Datadog in order to help your team collaborate by:
If you are using the US1, US3, US5, or EU1 Datadog site, install the Datadog Slack app in your Slack workspace:
Navigate to the Slack integration tile under Integrations on the Datadog site. Click the Connect Slack Account button at the bottom of the tile.
Confirm your Slack and Datadog accounts are connected. Note: You may need your Datadog workspace admin to approve this change one time.
Note: The Slack App Directory Slack integration works only if you are using the US1, US3, US5, or EU1 Datadog site. For other regions, see the Slack Webhook documentation.
Once the app has been installed, you can invite the Slack app to any channel:
/invite @Datadog
Then, connect your Datadog account to your Slack account:
/datadog accounts
Additional functionality allows you to bring parts of Datadog into Slack with a command.
/datadog dashboard
You can also copy and paste any widget from Datadog to Slack, using CMD + C or CTRL + C, or clicking the expand icon on top of a widget, and clicking “copy”. When you paste, a link displays that unfurls as the widget once sent to the channel.
You can mute triggering monitors in Slack with the click of a button.
There are two ways you can update your monitors to be sent from the Slack app:
Bulk Update: You can bulk update all of your monitors to be sent from the Slack App, and include the muting buttons by clicking the “Upgrade” button at the top of the configuration for each of your Slack accounts in the integration tile in Datadog.
Manual: If you’d like to test this functionality before rolling it out to all of your teams, you can manually add the channels to the new app account configuration in the Slack integration configuration. Note: You may need to remove duplicate references to the same channels.
Declare a new incident from the Slack App with:
/datadog incident
Note: Anyone in your Slack org can declare an incident, regardless of whether they have access to Datadog.
When a new incident is created, a corresponding Slack channel #incident-(unique number ID) is created, and a message is sent to the channel telling you the new incident channel to use. The channel topic changes with the incident.
Update the incident state (e.g. severity) with:
/datadog incident update
List all open (active and stable) incidents with:
/datadog incident lists
Use the message actions command (three dots you can find after hovering over a message sent in an #incident channel on the far right) to send the message to the Incident App Timeline.
Using an incident updates channel provides your team with organization-wide visibility into the status of all incidents directly from your Slack workspace. Select which channel in your workspace to post these updates to, and the channel receives the following posts:
Once the Slack app has been installed, you can navigate to the Incident Settings page. From this, you can scroll down to the Incident Updates Channel section and begin the set-up flow.
After entering the Slack app, set the channel for your incident updates.
How to set up this channel:
By using Slack Actions and the /datadog Slack commands, you are able to create and manage incident tasks directly from Slack. Incident task commands must be used in an incident channel.
Slack Actions: You can create tasks using Slack Actions by hovering over any message sent in an incident channel. On hover, three dots appear to the right of the message, allowing you to “Add Task to Incident”.
Available commands:
/datadog task creates a task for the incident. You are provided with a modal to include a description of the task, assign teammates, and set a due date./datadog task list shows a list of all tasks created for the incident. Use this list to mark tasks as complete or reopen them.All tasks created can be managed in the ‘Remediation’ tab under “Incident Tasks” in the Incidents UI. See the Incident Management documentation for more information.
Use the Slack Webhook if you are using the US5 or US1-FED Datadog site.
The Slack integration is installed using its integration tile on the Datadog site.
@slack-<ACCOUNT_NAME>-<CHANNEL_NAME> syntax in order for comments to be posted to Slack. You may use @slack-<CHANNEL_NAME> if you are only using one account or referring to the first account.You can also configure sending alerts to Slack from monitors and the event stream.
@-mentions in Slack from monitor alertAfter setting up the Slack integration, type @slack in your notification message to see the available list of channels to send your notification to.
Wrap the @username in < > in your monitor’s message template to @-notify the defined user within Slack notifications. For example: @slack-SLACK_CHANNEL <@USERNAME>, or @slack-SLACK_ACCOUNT-SLACK_CHANNEL <@USERNAME>.
Note: If you are having trouble pinging someone, use their Slack username instead of the display name. The username is located in Slack account settings under Username.
Mention @here or @channel by using <!here> or <!channel>, respectively.
For user groups, use <!subteam^GROUP_ID>. To find the GROUP_ID, query the usergroups.list API endpoint of Slack. For example, for a user group with an ID of 12345 you would use the following syntax:
<!subteam^12345>
Use the same rules, template variables, tags, and conditionals, as standard Datadog Notifications. For example, this notification pings a subteam in a Slack channel called infrastructure when renotifying:
CPU usage has exceeded {{warn_threshold}} on {{ @machine_id.name }}.
{{#is_renotify}}
Notifying @slack-infrastructure <!subteam^12345>
{{/is_renotify}}
Note: Trailing special characters in a channel name are unsupported for the Slack @-notifications.
For example, @----critical_alerts works, but @--critical_alerts-- doesn’t receive any notifications.
Use message template variables within a monitor message to dynamically build @-mentions.
For example, if the rendered variable is set up as a channel in the Slack integration:
@slack-{{owner.name}} post a message on the owner’s channel for this monitor.
@slack-{{host.name}} post a Slack message to the #host.name channel.
Or create an @-mention that goes directly to a specific email:
@team-{{team.name}}@company.com sends an email right to the team’s mailing list.Monitor alerts in your Slack channel contain several fields:
You can turn each of the fields on or off on the Slack integration tile. For each channel, select the checkbox next to each field you would like to include in the notification. Leave the other checkboxes unchecked.
The Slack integration does not provide any metrics.
The Slack integration does not include any events.
The Slack integration does not include any service checks.
The Datadog Slack app requires the following OAuth Scopes. For more information, see the Slack permission scopes documentation.
| Scopes | Request Reason |
|---|---|
app_mentions:read | This app can reply when mentioned directly. |
channels:join | The bot automatically joins previous configured public channels. |
channels:manage | Create channels for incident management. |
channels:read | Channel autocomplete in the Slack integration tile in Datadog. |
chat:write | Send messages in approved channels and conversations. |
commands | /datadog command. |
groups:read | Channel autocomplete in the Slack integration tile in Datadog. |
im:read | Use the /datadog command in direct messages. |
im:write | Notify admins when additional permissions are required. |
links:read | See previews of Datadog links. |
links:write | See previews of Datadog links. |
mpim:read | Use the /datadog command. |
reactions:write | Indicate message was added to Incident timeline. |
team:read | Keep the Slack integration tile in Datadog up to date with the state of your workspace. |
users:read | Responses customized to your timezone. |
users:read.email | Adding messages/users for incidents created outside of Slack. |
workflow.steps:execute | Share widgets from a Workflow Step. |
| Scopes | Request Reason |
|---|---|
identity.basic | Users can connect their Datadog accounts to Slack. |
Need help? Contact Datadog support.
