Monitor a TiDB Cluster

This document describes how to monitor a TiDB cluster on TiDB Cloud.

Cluster status and node status

You can see the current status of each running cluster on the cluster page.

Cluster Status

Cluster statusDescription
NormalNormal running (including data migration)
CreatingCreating the cluster
ScalingScaling the TiKV/TiDB nodes
UpgradingUpgrading the TiDB version
UnavailableThe TiDB Cloud service is not available
UnhealthyPart of nodes are unavailable, not enough replicas, and so on
RecoveringBackup recovery

TiDB node status

TiDB node statusDescription
NormalNormal running
CreatingCreating the node
UnavailableThe TiDB node is not available
TerminatingThe TiDB node is terminating

TiKV node status

TiKV node statusDescription
NormalNormal running
CreatingCreating the node
UnavailableThe TiKV node is not available
TerminatingThe TiKV node is terminating
LeavingMigrating the current node data before termination

Monitoring metrics

On the Overview page of the cluster, you can view the commonly used metrics of the cluster.

  1. Navigate to the TiDB Cluster list page.

  2. Click the name of the selected cluster, and go to the Overview page of the cluster.

    Currently, the metrics include Total QPS, Latency, Connections, Storage Size, TiDB CPU, TiKV CPU, TiKV IO Read, and TiKV IO Write.