Slack

Installation

If you are using the US Datadog app region, install the Datadog Slack app in your Slack workspace:

1. Navigate to the Slack integration tile under Integrations in the Datadog app. Click the Connect Slack Account button at the bottom of the tile.

2. Confirm your Slack and Datadog account are connected. Note: You may need your Datadog workspace admin to approve this change, but you will only need to do this once.

Note: The Slack App Directory Slack integration works only if you are using the US region Datadog application. For other regions, see the Slack Webhook documentation.

Using the Slack App

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
/datadog slo

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, you’ll see a link which will unfurl as the widget you’ve pasted once sent to a channel.

Connecting monitors

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.

Using Datadog Incidents

Declare a new incident from the Slack App with:

/datadog incident 

Note: Anyone in your slack org can declare an incident, whether or not 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.

Incident Updates channel

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:

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

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 into the Slack App, you are able to set which channel will act as your Incident Updates channel.

How to set up this channel:

1. Navigate to Incidents Settings.
2. Locate the Incident Updates Channel section.
3. Define the Slack workspace and specific Slack channel that will serve as your Incident Updates channel.

Manage incident tasks

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 via Slack Actions by hovering over any message sent in an incident channel. Three dots will 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 will also appear and can be managed in the ‘Remediation’ tab under “Incident Tasks” in the Incidents UI. Check out the documentation for more information.

Use the Slack Webhook if you are using a non-US region of the Datadog Application.

Installation

The Slack integration is installed via its integration tile in the Datadog application.

Configuration

1. In your Slack account, go to the Applications page and search for Datadog (Legacy).
2. Click Install –> Add Integration, then copy the Slack Webhook URL.
3. Navigate to the Datadog-Slack integration tile in the configuration tab.
4. Click on Add Account
5. Add a Slack Account Name of your choice.
6. Paste the Webhook URL in the Slack Account Hook field.
7. Click Save.
8. Add your Slack Channels to post to:

9. If you would like to be notified for every comment on a graph, tick the check box Transfer all user comments by each channel. If this box is left unchecked, you must use the @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.

Note: If you are a non-US Datadog app user and would like us to add access to the Slack App Directory integration, let our support team know!