Alerts
Datadog can be configured to send events into Rootly as alerts. The alerts received on Rootly can then be routed to a Slack channel or used to initiate incidents.
Please note that you will need to first have Datadog installed in Rootly before being able to ingest alerts from Datadog. If you have not installed Datadog in Rootly, please follow the instructions on the Installation page.
Log into your Datadog account and select: Integrations > Search for "Webhook" > Select Webhooks
![Document image Document image](https://images.archbee.com/8_w24B7qUsOA0oEkiqb_I/XyyVVxS6-CySycPldFYmz_cleanshot-2024-01-18-at-005426.png?format=webp)
You'll be asked to configure a webhook. Now, select + New in Webhooks section (lower left corner of the modal.
![Document image Document image](https://images.archbee.com/8_w24B7qUsOA0oEkiqb_I/mwbyg3EXokAZIPbosh3oM_cleanshot-2024-01-18-at-005814.png?format=webp)
Once we have located the Webhook within Datadog, we would need to configure the Webhook to point to the following URL: https://rootly.com/webhooks/incoming/datadog_webhooks
You'll be promoted to enter the following details for the webhook.
![Document image Document image](https://images.archbee.com/8_w24B7qUsOA0oEkiqb_I/72pJuby8gbSMe9X2veugG_cleanshot-2024-01-18-at-010305.png?format=webp)
Give your webhook a representative name.
The webhook URL can be obtained from your Datadog integration page in Rootly (Integrations > Datadog > Configure).
![Document image Document image](https://images.archbee.com/8_w24B7qUsOA0oEkiqb_I/kPdqFMFElLPJ6uZ66z2DJ_cleanshot-2024-01-18-at-010537.png?format=webp)
Copy the following code and paste it into the Payload field. This will result in a regular (non-paging) alert.
Paging through Rootly On-Call also relies on webhook alerts. The main difference being the inclusion of a notification_target object.
- type - this defines the Rootly resource type that will be used for paging.
- The following are the available values:User | Group (Team) | EscalationPolicy | Service
-
- id - this specifies the exact resource that will be targeted for the page.
- The id of the resource can be found when editing each resource.
![Document image Document image](https://images.archbee.com/8_w24B7qUsOA0oEkiqb_I/N4K0Xep4NeWZVFWEq9TXj_cleanshot-2024-04-26-at-020713.png?format=webp)
Copy the following code and paste it into the Payload field. This will result in both the alert appearing in Rootly and the targeted resource being paged.
Check the Custom Header checkbox and paste the following code into the text area.
Replace the secret value with the one found in your Datadog integration in Rootly (Integrations > Datadog > Configure).
![Document image Document image](https://images.archbee.com/8_w24B7qUsOA0oEkiqb_I/zVqnESATvHj66plAcQ4eJ_cleanshot-2024-01-18-at-011001.png?format=webp)
Once completed, go ahead and select Save to create your webhook.
Once your webhook is created, you need to attach it to a Datadog monitor. A monitor contains the firing logic that determines when alerts will be sent out.
Navigate to Monitor > New Monitor > Event to create a new monitor.
![Document image Document image](https://images.archbee.com/8_w24B7qUsOA0oEkiqb_I/6cDxf1CnFP3Ni5m5H-0FY_cleanshot-2024-01-18-at-011545.png?format=webp)
Now, you can configure your monitor to your desired firing logic. The main action to ensure that you do is select your webhook in the Notify your team section.
![Document image Document image](https://images.archbee.com/8_w24B7qUsOA0oEkiqb_I/i0GzR51drtMwMkDKFZfwh_cleanshot-2024-01-18-at-012117.png?format=webp)
Once ready, you can select Test Notifications to test out your monitor and webhook. You should see a test alert appear from Datadog on your Rootly Alerts page.
![Document image Document image](https://images.archbee.com/8_w24B7qUsOA0oEkiqb_I/NTMeU8ZRTT5uhN7D2wXHK_cleanshot-2024-01-18-at-012424.png?format=webp)
Finally, save your monitor. The resulting product should look something like this:
![Document image Document image](https://images.archbee.com/8_w24B7qUsOA0oEkiqb_I/das2CLRml_5OeSRawX2PW_cleanshot-2024-01-18-at-012836.png?format=webp)
If you need help or more information about this integration, please contact [email protected] or start a chat by navigating to Help > Chat with Us.