Data connections
...
Integrations
Incident management

Datadog

7min

Purpose

Echoes can connect to your Datadog account and monitor your incidents lifecycle in order to produce some metrics such as the Mean time to recovery.

Installation

Datadog integration is done through the integrations settings. The installation will guide you into generating an organization’s API key and an Application key.

For the Application Key we encourage to create a Service Account as key holder.

Make sure to select the appropriate site.

Datadog connection
Datadog connection


Once the connection is made you will be invited to select the Datadog Organization on which to install Echoes

Datadog organization selection
Datadog organization selection


Echoes will then install a webhook integration on the selected Datadog organization.

Required permissions

It is advised to create a custom role specific to Echoes and associate the role to the user the Application Key has been issued for.

Echoes custom role
Echoes custom role


The following permissions are required for Echoes to interact with Datadog:

  • Integration Manage
Document image

  • Service Catalog Read
Document image


Setting up your Datadog incident notification rule

The next step is to setup an incident notification rule in order to send incidents' events to Echoes through the webhook previously set during the installation.

The destination to be selected is Echoes_webhook

Configure the rule
Configure the rule


Configure the events to be sent if State is to change or Echoes TeamID (Optional).

Webhook triggers
Webhook triggers


Reference an Echoes team as owner of a Service (Optional)

A service may represent an application, a component, to open incidents against.

In order to associate a Service suffering an incident to a team in Echoes, the property Echoes TeamID is to be added to the incident's property fields as a custom field. This field is not mandatory.

Add custom field
Add custom field


It is to be defined as a Text Area and a User Input

Custom field attributes
Custom field attributes


The team ID value itself can then be set via the incident attributes on the incident page

Echoes Team ID
Echoes Team ID


How to get the correct team ID from Echoes?

The team IDs can be found by using our Teams API.

Updated 25 Jan 2024
Did this page help you?