📣
TiDB Cloud Essential is now in public preview. Try it out →
TiDB Cloud
TiDB Self-Managed
Learning Center
Contact Us
​
Sign InStart for Free

Migrate Prometheus Integrations

TiDB Cloud now manages Prometheus integrations at the cluster level, offering more granular control and configuration. The legacy project-level Prometheus integrations (Beta) will be deprecated on January 6, 2026. If your organization is still using these legacy integrations, follow this guide to migrate them to the new cluster-level Prometheus integrations to 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

Do the following to migrate the Prometheus integration.

Step 1. Delete the legacy project-level Prometheus integrations (Beta)

  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 > Integration to Prometheus (BETA) module, select Scrape_config Files and click Delete.

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

Step 2. Create a new cluster-level Prometheus integration for each cluster

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

  1. In the TiDB Cloud console, navigate to the Clusters page of your project, and then click the name of your target cluster to go to its overview page.

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

  3. On the Integrations page, create a new Prometheus integration. For more information, see Integrate TiDB Cloud with Prometheus and Grafana.

Impact of deleting the project-level Prometheus integration (Beta)

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

Contact support

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

Was this page helpful?

Request docs changesAsk the community