add integration migration guide

TOC-tidb-cloud.md

@@ -161,7 +161,9 @@
       - [Subscribe via Slack](/tidb-cloud/monitor-alert-slack.md)
       - [Subscribe via Zoom](/tidb-cloud/monitor-alert-zoom.md)
     - [Cluster Events](/tidb-cloud/tidb-cloud-events.md)
-    - [Third-Party Metrics Integrations](/tidb-cloud/third-party-monitoring-integrations.md)
+    - Third-Party Metrics Integrations
+      - [Overview](/tidb-cloud/third-party-monitoring-integrations.md)
+      - [Migrate Datadog and New Relic Integrations](/tidb-cloud/migrate-metrics-integrations.md)
     - [TiDB Cloud Clinic](/tidb-cloud/tidb-cloud-clinic.md)
   - Tune Performance
     - [Overview](/tidb-cloud/tidb-cloud-tune-performance-overview.md)

tidb-cloud/migrate-metrics-integrations.md

@@ -0,0 +1,42 @@
+---
+title: Migrate Datadog and New Relic Integrations
+summary: Learn how to migrate from the legacy project-level metrics integration to the new cluster-level integration for Datadog and New Relic.
+---
+
+# 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](https://tidbcloud.com/), 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](/tidb-cloud/select-cluster-tier.md#tidb-cloud-dedicated) cluster in the project.
+
+1. In the [TiDB Cloud console](https://tidbcloud.com/), 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](/tidb-cloud/monitor-datadog-integration.md) and [Integrate TiDB Cloud with New Relic](/tidb-cloud/monitor-new-relic-integration.md).
+
+## 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 <a href="mailto:[email protected]">[email protected]</a> or reach out to your Technical Account Manager (TAM).