Datadog is a monitoring service for cloud-scale applications, bringing together data from servers, databases, tools and services. The integration allows you to push alerts and response time metrics to their platform, and we have worked together to make this integration seamless. To get started, you will first need to set up a Datadog account at https://datadoghq.com/.
- When an alert is created in Uptime.com, a corresponding event is issued in Datadog.
- Events within Datadog can be assigned lower priority, and commented on.
- Response times of your checks can be tracked as metrics in DataDog.
- Metrics will update every five minutes with five data points from one-minute checks.
First, login to your Datadog account, then click the Integrations menu>Integrations. Locate Uptime.com and click Configure>Install. Once installed, select your avatar, located at the bottom of the page >Select Organization Settings> and select API.
Click on your API key and hover to reveal your key. To Create a new key click Create.
To retrieve your application key navigate to the Organization Settings Page>Press Application Key. Click the copy icon to the right of your application key to copy the full 40 digit number.
Return to Uptime.com.
In order to activate the integration of Datadog within your Uptime account, you will go to Notifications>Integrations, then click New Profile. Select Datadog as the Provider Type when adding a new push notifications profile.
Paste the API Key and the Application Key copied previously into their respective fields, and Name the integration.
Please note: it is possible to toggle the API region between US and EU, to send data as needed. Follow the steps above using either a Datadog US or EU account, as application and API keys can vary by region, and set the API Region to US or EU as appropriate.
Once you've configured your Datadog integration, you will need to assign it to a contact and make sure that contact is notified when a Check fails.
Assign Integration to Contacts
To add your integration to an existing contact, click on or type the name of the contact into the Assign to Contacts field within the integration setup screen.
You can designate a new contact from within the integration setup. Simply enter the name of your new contact into the Assign to Contacts field, and select it as depicted below:
Uptime.com will create a new contact and assign the integration to it. You can find this contact when you click Notifications>Contact.
Assign Integration Contact to a Check
If you have created a new or dedicated contact for your integration, you will need to add it to specific checks. If you have assigned the integration to a contact that is already assigned to one (or more) checks, you may skip this step.
Return to your Check’s Edit screen and assign this contact to the Contacts field to be notified of a downtime event. Metrics will update every five minutes with five data points from one-minute checks. On initial setup, metric data may take up to 30 minutes to appear.
Please note: Response time data is stored based on account usage. Uptime.com stores hourly data for a maximum of 90 days, and daily check data for a period of up to 24 months.
Test Your Integration
Test your integration with one of the following two options:
- Force the Check assigned to your Integration to fail by altering it (HTTPS checks can use a misspelling of the domain, for example)
- Click Notifications>Contacts, then click Actions>Test to send a test to the Contact