TiDB CloudとDatadogを統合する
TiDB CloudはDatadogとの連携をサポートしています。TiDB Cloudを設定することで、TiDBクラスタに関するメトリクスをデータドッグに送信できます。その後、これらのメトリクスをDatadogダッシュボードで直接確認できます。
Datadog統合バージョン
TiDB Cloudは、2022年3月4日よりプロジェクトレベルのDatadog統合（ベータ版）をサポートしてきました。2025年7月31日より、TiDB CloudレベルのDatadog統合（プレビュー版）を導入します。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 Dedicatedクラスターでのみ利用可能です。
クラスターの状態が「作成中」 、 「復元中」 、 「一時停止中」 、 「再開中」の場合は、Datadog の統合は利用できません。
Datadogとの統合が設定されているクラスターが削除されると、それに関連付けられている統合サービスも削除されます。
手順
ステップ1. Datadog APIキーと連携する
Datadog統合バージョンに応じて、統合ページにアクセスする手順は異なります。
TiDB Cloudコンソールで、私のTiDBページに移動し、ターゲットのTiDB Cloud Dedicatedクラスターの名前をクリックして、その概要ページに移動します。
左側のナビゲーションペインで、 [設定] > [統合]をクリックします。
統合ページで、 「Datadogへの統合」をクリックします。
Datadog APIキーを入力し、Datadogサイトを選択してください。
「統合テスト」をクリックします。
- テストが成功すると、 「確認」ボタンが表示されます。
- テストが失敗した場合は、エラーメッセージが表示されます。メッセージに従ってトラブルシューティングを行い、統合を再試行してください。
統合を完了するには、 「確認」をクリックしてください。
TiDB Cloudコンソールで、組織の私のTiDBページに移動し、 [プロジェクト ビュー]タブをクリックします。
プロジェクトビューで、対象のプロジェクトを見つけて、そのプロジェクトのをクリックします。
左側のナビゲーションペインで、 「プロジェクト設定」の下にある「統合」をクリックします。
統合ページで、 [Datadogとの統合（ベータ版）]をクリックします。
Datadog APIキーを入力し、Datadogサイトを選択してください。
「統合テスト」をクリックします。
- テストが成功すると、 「確認」ボタンが表示されます。
- テストが失敗した場合は、エラーメッセージが表示されます。メッセージに従ってトラブルシューティングを行い、統合を再試行してください。
統合を完了するには、 「確認」をクリックしてください。
ステップ2. DatadogにTiDB Cloud統合をインストールする
注記：
Datadog にTiDB Cloud統合をすでにインストールしている場合は、このセクションの次の手順をスキップできます。 TiDB CloudダイナミックトラッカーまたはTiDB Cloudクラスタの概要ダッシュボードは、Datadog ダッシュボード一覧で自動的に利用可能になります。
データドッグにログインします。
Datadog のTiDB Cloud統合ページに移動します。
「コンフィグレーション」タブで、 「統合のインストール」をクリックします。
- クラスターレベルの Datadog 統合の場合、 TiDB Cloudダイナミックトラッカーダッシュボードがダッシュボード一覧に表示されます。
- 従来のプロジェクト レベルの Datadog 統合 (ベータ版) の場合、 TiDB Cloudクラスタの概要ボードダッシュボード一覧に表示されます。
事前に構築されたダッシュボードをビュー
TiDB Cloudコンソールで、 「統合」ページに移動します。
Datadogセクションの「ダッシュボード」リンクをクリックしてください。
- クラスタレベルのDatadog統合の場合、ダッシュボードリンクをクリックすると、拡張バージョンで導入された最新のメトリクスを含む新しいダッシュボードが開きます。
- 従来のプロジェクトレベルのDatadog統合（ベータ版）の場合、ダッシュボードリンクをクリックすると従来のダッシュボードが開きますが、そこにはクラスタレベルのDatadog統合で導入された最新のメトリクスは含まれていません。
Datadogで利用可能な指標
Datadogは、TiDBクラスタに関して以下のメトリクスを追跡します。
クラスタレベルのDatadog統合では、以下の追加メトリクスも利用可能です。