TiDB Cloud をPrometheus および Grafana と統合する
TiDB Cloudはプロメテウス APIエンドポイントを提供します。Prometheusサービスをお持ちの場合は、エンドポイントからTiDB Cloudの主要なメトリクスを簡単に監視できます。
このドキュメントでは、TiDB Cloudエンドポイントから主要なメトリックを読み取るように Prometheus サービスを構成する方法と、 グラファナ使用してメトリックを表示する方法について説明します。
Prometheus統合バージョン
TiDB Cloudは、 2022年3月15日よりプロジェクトレベルのPrometheus統合（ベータ版）をサポートしています。2025年10月21日より、 TiDB CloudはクラスターレベルのPrometheus統合（プレビュー版）を導入します。2025年12月2日より、クラスターレベルのPrometheus統合が一般提供（GA）されます。
クラスター レベルの Prometheus 統合: 2025 年 10 月 21 日までに組織内に削除されていないレガシー プロジェクト レベルの Prometheus 統合がない場合、 TiDB Cloud は、組織が最新の機能強化を体験できるように、クラスター レベルの Prometheus 統合を提供します。
レガシー プロジェクト レベルの Prometheus 統合 (ベータ版) : 2025 年 10 月 21 日までに組織内で少なくとも 1 つのレガシー プロジェクト レベルの Prometheus 統合が削除されずに残っている場合、 TiDB Cloud は、現在のダッシュボードに影響を与えないように、組織のプロジェクト レベルで既存と新規の両方の統合を保持します。
注記
従来のプロジェクト レベルの Prometheus 統合は、2026 年 1 月 9 日に廃止されます。組織でこれらの従来の統合をまだ使用している場合は、手順Prometheus統合の移行に従って新しいクラスター レベルの統合に移行し、メトリクス関連サービスの中断を最小限に抑えてください。
前提条件
TiDB Cloud をPrometheus と統合するには、セルフホスト型またはマネージド型の Prometheus サービスが必要です。
TiDB Cloudのサードパーティメトリクス統合を設定するには、 TiDB Cloudの
Organization OwnerまたはProject Ownerアクセス権が必要です。統合ページを表示するには、 TiDB Cloudのプロジェクト内のターゲットクラスターにアクセスするためのProject Viewer以上のロールが必要です。
制限
- Prometheus と Grafana の統合は現在TiDB Cloud専用クラスターでのみ利用可能です。
- クラスターのステータスがCREATING 、 RESTORING 、 PAUSED 、またはRESUMINGの場合、Prometheus と Grafana の統合は使用できません。
手順
ステップ1. Prometheusのscrape_configファイルを取得する
Prometheus サービスがTiDB Cloudのメトリクスを読み取るように設定する前に、まずTiDB Cloudでscrape_config YAML ファイルを生成する必要があります。このscrape_configファイルには、Prometheus サービスがターゲットクラスターを監視できるようにする一意のベアラートークンが含まれています。
Prometheus統合バージョンに応じて、Prometheus のscrape_configファイルを取得して統合ページにアクセスする手順が異なります。
- TiDB Cloudコンソールで、プロジェクトのクラスターページに移動し、ターゲット クラスターの名前をクリックして概要ページに移動します。
- 左側のナビゲーション ペインで、 [設定] > [統合]をクリックします。
- 「統合」ページで、 「Prometheus への統合」をクリックします。
- [ファイルの追加]をクリックすると、現在のクラスターの
scrape_configファイルを生成して表示します。 - 後で使用するために、
scrape_configファイルの内容のコピーを作成します。
- TiDB Cloudコンソールで、左上隅のコンボ ボックスを使用してターゲット プロジェクトに切り替えます。
- 左側のナビゲーション ペインで、 [プロジェクト設定] > [統合]をクリックします。
- 「統合」ページで、 「Prometheus への統合 (ベータ版)」をクリックします。
- 「ファイルの追加」をクリックすると、現在のプロジェクトの scrape_config ファイルを生成して表示します。
- 後で使用するために、
scrape_configファイルの内容のコピーを作成します。
注記：
セキュリティ上の理由から、 TiDB Cloud新しく生成された
scrape_configファイルは一度しか表示されません。ファイルウィンドウを閉じる前に、必ず内容をコピーしてください。コピーを忘れた場合は、 TiDB Cloud内のscrape_configファイルを削除し、新しいファイルを生成する必要があります。5 ファイルを削除するには、ファイルを選択し、 ...scrape_configクリックしてから、削除 をクリックします。
ステップ2. Prometheusとの統合
Prometheus サービスによって指定された監視ディレクトリで、Prometheus 構成ファイルを見つけます。
たとえば、
/etc/prometheus/prometheus.yml。Prometheus 構成ファイルで、
scrape_configsセクションを見つけて、 TiDB Cloudから取得したscrape_configファイル コンテンツをそのセクションにコピーします。Prometheusサービスで、 「ステータス」 > 「ターゲット」を確認し、新しい
scrape_configファイルが読み込まれていることを確認してください。読み込まれていない場合は、Prometheusサービスを再起動する必要があるかもしれません。
ステップ3. Grafana GUIダッシュボードを使用してメトリックを視覚化する
Prometheus サービスがTiDB Cloudからメトリックを読み取った後、Grafana GUI ダッシュボードを使用して、次のようにメトリックを視覚化できます。
Prometheus統合バージョンに応じて、 TiDB Cloud for Prometheus の Grafana ダッシュボード JSON をダウンロードするためのリンクが異なります。
メトリックを視覚化するにはこのJSONを自分のGrafana GUIにインポートする使用します。
注記：
すでに Prometheus と Grafana を使用してTiDB Cloud を監視しており、新しく利用可能になったメトリックを組み込みたい場合は、既存のダッシュボードの JSON を直接更新するのではなく、新しいダッシュボードを作成することをお勧めします。
(オプション) パネルを追加または削除したり、データ ソースを変更したり、表示オプションを変更したりして、必要に応じてダッシュボードをカスタマイズします。
Grafana の使用方法の詳細については、 Grafanaのドキュメント参照してください。
scrape_config のローテーションのベストプラクティス
データのセキュリティを向上させるには、 scrape_configファイルベアラートークンを定期的にローテーションすることが一般的なベストプラクティスです。
- ステップ1に従って、Prometheus 用の新しい
scrape_configファイルを作成します。 - 新しいファイルの内容を Prometheus 構成ファイルに追加します。
- Prometheus サービスがTiDB Cloudから引き続き読み取り可能であることを確認したら、Prometheus 構成ファイルから古い
scrape_configファイルの内容を削除します。 - プロジェクトまたはクラスターの統合ページで、対応する古い
scrape_configファイルを削除し、他のユーザーがそれを使用してTiDB Cloud Prometheus エンドポイントから読み取るのをブロックします。
Prometheusで利用可能なメトリクス
Prometheus は、TiDB クラスターの次のメトリック データを追跡します。
| メトリック名 | メトリックタイプ | ラベル | 説明 |
|---|---|---|---|
| tidbcloud_db_queries_total | カウント | SQL_type: Select\|Insert\|...クラスター名: <cluster name>インスタンス: tidb-0\|tidb-1…コンポーネント: tidb | 実行されたステートメントの合計数 |
| tidbcloud_db_failed_queries_total | カウント | タイプ: planner:xxx\|executor:2345\|...クラスター名: <cluster name>インスタンス: tidb-0\|tidb-1…コンポーネント: tidb | 実行エラーの総数 |
| tidbcloud_db_connections | ゲージ | クラスター名: <cluster name>インスタンス: tidb-0\|tidb-1…コンポーネント: tidb | TiDBサーバーの現在の接続数 |
| tidbcloud_db_query_duration_seconds | ヒストグラム | SQL_type: Select\|Insert\|...クラスター名: <cluster name>インスタンス: tidb-0\|tidb-1…コンポーネント: tidb | 発言の持続時間ヒストグラム |
| tidbcloud_changefeed_latency | ゲージ | チェンジフィードID | チェンジフィードの上流と下流の間のデータ複製のレイテンシー |
| tidbcloud_changefeed_checkpoint_ts | ゲージ | チェンジフィードID | ダウンストリームに正常に書き込まれた最大のTSO（Timestamp Oracle）を表す、チェンジフィードのチェックポイントタイムスタンプ |
| tidbcloud_changefeed_replica_rows | ゲージ | チェンジフィードID | チェンジフィードが1秒あたりに下流に書き込む複製行の数 |
| tidbcloud_node_storage_used_bytes | ゲージ | クラスター名: <cluster name>インスタンス: tikv-0\|tikv-1…\|tiflash-0\|tiflash-1…コンポーネント: tikv\|tiflash | TiKV/ TiFlashノードのディスク使用量バイト |
| tidbcloud_node_storage_capacity_bytes | ゲージ | クラスター名: <cluster name>インスタンス: tikv-0\|tikv-1…\|tiflash-0\|tiflash-1…コンポーネント: tikv\|tiflash | TiKV/ TiFlashノードのディスク容量バイト |
| tidbcloud_node_cpu_seconds_total | カウント | クラスター名: <cluster name>インスタンス: tidb-0\|tidb-1…\|tikv-0…\|tiflash-0…コンポーネント: tidb\|tikv\|tiflash | TiDB/TiKV/ TiFlashノードのCPU使用率 |
| tidbcloud_node_cpu_capacity_cores | ゲージ | クラスター名: <cluster name>インスタンス: tidb-0\|tidb-1…\|tikv-0…\|tiflash-0…コンポーネント: tidb\|tikv\|tiflash | TiDB/TiKV/ TiFlashノードのCPU制限コア |
| tidbcloud_node_memory_used_bytes | ゲージ | クラスター名: <cluster name>インスタンス: tidb-0\|tidb-1…\|tikv-0…\|tiflash-0…コンポーネント: tidb\|tikv\|tiflash | TiDB/TiKV/ TiFlashノードの使用メモリバイト |
| tidbcloud_node_memory_capacity_bytes | ゲージ | クラスター名: <cluster name>インスタンス: tidb-0\|tidb-1…\|tikv-0…\|tiflash-0…コンポーネント: tidb\|tikv\|tiflash | TiDB/TiKV/ TiFlashノードのメモリ容量バイト |
| tidbcloud_node_storage_available_bytes | ゲージ | インスタンス: tidb-0\|tidb-1\|...コンポーネント: tikv\|tiflashクラスター名: <cluster name> | TiKV/ TiFlashノードで使用可能なディスク容量（バイト単位） |
| tidbcloud_disk_read_latency | ヒストグラム | インスタンス: tidb-0\|tidb-1\|...コンポーネント: tikv\|tiflashクラスター名: <cluster name>device時nvme.*\|dm.* | storageあたりの読み取りレイテンシー（秒） |
| tidbcloud_disk_write_latency | ヒストグラム | インスタンス: tidb-0\|tidb-1\|...コンポーネント: tikv\|tiflashクラスター名: <cluster name>device時nvme.*\|dm.* | storageあたりの書き込みレイテンシー（秒） |
| tidbcloud_kv_request_duration | ヒストグラム | インスタンス: tidb-0\|tidb-1\|...コンポーネント: tikvクラスター名: <cluster name>type時BatchGet\|Commit\|Prewrite\|... | タイプ別の TiKV リクエストの継続時間（秒） |
| tidbcloud_component_uptime | ヒストグラム | インスタンス: tidb-0\|tidb-1\|...コンポーネント: tidb\|tikv\|tiflashクラスター名: <cluster name> | TiDBコンポーネントの稼働時間（秒） |
| tidbcloud_ticdc_owner_resolved_ts_lag | ゲージ | チェンジフィードID: <changefeed-id>クラスター名: <cluster name> | チェンジフィード所有者の解決されたタイムスタンプの遅延（秒） |
| tidbcloud_changefeed_status | ゲージ | チェンジフィードID: <changefeed-id>クラスター名: <cluster name> | チェンジフィードステータス:-1 : 不明0 ：正常1 : 警告2 : 失敗3 : 停止4 ：終了6 : 警告7 : その他 |
| tidbcloud_resource_manager_resource_unit_read_request_unit | ゲージ | クラスター名: <cluster name>リソースグループ: <group-name> | リソースマネージャによって消費される読み取り要求単位 |
| tidbcloud_resource_manager_resource_unit_write_request_unit | ゲージ | クラスター名: <cluster name>リソースグループ: <group-name> | リソースマネージャによって消費される書き込み要求単位 |
クラスターレベルの Prometheus 統合では、次の追加メトリックも利用できます。
| メトリック名 | メトリックタイプ | ラベル | 説明 |
|---|---|---|---|
| tidbcloud_dm_task_status | ゲージ | インスタンス: instanceタスク: taskクラスター名: <cluster name> | データ移行のタスク状態: 0: 無効 1: 新しい 2: ランニング 3: 一時停止 4: 停止 5: 完了 15: エラー |
| tidbclouddm_syncerレプリケーションラグバケット | ゲージ | インスタンス: instanceクラスター名: <cluster name> | データ移行の遅延 (バケット) を複製します。 |
| tidbclouddm_syncerレプリケーションラグゲージ | ゲージ | インスタンス: instanceタスク: taskクラスター名: <cluster name> | データ移行の遅延 (ゲージ) を複製します。 |
| tidbcloud_dm_relay_read_error_count | カウント | インスタンス: instanceクラスター名: <cluster name> | マスターからbinlogを読み取る試行が失敗した回数。 |
FAQ
同じメトリックが Grafana とTiDB Cloudコンソールで同時に異なる値になるのはなぜですか?
GrafanaとTiDB Cloudでは集計ロジックが異なるため、表示される集計値が異なる場合があります。Grafanaの
mini step設定を調整することで、よりきめ細かなメトリック値を取得できます。