Add a Datadog metric

Linking Datadog as a 3rd party data source

1. Log in to your Datadog account.

2. In the Datadog sidebar, select your avatar and go to Organization Settings > API Keys.

Datadog integration

3. On the API Keys page, create a new key, name it, and copy it to a blank text document.

4. Go back to Organization Settings > Application Keys.

5. On the Application Keys page, create a new key, name it, and copy it to a blank text document.

6. Log in to your Statuspage account.

7. Select System metrics > Linked accounts.

8. Select Datadog and paste your API and application keys.

9. Select Link account.

Note: Do not use the Key ID as this will throw an error.

Datadog link account example

Add a Datadog metric to Statuspage

1. In Statuspage, select Your page > System metrics.

2. Select Add a metric.

3. From the Data source dropdown, select Datadog.

What happens when new components or system metrics are added to audience-specific pages?

If a subscriber didn’t set up their subscription preferences they'll automatically be subscribed to any new components or system metrics.

If a subscriber already changed their subscription preferences, they will not automatically be added to new components/system metrics. To give them access to the new component or system metric, edit the audience-specific group or user under Audience.

4. Find your query in Datadog:

a. In Datatog, select Dashboards.

b. Select Edit this graph on the selected metric.

Datadog graphic of metrics

c. Select JSON and copy the value of the q key in the JSON payload.

Note: We don't support the full JSON payload so please make sure you're providing a Datadog query. Basically, what is contained in the "q" field of the JSON payload is what should be entered into our integration.

5. Back in Statuspage, paste the query and enter a display name and suffix.

How to add a datadog metric to your statuspage

6. Edit your metric as needed and make it visible on your page.

Editing a metric

1. Select Your page > System metrics.

2. Select the Advanced options tab.

3. Edit the metric and its attributes.

By default, your metric is hidden and does not appear on your status page.

4. Save your changes and make them visible to your page viewers by selecting Update Metrics display.


Still need help?

The Atlassian Community is here for you.