Migrate Datadog and New Relic Integrations

TiDB Cloud now manages Datadog and New Relic integrations at the cluster level, offering more granular control and configuration. The legacy project-level Datadog and New Relic integrations will be deprecated on October 31, 2025. If your organization is still using these legacy integrations, follow this guide to migrate to the new cluster-level integrations and minimize disruptions to your metrics-related services.

Prerequisites

• To set up third-party metrics integration for TiDB Cloud, you must have the Organization Owner or Project Owner access in TiDB Cloud.

Migration steps

Step 1. Delete the legacy project-level Datadog and New Relic integrations

1. In the TiDB Cloud console, switch to the target project using the combo box in the upper-left corner.

2. In the left navigation panel, click Project Settings > Integrations.

3. On the Integrations page, click Delete next to Integration to Datadog or Integration to New Relic.

4. In the displayed dialog, type Delete to confirm the removal of the legacy integration.

Step 2. Create the new Datadog or New Relic integration for each cluster

Repeat the following steps for each TiDB Cloud Dedicated cluster in the project.

1. In the TiDB Cloud console, switch to the target cluster using the combo box in the upper-left corner.

2. In the left navigation panel, click Settings > Integrations.

3. On the Integrations page, create new integrations as needed. For more information, see Integrate TiDB Cloud with Datadog and Integrate TiDB Cloud with New Relic.

Impact statement

Deleting the project-level integration immediately stops all clusters in the project from sending metrics. This results in a temporary loss of downstream data and interrupts integration-related services (such as monitoring and alerts) until you create new cluster-level integrations.

Contact support

For assistance, contact TiDB Cloud support at support@pingcap.com or reach out to your Technical Account Manager (TAM).