Overview
Rundeck further enhances Datadog notifications with automated workflow capabilities to help diagnose issues-and, optionally, to remediate them.
Learn more about automating your runbooks to reduce incident time on the Rundeck website.
Some example use cases are:
- If a Windows/Linux service is down, attempt to restart it
- If NTP sync is off, restart the NTP service on that machine
- Clean up logs and other file waste when disk space becomes full
- Restart services in response to hung work queues
- Provision capacity in response to high utilization
Use the instructions below to configure your Datadog/Rundeck integration.
Setup
Installation
Prepare at least one Rundeck job that you would like to trigger using a Datadog alert.
Configuration
Rundeck
- In your Rundeck Project, click the Webhooks navigation option.
- Click Add.
- Give the webhook a name, for example:
Datadog-Restart Service. - Click the Choose Webhook Plugin button and select Run Job*.
- Select the job you’d like to run when this webhook is triggered.
- [optional] In the Options line, enter the following text:
-raw ${raw} -event_type ${data.event_type}
(This makes the full Datadog payload available as part of the job input options.) - Click Create Webhook. The URL field is automatically populated after the webhook is created.
Note: If you are using a firewall, add the Datadog IP ranges to your allowlist.
Datadog setup
Open Datadog and go to Integrations > Integrations.
Search for “webhooks”.
Click on the webhooks entry shown above. It opens the configuration window.
Click the New button and fill out the form:
Add this integration to any alert notification in Datadog by adding the recipient of @webhook-Rundeck_Restart_Service. The name varies based on what you name the webhook in step 4a. When the monitor triggers an alert, the webhook runs the associated job.
Other plugins, such as Advanced Run Job, can also be used, depending on your use case.
Data Collected
Metrics
The Rundeck integration does not provide any metrics.
Service Checks
The Rundeck integration does not include any service checks.
Events
The Rundeck integration does not include any events.
Troubleshooting
Need help? Contact Datadog support.
