Import metrics from Datadog

Seamlessly import Datadog metrics into ilert to visualize SLOs, automate incident alerts, and keep status pages up to date.

Create a Datadog metric data source

In Datadog

1. Go to Organization Settings --> API Keys and click New Key.

   
2. Give the Key a name (e.g., ilert metrics import) and click Copy Key, and paste it somewhere. You will need this key later in ilert.

3. Go to Organization Settings --> Application Keys and click New Key.

4. Give the Key a name and copy and paste somewhere. You will need the application key later in ilert.

In ilert

1. Go to Status pages (or Incident comms) --> Metric data sources, and click on Create metric data source.

   
2. Give the metrics data source a name (e.g., Datadog).

3. Select Datadog in Type dropdown list.

4. Select your Datadog region. You can identify your region by matching your Datadog website URL to the URL from the list.

5. Enter the API and Application keys from above and click Create metric data source.

   

Create a metric

In Datadog

1. Find the metric you want to import to ilert, e.g., by opening a dashboard.

2. Click on Edit this widget.

   
3. In the Edit view, choose the graph you want to import and click on the </> icon to display the metric query.

   

4. Copy the metric query. You will need the query below in ilert.

   

Note that metrics in ilert are not dimensional. Therefore, only Datadog metrics without grouping can be imported. See the Datadog documentation on Anatomy of a metric query.

For example, the following query is not supported:

max:system.disk.in_use{host:app_prod} by {device}

While this query is supported:

max:system.disk.in_use{host:app_prod}

In ilert

1. Go to Status pages (or Incident comms) --> Metrics, and click Create metric.

   
2. Select the Datadog metrics data source that you have created above and click Next.

   

3. On the next screen, enter a metric name and a display unit. Paste the metric query from step 4 above. Click Save to preview your metric data.

   

4. Preview your metric. You can make changes to your query and reload the data from Datadog. Note that once you have created your metric, you will no longer be able to change the metric query.

Further References

Here are the articles on how to connect Datadog and ilert: Datadog Inbound Integratio