Overview

Connect Slack to Datadog to help your team collaborate by:

• Sharing graphs in private or public Slack channels.
• Receiving alerts and notifications from Datadog within Slack.
• Muting triggering monitors and declaring incidents from Slack.
• Automatically unfurling links to display a preview for log events, traces, and dashboard widgets.
• Running workflows directly from Slack.

Setup

Monitors

With the Slack integration, you can receive monitor alerts and mute monitors directly from Slack. For detailed instructions on how to create monitors, see Configuring Monitors. To send monitor alerts to a Slack channel, invite Datadog to the channel first using the /invite @Datadog command.

Notification messages

You can use the same rules, variables, and tags as standard Datadog Notifications. For example, this notification pings a team in a Slack channel called infrastructure when a monitor is renotifying:

CPU usage has exceeded {{warn_threshold}} on {{ @machine_id.name }}.
{{#is_renotify}}
Notifying @slack-infrastructure <!subteam^12345>
{{/is_renotify}}

Channels

To specify a Slack channel when configuring a notification message, type @slack in the monitor message box to see the available list of channels you can send the notification to.

Note: Trailing special characters in a channel name are not supported for Slack @-notifications. For example, @----critical_alerts works, but @--critical_alerts-- does not.

@-mentions

Use the following commands to create @-mentions in notification messages:

@users

command: <@username>

Notify a Slack user using their Slack username. Their username can be found in their Slack account settings under Username. For example: @slack-SLACK_CHANNEL <@USERNAME>, or @slack-SLACK_ACCOUNT-SLACK_CHANNEL <@USERNAME>.

@here

command: <!here>

Notify every online member that is a part of the channel the alert is being sent to.

@channel

command: <!channel>

Notify every member that is a part of the channel the alert is being sent to.

@usergroups

command: <!subteam^GROUP_ID>

Notify every member belonging to a user group in Slack. For example, you would use <!subteam^12345> for a user group with an ID of 12345. To find the GROUP_ID, navigate to More > Your organization > People > User groups. Select a user group, click the ellipsis, and select Copy group ID. You can also query the usergroups.list API endpoint.

You can also use message template variables to dynamically build @-mentions. For example, if the rendered variable corresponds to a specific channel in Slack:

• @slack-{{owner.name}} sends notifications to the #owner.name’s channel.
• @slack-{{host.name}} sends notifications to the #host.name channel.

To create @-mentions that go to specific email addresses:

• @team-{{team.name}}@company.com sends an email to the team’s mailing list.

Monitor alerts in Slack

When a monitor alert is sent a Slack channel, it contains several fields:

• The notification message
• A snapshot (graph) of the query that triggered your monitor
• Related tags
• The names of the users or groups that were notified

To customize the content included in monitor alert messages in Slack, navigate to the Slack integration tile. For each channel, select or clear the checkbox for each monitor alert option.

Migrate monitors from Slack Webhook (Legacy) to Datadog for Slack

If your monitors are using the legacy Slack webhooks, there are two ways you can update your monitors to be sent from the Slack app:

• Bulk upgrade: Bulk upgrade all of your monitors by clicking the Upgrade button at the top of the configuration for each of your Slack accounts in the Slack integration tile.
• Individual upgrades: Manually add channels to the new configuration in the Slack integration tile. You may need to remove duplicate references to the same channels.

Dashboards

You can post dashboard widget snapshots to any Slack channel.

To share a dashboard widget in Slack:

• In Datadog, hover over a dashboard widget and press CMD + C or CTRL + C, or click the Copy button from the share menu, and then paste the link into Slack.

Home Tab

Use the Home tab on the Datadog App in Slack to view your starred dashboards, notebooks, and services. You can also view a list of monitors that were triggered in the past 24 hours and their associated Slack channels. If you’re a member of more than one Datadog account, filter the tab by switching between accounts.

Incidents

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.

Incident commands

To declare a new incident from Slack:

/datadog incident 

To declare a new test incident from Slack:

/datadog incident test

To update the incident state (such as severity):

/datadog incident update

To list all open (active and stable) incidents:

/datadog incident list

To notify @-handles about the incident:

/datadog incident notify

To make an incident private:

/datadog incident private

To manage the incident’s response team:

/datadog incident responders

To send the message to the Incident Timeline, use the message actions command (the three vertical dots that appear hovering over a message sent in an #incident channel).

Global incident updates channel

A global 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:

• Newly declared incidents.
• Changes to severity, status transition, and incident commander.
• Links to the incident’s overview page in app.
• Link to join dedicated incident Slack channels.

To set up a global incident updates channel:

1. In Datadog, navigate to the Incidents > Settings > Integrations page.
2. In the Slack section, click the Send all incident updates to a global channel toggle.
3. Select the Slack workspace and Slack channel where you want the incident updates to be posted.

Manage incident tasks

By using Slack actions and the /datadog Slack commands, you can create and manage incident tasks directly from Slack. Incident task commands must be used in an incident channel.

Slack actions

To create a task using Slack actions, hover 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.

Slack commands

To create a task for an incident, use the /datadog task command. A modal appears that allows you to include a description of the task, assign teammates, and set a due date.

To show a list of all tasks created for the incident, use the /datadog task list command. Use this list to mark tasks as complete or reopen them.

All tasks created can be managed on the Remediation tab of an incident. For more information, see Incident Management.

/datadog workflow

Limit edit access

By default, all users have full access to connected Slack workspaces.

Use Granular Access Control to limit which roles can edit a specific workspace:

1. Navigate to the Slack integration tile.
2. Click the Channels tab.
3. Select the Slack workspace you want to restrict edit access to.
4. Click the gear icon in the upper-right corner to open the settings menu.
5. Select Permissions.
6. Click Restrict Access. The dialog box updates to show that members of your organization have Viewer access by default.
7. Use the dropdown to select one or more roles, teams, or users that can edit the Slack workspace.
8. Click Add. The dialog box updates to show that the role you selected has the Editor permission.
9. Click Save.

Note: To maintain your edit access to the workspace, you must include at least one role you belong to before saving.

If you have edit access, you can restore general access to a restricted workspace by completing the following steps:

1. Navigate to the Slack integration tile.
2. Click the Channels tab.
3. Select the Slack workspace you want to restore general access to.
4. Click the gear icon in the upper-right corner to open the settings menu.
5. Select Permissions.
6. Click Restore Full Access.
7. Click Save.

To edit Slack workspace permissions through the API:

1. Navigate to the Slack integration tile.
2. Click the Channels tab.
3. Select the Slack workspace you want to edit permissions for.
4. Copy the workspace ID shown for the selected workspace.
5. Use the Restriction Policies API, where the Resource Type is integration-account and the id is slack:<workspace_id>.

Permissions

Datadog for Slack requires the following OAuth Scopes. See the Slack permission scopes documentation for more information.

Bot Token Scopes

Optional Bot Token Scopes

Datadog for Slack offers features that require enabling additional optional Bot Token Scopes. These scopes are added dynamically based on feature enablement and are not added during the initial installation.

User Token Scopes

Optional User Token Scopes

Datadog for Slack offers features that require enabling additional optional User Token Scopes. These scopes are added dynamically based on feature enablement and are not added during the initial installation.

Enterprise Grid audit logs

Ingest events and actions that occur within your Slack Enterprise Grid.

Start collecting Slack audit logs

Only owners of an Enterprise Grid organization may authorize Datadog to collect Slack audit logs.

1. On the Slack integration tile, click the Audit Logs tab.
2. Click Connect Enterprise Grid to be redirected to Slack for authorization.

Collected events and actions

• User management events, such as user creation, deletion, and updates. This includes changes to user roles, permissions, and profiles.
• Workspace and channel management events, including actions related to the creation, modification, and deletion of channels and workspaces. It also tracks changes in workspace settings and permissions.
• File and app management events, including tracking the upload, download, and deletion of files, as well as monitoring the installation, update, and removal of Slack apps and integrations.
• Security and compliance events, including login attempts, password changes, and two-factor authentication events, as well as compliance-related actions like data exports and access to sensitive information.
• Audit trail of administrative actions, including changes made by Slack admins and workspace owners, such as policy updates, security settings changes, and other administrative modifications.
• External sharing and collaboration events, including the creation of shared channels, external invitations, and guest account activities.

Each event captured provides detailed insights, including:

• Action: What activity was performed.
• Actor: The user in the workspace who generated the event.
• Entity: The thing the actor has taken action upon.
• Context: The location (workspace or enterprise) where the actor took action on the entity.

For more information, see the official Slack documentation.

Data Collected

Metrics

The integration for Slack does not provide any metrics.

Events

The integration for Slack does not include any events.

Service Checks

The integration for Slack does not include any service checks.

Troubleshooting

Need help? Contact Datadog support.

Further reading

Additional helpful documentation, links, and articles:

• Manage incidents seamlessly with the Datadog Slack integration