TiDB CloudとDatadogを統合する

TiDB CloudはDatadogとの連携をサポートしています。TiDB Cloudを設定することで、TiDBクラスタに関するメトリクスをDatadogに送信できます。その後、これらのメトリクスをDatadogダッシュボードで直接確認できます。

ノート

このドキュメントは TiDB Cloud Dedicated にのみ適用されます。

TiDB Cloud Starter では、Datadog 統合は利用できません。 TiDB Cloud Essential については、Integrate TiDB Cloud Essential with Datadog を参照してください。 TiDB Cloud Premium については、Integrate TiDB Cloud Premium with Datadog を参照してください。

Datadog統合バージョン

TiDB Cloudは、2022年3月4日よりプロジェクトレベルのDatadog統合（ベータ版）をサポートしてきました。2025年7月31日より、TiDB CloudレベルのDatadog統合（PREVIEW）を導入します。2025年9月30日より、クラスターレベルのDatadog統合が一般提供（GA）となります。

クラスタレベルのDatadog統合：2025年7月31日までに組織内に削除されていない従来のプロジェクトレベルのDatadogまたはNew Relic統合が残っていない場合、 TiDB Cloudは組織が最新の機能強化を体験できるように、クラスタレベルのDatadog統合を提供します。
従来のプロジェクトレベルの Datadog 統合 (ベータ版) : 2025年 7月 31日時点で組織内に少なくとも 1つの従来のプロジェクトレベルの Datadog または New Relic 統合が削除されずに残っている場合、 TiDB Cloudは、現在のダッシュボードへの影響を回避するために、組織向けにプロジェクトレベルで既存および新規の統合の両方を保持します。従来のプロジェクトレベルの Datadog 統合は、2025年 10月 31日に廃止されました。組織がこれらの従来の統合をまだ使用している場合は、DatadogとNew Relicの統合を移行する手順に従って、新しいクラスタレベルの統合に移行し、メトリクス関連サービスへの影響を最小限に抑えてください。

前提条件

TiDB CloudをDatadogと連携させるには、DatadogアカウントとDatadog APIキーが必要です。Datadogアカウントを初めて作成すると、DatadogからAPIキーが発行されます。
Datadogアカウントをお持ちでない場合は、 https://app.datadoghq.com/signupでサインアップしてください。
TiDB Cloudのサードパーティメトリクス統合を設定するには、 TiDB CloudでOrganization OwnerまたはProject Ownerアクセス権が必要です。統合ページを表示したり、提供されたリンクから設定済みのダッシュボードにアクセスしたりするには、TiDB Cloudのプロジェクト内の対象のTiDB Cloud DedicatedクラスターにアクセスするためのProject Viewerロール以上が必要です。

制限

Datadog統合は、TiDB Cloud Starterインスタンスでは利用できません。
クラスターの状態がCREATING 、 RESTORING 、 PAUSED 、 RESUMINGの場合は、Datadog の統合は利用できません。
Datadogとの統合が設定されているクラスターが削除されると、それに関連付けられている統合サービスも削除されます。

手順

ステップ1. Datadog APIキーと連携する

Datadog統合バージョンに応じて、統合ページにアクセスする手順は異なります。

TiDB Cloudコンソールで、My TiDBページに移動し、ターゲットのTiDB Cloud Dedicatedクラスターの名前をクリックして、その概要ページに移動します。
左側のナビゲーションペインで、 Settings > Integrationsをクリックします。
Integrationsページで、 Integration to Datadogをクリックします。
Datadog APIキーを入力し、Datadogサイトを選択してください。
Test Integrationをクリックします。
- テストが成功すると、 Confirmボタンが表示されます。
- テストが失敗した場合は、エラーメッセージが表示されます。メッセージに従ってトラブルシューティングを行い、統合を再試行してください。
統合を完了するには、 Confirmをクリックしてください。

TiDB Cloudコンソールで、組織のMy TiDBページに移動し、 Project viewタブをクリックします。
プロジェクトビューで、対象のプロジェクトを見つけて、そのプロジェクトのをクリックします。
左側のナビゲーションペインで、 Project Settingsの下にあるIntegrationsをクリックします。
Integrationsページで、 Integration to Datadog (BETA)をクリックします。
Datadog APIキーを入力し、Datadogサイトを選択してください。
Test Integrationをクリックします。
- テストが成功すると、 Confirmボタンが表示されます。
- テストが失敗した場合は、エラーメッセージが表示されます。メッセージに従ってトラブルシューティングを行い、統合を再試行してください。
統合を完了するには、 Confirmをクリックしてください。

ステップ2. DatadogにTiDB Cloud統合をインストールする

ノート

Datadog にTiDB Cloud統合をすでにインストールしている場合は、このセクションの次の手順をスキップできます。 TiDB Cloud Dynamic TrackerまたはTiDB Cloud Cluster Overviewダッシュボードは、Datadog Dashboard Listで自動的に利用可能になります。

Datadogにログインします。
Datadog のTiDB Cloud統合ページに移動します。
Configurationタブで、 Install Integrationをクリックします。
- クラスターレベルの Datadog 統合の場合、 TiDB Cloud Dynamic TrackerダッシュボードがDashboard Listに表示されます。
- 従来のプロジェクトレベルの Datadog 統合 (ベータ版) の場合、 TiDB Cloud Cluster OverviewダッシュボードがDashboard Listに表示されます。

事前に構築されたダッシュボードを確認する

TiDB Cloudコンソールで、 Integrationsページに移動します。
DatadogセクションのDashboardリンクをクリックしてください。
- クラスタレベルのDatadog統合の場合、Dashboardリンクをクリックすると、拡張バージョンで導入された最新のメトリクスを含む新しいダッシュボードが開きます。
- 従来のプロジェクトレベルのDatadog統合（ベータ版）の場合、Dashboardリンクをクリックすると従来のダッシュボードが開きますが、そこにはクラスタレベルのDatadog統合で導入された最新のメトリクスは含まれていません。

Datadogで利用可能な指標

Datadogは、TiDBクラスタに関して以下のメトリクスを追跡します。

メトリック名	メトリックタイプ	ラベル	説明
tidb_cloud.db_database_time	gauge	sql_type: Select\|Insert\|... cluster_name: `<cluster name>` instance: tidb-0\|tidb-1… component: `tidb`	TiDBで実行されているすべてのSQL文が1秒あたりに消費する合計時間。これには、すべてのプロセスのCPU時間と、アイドル状態ではない待機時間が含まれます。
tidb_cloud.db_query_per_second	gauge	type: Select\|Insert\|... cluster_name: `<cluster name>` instance: tidb-0\|tidb-1… component: `tidb`	すべての TiDB ノードで 1秒あたりに実行される SQL文の数。文の種類 ( `SELECT` 、 `INSERT` 、または`UPDATE` ) ごとにカウントされます。
tidb_cloud.db_average_query_duration	gauge	sql_type: Select\|Insert\|... cluster_name: `<cluster name>` instance: tidb-0\|tidb-1… component: `tidb`	クライアントのネットワークリクエストがTiDBに送信されてから、TiDBがリクエストを実行した後、クライアントにリクエストが返されるまでの時間。
tidb_cloud.db_failed_queries	gauge	type: executor:xxxx\|parser:xxxx\|... cluster_name: `<cluster name>` instance: tidb-0\|tidb-1… component: `tidb`	各TiDBノードで1秒あたりに発生するSQL実行エラーに基づいた、エラーの種類（構文エラーや主キーの競合など）の統計情報。
tidb_cloud.db_total_connection	gauge	cluster_name: `<cluster name>` instance: tidb-0\|tidb-1… component: `tidb`	TiDBサーバーにおける現在の接続数。
tidb_cloud.db_active_connections	gauge	cluster_name: `<cluster name>` instance: tidb-0\|tidb-1… component: `tidb`	アクティブな接続数。
tidb_cloud.db_disconnections	gauge	result: ok\|error\|undetermined cluster_name: `<cluster name>` instance: tidb-0\|tidb-1… component: `tidb`	接続が切断されたクライアントの数。
tidb_cloud.db_command_per_second	gauge	type: Query\|StmtPrepare\|... cluster_name: `<cluster name>` instance: tidb-0\|tidb-1… component: `tidb`	TiDBが1秒間に処理するコマンド数。コマンド実行結果の成否に応じて分類されます。
tidb_cloud.db_queries_using_plan_cache_ops	gauge	cluster_name: `<cluster name>` instance: tidb-0\|tidb-1… component: `tidb`	プランキャッシュを使用したクエリの 1秒あたりの統計。実行プランキャッシュは、プリペアドステートメントコマンドのみをサポートします。
tidb_cloud.db_transaction_per_second	gauge	txn_mode: pessimistic\|optimistic type: abort\|commit\|... cluster_name: `<cluster name>` instance: tidb-0\|tidb-1… component: `tidb`	1秒あたりに実行されるトランザクション数。
tidb_cloud.node_storage_used_bytes	gauge	cluster_name: `<cluster name>` instance: tikv-0\|tikv-1…\|tiflash-0\|tiflash-1… component: tikv\|tiflash	TiKV またはTiFlashノードのディスク使用量（バイト単位）。このメトリックは主にストレージエンジンの論理データサイズを表し、WAL ファイルと一時ファイルは除外されます。実際のディスク使用率を計算するには、代わりに`(capacity - available) / capacity`を使用してください。TiKV のストレージ使用率が 80% を超えると、レイテンシーの急増が発生する可能性があり、使用率が高くなるとリクエストが失敗する可能性があります。すべてのTiFlashノードのストレージ使用率が 80% に達すると、 TiFlashレプリカを追加する DDL文は無期限にハングします。
tidb_cloud.node_storage_capacity_bytes	gauge	cluster_name: `<cluster name>` instance: tikv-0\|tikv-1…\|tiflash-0\|tiflash-1… component: tikv\|tiflash	TiKV/ TiFlashノードのディスク容量（バイト単位）。
tidb_cloud.node_cpu_seconds_total	count	cluster_name: `<cluster name>` instance: tidb-0\|tidb-1…\|tikv-0…\|tiflash-0… component: tidb\|tikv\|tiflash	TiDB/TiKV/ TiFlashノードのCPU使用率。
tidb_cloud.node_cpu_capacity_cores	gauge	cluster_name: `<cluster name>` instance: tidb-0\|tidb-1…\|tikv-0…\|tiflash-0… component: tidb\|tikv\|tiflash	TiDB/TiKV/ TiFlashノードのCPUコア数の制限。
tidb_cloud.node_memory_used_bytes	gauge	cluster_name: `<cluster name>` instance: tidb-0\|tidb-1…\|tikv-0…\|tiflash-0… component: tidb\|tikv\|tiflash	TiDB/TiKV/ TiFlashノードで使用されているメモリ（バイト単位）。
tidb_cloud.node_memory_capacity_bytes	gauge	cluster_name: `<cluster name>` instance: tidb-0\|tidb-1…\|tikv-0…\|tiflash-0… component: tidb\|tikv\|tiflash	TiDB/TiKV/ TiFlashノードのメモリ容量（バイト単位）。

クラスタレベルのDatadog統合では、以下の追加メトリクスも利用可能です。

メトリック名	メトリックタイプ	ラベル	説明
tidb_cloud.node_storage_available_bytes	gauge	instance: `tidb-0\\|tidb-1\\|...` component: `tikv\\|tiflash` cluster_name: `<cluster name>`	TiKV/ TiFlashノードで使用可能なディスク容量（バイト単位）。
tidb_cloud.node_disk_read_latency	gauge	instance: `tidb-0\\|tidb-1\\|...` component: `tikv\\|tiflash` cluster_name: `<cluster name>` `device`: `nvme.\\|dm.`	ストレージデバイスごとの読み取りレイテンシー（秒）。
tidb_cloud.node_disk_write_latency	gauge	instance: `tidb-0\\|tidb-1\\|...` component: `tikv\\|tiflash` cluster_name: `<cluster name>` `device`: `nvme.\\|dm.`	ストレージデバイスごとの書き込みレイテンシー（秒）。
tidb_cloud.db_kv_request_duration	gauge	instance: `tidb-0\\|tidb-1\\|...` component: `tikv` cluster_name: `<cluster name>` `type`: `BatchGet\\|Commit\\|Prewrite\\|...`	TiKVリクエストの種類別の所要時間（秒）。
tidb_cloud.db_component_uptime	gauge	instance: `tidb-0\\|tidb-1\\|...` component: `tidb\\|tikv\\|tiflash` cluster_name: `<cluster name>`	TiDBコンポーネントの稼働時間（秒単位）。
tidb_cloud.cdc_changefeed_latency (別名 cdc_changefeed_checkpoint_ts_lag)	gauge	changefeed_id: `<changefeed-id>` クラスター名: `<cluster name>`	変更フィード所有者のチェックポイントタイムスタンプの遅延（秒単位）。
tidb_cloud.cdc_changefeed_resolved_ts_lag	gauge	changefeed_id: `<changefeed-id>` cluster_name: `<cluster name>`	変更フィード所有者の解決済みタイムスタンプ遅延（秒単位）。
tidb_cloud.cdc_changefeed_status	gauge	changefeed_id: `<changefeed-id>` cluster_name: `<cluster name>`	変更フィードのステータス: `-1` : Unknown `0` : Normal `1` : Warning `2` : Failed `3` : Stopped `4` : Finished `6` : Warning `7` : Other
tidb_cloud.resource_manager_resource_unit_read_request_unit	gauge	cluster_name: `<cluster name>` resource_group: `<group-name>`	リソースマネージャによって消費された読み取りリクエストユニット（RU）。
tidb_cloud.resource_manager_resource_unit_write_request_unit	gauge	cluster_name: `<cluster name>` resource_group: `<group-name>`	リソースマネージャによって消費される書き込みリクエストユニット（RU）。
tidb_cloud.dm_task_state	gauge	instance: `instance` task: `task` cluster_name: `<cluster name>`	データ移行のタスク状態: 0: 無効 1: 新着 2：ランニング 3：一時停止 4：停止 5：完了 15: エラー
tidb_cloud.dm_syncer_replication_lag_bucket	gauge	instance: `instance` cluster_name: `<cluster name>`	データ移行の遅延（バケット）を複製します。
tidb_cloud.dm_syncer_replication_lag_gauge	gauge	instance: `instance` task: `task` cluster_name: `<cluster name>`	データ移行の遅延（gauge）を複製します。
tidb_cloud.dm_relay_read_error_count	gauge	instance: `instance` cluster_name: `<cluster name>`	マスターからのbinlogの読み取りに失敗しました。
tidb_cloud.node_memory_available_bytes	gauge	cluster_name: `<cluster name>` instance: tidb-0\|tidb-1…\|tikv-0…\|tiflash-0… component: tidb\|tikv\|tiflash	TiDB/TiKV/ TiFlashノードで使用可能なメモリ（バイト単位）。
tidb_cloud.cdc_changefeed_replica_rows	gauge	changefeed_id: `<changefeed-id>` cluster_name: `<cluster name>`	TiCDCノードが1秒あたりにダウンストリームに書き込むイベントの数。