Skip to main content
Metrics let you display live charts on your public status page, backed by data from your monitoring tools. Alongside the status of each component, visitors see how your systems are performing over the last day, week, or month. Metrics can come from two data sources:
  • Datadog: chart any Datadog metric query, such as request latency or error rate
  • Pingdom: chart the response time or uptime of a Pingdom check
Visitors to your status page can switch each chart between 1-day, 7-day, and 30-day views.

Before you start

You’ll need:
  • The Configure status pages permission
  • The Manage organisation settings permission, to connect a data source
  • A Pro or Enterprise plan

Connecting a data source

You connect each data source once, and every status page in your organization can use it.
  1. Open your status page and go to its Metrics settings
  2. Click Connect data source
  3. Choose Datadog or Pingdom, and click Continue
  4. Enter the credentials for that data source, and click Connect
You can also connect either data source from Settings → Integrations.

Datadog

Datadog asks for:
  • Datadog site: the site your Datadog account uses, e.g. US1 (app.datadoghq.com) or EU1 (app.datadoghq.eu)
  • API key: any API key from your Datadog organization
  • Application key: an application key with the timeseries_query scope
We check both keys against Datadog when you connect, so you’ll see straight away if either one is wrong.

Pingdom

Pingdom asks for an API token. Create a read-only token in Pingdom under Settings → Pingdom API → Add API token.

Adding a metric

  1. Open your status page and go to its Metrics settings
  2. Click Add metric
  3. If you’ve connected more than one data source, choose where the metric’s data comes from
  4. Fill in the metric’s details and click Publish

Datadog metrics

A Datadog metric charts a metric query, or a formula that combines several queries. We only support single-line charts, so your query or formula must return one series. If a query is grouped by a tag, e.g. by {host}, remove the grouping. You can set a custom rollup interval in a query, e.g. .rollup(avg, 60). To keep things readable, charts will only show up to 1,500 points. If your query returns more than that over a time range, we may substitute a longer rollup interval. Charts use the unit Datadog has for the metric. If a chart shows the wrong unit, or none, set the metric’s unit in Datadog.

Pingdom metrics

A Pingdom metric charts one of your Pingdom checks. Choose Latency to show the check’s average response time, or Uptime to show the percentage of checks that succeeded.

Managing metrics

From the Metrics settings you can:
  • Reorder metrics by dragging them, which changes the order they appear on your status page
  • Edit a metric to rename it or change the data behind it
  • Remove a metric to take it off your status page
Disconnecting a data source removes all of its metrics from your status pages.

FAQs

Datadog and Pingdom. If you’d like to see support for another provider, let us know at help@incident.io.
No. Status page metrics need Datadog connected with an API key and an application key. A Datadog alert source receives alerts through a webhook, so it doesn’t need that connection. You can use either one without the other.
No, metrics are only available on public status pages.
For Pingdom, we fetch new results as often as your check runs. For example, a check with a one-minute resolution updates roughly every minute.For Datadog, the 1-day chart refreshes every 5 minutes, the 7-day chart every 15 minutes, and the 30-day chart every hour.
No. We fetch your Datadog data on a schedule and store it, so the number of visitors to your status page doesn’t change how often we query your Datadog account.