Datadog Plugins

Available in PagerDuty Runbook Automation Commercial products.

Overview

Runbook Automation integrates with Datadog through a variety of plugins listed below.
By integrating Runbook Automation with Datadog, users can automate workflows in Datadog in response to alerts or automate diagnostics and remediation in their environment.
These integrations allow operations teams to provide self-service mechanisms to users throughout the business, as well as setup event-driven automation for workflows that involve Datadog.

Plugin Name	Plugin Type	Description
Mute Host	Node Step	Mute a specific host as a step in a workflow.
Unmute Host	Node Step	Unmute a specific host as a step in a workflow.
Send Event	Job Step	Send an event, such as an alert, to Datadog.
Create Incident	Job Step	Create an incident and Datadog.
Update Incident Status	Job Step	Update the status of an incident in Datadog.
Update Incident State	Job Step	Update the state of the incident in Datadog.
Add Incident Task	Job Step	Add a task to a Datadog incident.
Complete Incident Task	Job Step	Complete a task in a Datadog incident.
Datadog Node Source	Node Source	Retrieve nodes from Datadog and populate the Node Inventory.
Datadog Health Check	Health Check	Update the status of nodes according to their status in Datadog.
Notification Send Event	Notification	Send and event to Datadog in response to Job behavior.
Datadog Webhook	Webhook	Automatically run jobs in response to webhooks sent from Datadog.

Click to expand to see the full list of Runbook Automation plugins for Datadog.

Configuration

Generate Datadog API & App Keys

Follow this documentation from Datadog to generate an API Key and an Application ("App") Key.
Define the Scopes of the App Key based on the Plugins you intend to use. Save the API and App Keys to a secure location so that they may be used in the next section.

Configure Plugin Suite in Runbook Automation

Authentication for the Datadog plugins can be configured for the entire system or for an individual project.

Project Level Configuration

1. In the specific project, click on Project Settings in the lower left.
2. Click on Edit Configuration then click on Plugins.
   
   
3. Click on +PluginGroup.
4. Select Datadog from the list.
5. Click Select... next to the App Key field.
6. Click + Add or Upload a Key.
7. Select Password for the Key Type.
8. Enter the App Key into the Enter Text field.
9. Provide a name for the secret, such as datadog-app-key:
   
10. Click Save to save the secret into Key Storage and click Save again to use the newly create key for the plugin.
11. Repeat steps 5 through 10 for the API Key field and using the API Key generated in the prior section.
12. If your Datadog instance does not use https://app.datadoghq.com as its URL, then select the Site URL dropdown and select the URL that matches your Datadog instance:
    
13. Click Save to commit the plugin suite configuration. Click Save to commit the Project Configuration update.

System Level Configuration

Use the following steps to configure authentication for the Datadog plugins for the whole Runbook Automation system.

1. Click on the System Menu (gear icon) in the upper right.
2. Click on System Configuration.
3. Navigate to the Datadog section and click on the Pencil Icon in the upper right:
   
4. Click Select... next to the App Key field.
5. Click + Add or Upload a Key.
6. Select Password for the Key Type.
7. Enter the App Key into the Enter Text field.
8. Provide a name for the secret, such as datadog-app-key:
   
   
   
9. Click Save to save the secret into Key Storage and click Save again to use the newly create key for the plugin.
10. Repeat steps 5 through 10 for the API Key field and using the API Key generated in the prior section.
11. If your Datadog instance does not use https://app.datadoghq.com as its URL, then select the Site URL dropdown and select the URL that matches your Datadog instance:
    
12. Click Save to commit the plugin suite configuration update.