---
title: Pingdom
description: See Pingdom-collected uptimes, response times, and alerts in Datadog.
breadcrumbs: Docs > Integrations > Pingdom
---

> For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt).

# Pingdom
Integration version1.0.0
{% callout %}
# Important note for users on the following Datadog sites: us2.ddog-gov.com

{% alert level="info" %}
To find out if this integration is available in your organization, see your [Datadog Integrations](https://app.datadoghq.com/integrations) page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email [support@ddog-gov.com](mailto:support@ddog-gov.com).
{% /alert %}

{% /callout %}

## Overview{% #overview %}

Track Pingdom user-centric performance metrics in Datadog, for correlation with other relevant events and metrics.

Pingdom V3 Integration acts similarly to the [Datadog Pingdom Integration (Deprecated)](https://docs.datadoghq.com/integrations/pingdom.md) but uses version 3.1 of the [Pingdom API](https://docs.pingdom.com/api/).



## Setup{% #setup %}

### Generate API Token{% #generate-api-token %}

1. Login to your [Pingdom account](https://my.pingdom.com/).
1. Navigate to *Settings* > *Pingdom API*.
1. Click *Add API token*. Give the token a name and *Read-Write* permissions. Save the token somewhere as you will not be able to access it again.

### Installation and configuration{% #installation-and-configuration %}

1. Open the [Pingdom V3 Integration Tile](https://app.datadoghq.com/integrations/pingdom-v3).
1. Enter the name and API Token into the corresponding fields. Metrics and checks configured in Pingdom are collected into Datadog.
1. Manage tags of checks in Pingdom. Tags added to a check in Pingdom are automatically added to a check in Datadog. Exclude checks by adding the `datadog-exclude` tag.

## Data Collected{% #data-collected %}

### Metrics{% #metrics %}

|  |
|  |
| **pingdom.response_time**(gauge)                 | The HTTP response time for this Pingdom check*Shown as millisecond*                |
| **pingdom.uptime**(gauge)                         | The elapsed time since the last HTTP error for this Pingdom check*Shown as second* |
| **pingdom.check.status.count**(count)             | Count of Pingdom status checks*Shown as check*                                     |
| **pingdom.check.error.count**(count)              | Count of Pingdom status checks that only have errors*Shown as error*               |
| **pingdom.transaction.check.status.count**(count) | Count of Pingdom transaction status checks*Shown as check*                         |
| **pingdom.transaction.check.error.count**(count)  | Count of Pingdom transaction status checks that only have errors*Shown as error*   |

### Events{% #events %}

The Pingdom integration does not include any events.

### Service Checks{% #service-checks %}

The Pingdom integration pulls in transaction checks and reports them as service checks.

For the `pingdom.status` check, Pingdom transaction check results correlate to Datadog service check results as follows:

| Datadog status | Pingdom status      |
| -------------- | ------------------- |
| `OK`           | `up`                |
| `CRITICAL`     | `down`              |
| `WARNING`      | `unconfirmed_down`  |
| `UNKNOWN`      | `unknown`, `paused` |

## Page a Datadog On-Call team{% #page-a-datadog-on-call-team %}

To trigger On-Call Pages from Pingdom uptime checks, configure a webhook in Pingdom:

1. In Pingdom, go to [**Integrations > Integrations**](https://my.pingdom.com/integrations/settings).
1. Click **Add new**.
1. Enter a name for the integration.
1. In the **URL** field, enter the following webhook URL:
   ```
   https://event-management-intake.<DATADOG_SITE>/api/v2/events/webhook?dd-api-key=<DATADOG_API_KEY>&integration_id=pingdom-v3&oncall_team=<TEAM_HANDLE>
   ```
Replace `<DATADOG_API_KEY>` with your Datadog API key and `<TEAM_HANDLE>` with your On-Call team handle.
1. Click **Save integration**.

After saving, enable the integration on your uptime checks:

1. Go to [**Monitoring > Uptime**](https://my.pingdom.com/newchecks/checks).
1. Open the check you want to configure.
1. Select the checkbox next to the integration you created.

When a Pingdom check changes status, Pingdom sends a POST request to the configured webhook URL. Datadog routes the resulting event to the specified On-Call team. When the check recovers, Pingdom sends a resolved notification that automatically closes the page.

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](https://docs.datadoghq.com/help).