> ## Documentation Index
> Fetch the complete documentation index at: https://docs.incident.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Displaying metrics on your status page

> Show visitors real performance data, like response times and uptime, on your public status page.

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](#datadog)**: chart any Datadog metric query, such as request latency or error rate
* **[Pingdom](#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](https://app.incident.io/~/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](https://docs.datadoghq.com/account_management/api-app-keys/#api-keys) from your Datadog organization
* **Application key**: an [application key](https://docs.datadoghq.com/account_management/api-app-keys/#application-keys) 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

> [!WARNING]
>
> Disconnecting a data source removes all of its metrics from your status pages.

## FAQs

> [accordion] Which monitoring providers are supported?
>
> Datadog and Pingdom. If you'd like to see support for another provider, let us know at
> [help@incident.io](mailto:help@incident.io).

> [accordion] Do I need a Datadog alert source to show Datadog metrics?
>
> 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.

> [accordion] Can I display metrics on internal or customer status pages?
>
> No, metrics are only available on public status pages.

> [accordion] How fresh is the data?
>
> 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.

> [accordion] Does every visit to my status page query Datadog?
>
> 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.
