Datadog Monitor Alerts

Flow Designer has a Datadog Monitor Alert trigger and built-in Datadog steps to help you integrate Datadog into your alert management and incident response flows.

Datadog Steps

The following steps are available:

  • Create Event: create a new event in Datadog, populating it with information from the alert or any previous steps in the flow.
  • Add Comment: add a comment to an existing Datadog event.
  • Mute Monitor: mute, or partially mute, an entire Datadog monitor.
  • Unmute Monitor: unmute, or partially unmute, an entire Datadog monitor.

In the example above, the flow creates an xMatters alert when a signal from Datadog comes into xMatters. When a user acknowledges the notification, a Datadog event is created and a comment is added to the event.

Create Event

Use the Create Event step to automatically create a new event in Datadog. Map outputs from previous steps to the inputs; at runtime, the values in the inputs are used to fill in the incident record.

Add Comment

Use the Add Comment step to automatically add a comment to an existing Datadog event. Map outputs from previous steps to the inputs to create the comment and determine what incident to comment on.

Mute Monitor

Use the Mute Monitor step to automatically mute an entire Datadog monitor, or partially mute is by setting a scope. Map outputs from previous steps to the inputs; at runtime, the values in the inputs are used to determine the monitor and the scope to apply the mute to.

Unmute Monitor

Use the Unmute Monitor step to automatically unmute an entire Datadog monitor, or partially unmute is by setting a scope. Map outputs from previous steps to the inputs; at runtime, the values in the inputs are used to determine the monitor and the scope to apply the unmute to.

Datadog Monitor Alert trigger

The built-in Datadog Monitor Alert trigger initiates a flow when it receives a request from a Datadog webhook.

Add the Datadog Monitor Alert trigger to the canvas

  1. Go to the Triggers tab in the palette, expand the App Triggers section, and drag the trigger onto the canvas.
  2. Double-click the trigger (or click the pencil icon).
  3. Set the authenticating user, and then copy the URL and Configuration Payload — you'll use these to set up the webhook in Datadog. Alternatively, you can create an integration user to use as the authenticating user.

  1. Click the Flood Control tab to edit the trigger's default flood control settings. For more information about these settings, see Trigger Flood Control.
  2. Click Done.
  3. On the flow canvas, connect the steps you want to run when xMatters receives a request to that URL.

You're now ready to configure Datadog to target the trigger.

Configure Datadog to send requests to the trigger URL

To have Datadog send alerts to the flow trigger, you need to configure a webhook and set it to use the trigger URL. You also need to create an event monitor to alert the webhook when certain types of events exceed a specified threshold.

Outputs