TiDB CloudとDatadogを統合する (PREVIEW)
TiDB Cloud は Datadog との統合をサポートしています。TiDB Cloud を設定して、TiDB Cloud Essential インスタンスのメトリクスを Datadog に送信できます。設定後は、これらのメトリクスを Datadog のダッシュボードで直接表示できます。
前提条件
TiDB Cloud を Datadog と統合するには、Datadog アカウントと Datadog API key が必要です。Datadog アカウントを初めて作成すると、Datadog から API key が付与されます。
Datadog アカウントを持っていない場合は、https://app.datadoghq.com/signup でサインアップしてください。
TiDB Cloud でサードパーティメトリクス統合を設定するには、TiDB Cloud で
Organization Owner、Project Owner、またはInstance Managerのアクセス権限が必要です。統合ページを表示するには、少なくともProject ViewerまたはInstance Viewerロールが必要であり、TiDB Cloud の組織配下にある対象の TiDB Cloud Essential インスタンスにアクセスできる必要があります。
制限事項
- Datadog integration は TiDB Cloud Starter インスタンスでは利用できません。
- 対象の TiDB Cloud Essential インスタンスのステータスが CREATING、RESTORING、PAUSED、または RESUMING の場合、Datadog integration は利用できません。
手順
手順 1. 事前構築済み Datadog ダッシュボードをインポートする
現在、TiDB Cloud Essential 用の TiDB Cloud ダッシュボードは、Datadog integration marketplace ではまだ利用できません。ダッシュボード JSON ファイルを手動でダウンロードし、Datadog にインポートする必要があります。
インスタンスタイプに対応する Datadog ダッシュボード JSON ファイルをダウンロードします。
- 2026 年 7 月 1 日以降に作成された TiDB Cloud Essential インスタンスの場合は、この JSON ファイルをダウンロードします: https://github.com/pingcap/docs/blob/master/tidb-cloud/monitor-datadog-integration-tidb-cloud-dynamic-tracker-essential-v2.json。
v2サフィックスは、ダッシュボード JSON ファイルのバージョンのみを示すことに注意してください。 - 2026 年 7 月 1 日より前に作成された TiDB Cloud Essential インスタンスの場合は、この JSON ファイルをダウンロードします: https://github.com/pingcap/docs/blob/master/tidb-cloud/monitor-datadog-integration-tidb-cloud-dynamic-tracker-essential.json。
- 2026 年 7 月 1 日以降に作成された TiDB Cloud Essential インスタンスの場合は、この JSON ファイルをダウンロードします: https://github.com/pingcap/docs/blob/master/tidb-cloud/monitor-datadog-integration-tidb-cloud-dynamic-tracker-essential-v2.json。
Datadog にログインし、Dashboards > Dashboard List に移動します。
右上の + New Dashboard をクリックします。ダッシュボード名を入力し、Start from blank dashboard を選択します。
新しいダッシュボードで、右上の歯車アイコン (Configure) をクリックし、Import dashboard JSON... を選択します。
表示されるダイアログで、JSON の内容を貼り付けるか、JSON ファイルをドラッグアンドドロップします。
Yes, Replace をクリックしてインポートを確定します。
手順 2. Datadog API key と統合する
TiDB Cloud console で My TiDB ページに移動し、対象の TiDB Cloud Essential インスタンス名をクリックして概要ページを開きます。
左側のナビゲーションペインで、Integrations をクリックします。
Integrations ページで、Datadog (PREVIEW) 統合を見つけて Connect をクリックします。
Datadog API key を入力し、Datadog リージョンを選択してから、Test Integration をクリックします。
- テストが成功すると、Confirm ボタンが表示されます。
- テストが失敗すると、エラーメッセージが表示されます。メッセージに従ってトラブルシューティングを行い、再度統合を試してください。
Confirm をクリックして統合を完了します。
事前構築済みダッシュボードを表示する
統合後に事前構築済みダッシュボードを表示するには、Datadog で Dashboards > Dashboard List に移動し、手順 1 でインポートしたダッシュボードを選択します。ダッシュボードページでは、対象のインスタンス名でフィルタリングしてメトリクスを表示できます。
また、TiDB Cloud console から Datadog の Dashboard List ページにアクセスすることもできます。対象インスタンスの Integrations ページに移動し、Datadog (PREVIEW) をクリックしてから Dashboard をクリックします。
Datadog で利用可能なメトリクス
Datadog は、TiDB Cloud Essential インスタンスについて、以下のメトリクスを追跡します。