See below for a detailed overview of how to configure this in the NS1 portal and your Datadog account.
Creating a Webhook in your Datadog Account
1. In the Integrations section of your Datadog account, search for the Webhook integration and Install.
2. Open the Configuration tab and scroll down to enter Webhook details:
Name: Enter any name for your Webhook. This does not need to match any of the information entered when creating your data feed in the NS1 portal.
URL: Enter the Feed URL generated in the Data Sources section of the NS1 portal.
3. In the Monitors section, select New Monitor and choose the appropriate monitor type. This integration is compatible with Host, Metric, Custom check, Event and Outlier types.
4. Fill out your monitoring preferences as you normally would. The Monitor Name entered in step 3 must match the name you enter in the Datadog Monitor Name field in the NS1 portal and the monitoring message needs to include a request to notify the webhook you created (eg. Notify @webhook-NS1_Webhook).
Connecting to Datadog in the NS1 Portal
1. Navigate to the Integrations section of the NS1 portal, scroll down to the list of Supported Services and click on Datadog.
2. Click on "Create an Incoming Datafeed," which will prompt you to fill out the following fields:
- Name (for internal reference): As it implies, this name does not need to match anything entered in your Datadog account.
- Fail on “Warning”: Likewise, if you have configured any warnings in Datadog, it is possible to have these alerts result in a Down marking by checking the box. If left unchecked, up/down will be left unchanged from prior state.
- Fail on “No Data”: Datadog will report one of four statuses - Triggered, Recovered, Warning and No Data. Triggered status will always result in a Down marking and Recovered in Up. If box is checked, No Data status will result in a Down marking. If left unchecked, there will be no impact to up/down status.
- Datadog Monitor Name: This must be an exact match for the monitor name entered in Datadog.
3. Under the Zones section of the NS1 portal, navigate to a record that contains Answers you wish to monitor via Datadog.
4. If your Filter Chain is already configured with the Up filter, click Filter Data to make the associated metadata appear. Alternatively, you can click the gear icon next to All Answer Data to make all metadata appear.
5. Now click the plug icon in the Up metadata row for the answer you would like to connect to Datadog. We'll use the primary 188.8.131.52 answer in this example. Choose 3rd Party Integrations.
6. Your newly created Datadog alert will appear alongside any previously configured 3rd-party integrations. Click on the Datadog integration and hit Save.