For AI agents: A markdown version of this page is available at https://docs.datadoghq.com/integrations/pingdom-v3.md. A documentation index is available at /llms.txt.

Pingdom

Integration version1.0.0

To find out if this integration is available in your organization, see your Datadog Integrations page or ask your organization administrator.

To initiate an exception request to enable this integration for your organization, email support@ddog-gov.com.

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) but uses version 3.1 of the Pingdom API.

Pingdom graphs on a Datadog dashboard

Setup

Generate API Token

  1. Login to your Pingdom account.
  2. Navigate to Settings > Pingdom API.
  3. 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

  1. Open the Pingdom V3 Integration Tile.
  2. Enter the name and API Token into the corresponding fields. Metrics and checks configured in Pingdom are collected into Datadog.
  3. 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

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

The Pingdom integration does not include any events.

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 statusPingdom status
OKup
CRITICALdown
WARNINGunconfirmed_down
UNKNOWNunknown, paused

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.
  2. Click Add new.
  3. Enter a name for the integration.
  4. 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.
  5. Click Save integration.

After saving, enable the integration on your uptime checks:

  1. Go to Monitoring > Uptime.
  2. Open the check you want to configure.
  3. 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

Need help? Contact Datadog support.