📣
TiDB Cloud Premium はパブリックプレビュー中です。エンタープライズワークロード向けの無制限のスケーリング、即時の弾力性、高度なセキュリティを提供します。このページは自動翻訳されたものです。原文はこちらからご覧ください。
AI
開発者
ベストプラクティス
API

TiDB CloudとDatadogを統合する

TiDB CloudはDatadogとの連携をサポートしています。TiDB Cloudを設定することで、TiDBクラスタに関するメトリクスをDatadogに送信できます。その後、これらのメトリクスを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インスタンスでは利用できません。

  • クラスターの状態が作成中 、 復元中 、 一時停止中 、 再開中の場合は、Datadog の統合は利用できません。

  • Datadogとの統合が設定されているクラスターが削除されると、それに関連付けられている統合サービスも削除されます。

手順

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

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

    1. TiDB Cloudコンソールで、My TiDBページに移動し、ターゲットのTiDB Cloud Dedicatedクラスターの名前をクリックして、その概要ページに移動します。

    2. 左側のナビゲーションペインで、 [設定] > [統合]をクリックします。

    3. 統合ページで、 Integration to Datadogをクリックします。

    4. Datadog APIキーを入力し、Datadogサイトを選択してください。

    5. Test Integrationをクリックします。

      • テストが成功すると、 確認ボタンが表示されます。
      • テストが失敗した場合は、エラーメッセージが表示されます。メッセージに従ってトラブルシューティングを行い、統合を再試行してください。

    6. 統合を完了するには、 確認をクリックしてください。

    1. TiDB Cloudコンソールで、組織のMy TiDBページに移動し、 Project viewタブをクリックします。

    2. プロジェクトビューで、対象のプロジェクトを見つけて、そのプロジェクトのをクリックします。

    3. 左側のナビゲーションペインで、 プロジェクト設定の下にあるProject Settingsをクリックします。

    4. 統合ページで、 Integration to Datadog (BETA)をクリックします。

    5. Datadog APIキーを入力し、Datadogサイトを選択してください。

    6. Test Integrationをクリックします。

      • テストが成功すると、 確認ボタンが表示されます。
      • テストが失敗した場合は、エラーメッセージが表示されます。メッセージに従ってトラブルシューティングを行い、統合を再試行してください。

    7. 統合を完了するには、 確認をクリックしてください。

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

    1. Datadogにログインします。

    2. Datadog のTiDB Cloud統合ページに移動します。

    3. コンフィグレーションタブで、 Install Integrationをクリックします。

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

    1. TiDB Cloudコンソールで、 統合ページに移動します。

    2. Datadogセクションのダッシュボードリンクをクリックしてください。

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

    Datadogで利用可能な指標

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

    メトリック名メトリックタイプラベル説明
    tidb_cloud.db_database_timeゲージsql_type: SelectInsert
    tidb_cloud.db_query_per_secondゲージタイプ: 選択挿入
    tidb_cloud.db_average_query_durationゲージsql_type: SelectInsert
    tidb_cloud.db_failed_queriesゲージタイプ: 実行者:xxxxパーサー:xxxx
    tidb_cloud.db_total_connectionゲージクラスター名: <cluster name>
    インスタンス: tidb-0    		tidb-1…
    コンポーネント: tidb
    tidb_cloud.db_active_connectionsゲージクラスター名: <cluster name>
    インスタンス: tidb-0    		tidb-1…
    コンポーネント: tidb
    tidb_cloud.db_disconnectionsゲージ結果：OK｜エラー｜不明
    クラスター名: <cluster name>
    インスタンス: tidb-0    		tidb-1…
    コンポーネント: tidb
    tidb_cloud.db_command_per_secondゲージタイプ: クエリステートメント準備
    tidb_cloud.db_queries_using_plan_cache_opsゲージクラスター名: <cluster name>
    インスタンス: tidb-0    		tidb-1…
    コンポーネント: tidb
    tidb_cloud.db_transaction_per_secondゲージtxn_mode:悲観的楽観的
    タイプ: 中止
    tidb_cloud.node_storage_used_bytesゲージクラスター名: <cluster name>
    インスタンス: tikv-0    		tikv-1…
    tidb_cloud.node_storage_capacity_bytesゲージクラスター名: <cluster name>
    インスタンス: tikv-0    		tikv-1…
    tidb_cloud.node_cpu_seconds_totalカウントクラスター名: <cluster name>
    インスタンス: tidb-0    		tidb-1…
    tidb_cloud.node_cpu_capacity_coresゲージクラスター名: <cluster name>
    インスタンス: tidb-0    		tidb-1…
    tidb_cloud.node_memory_used_bytesゲージクラスター名: <cluster name>
    インスタンス: tidb-0    		tidb-1…
    tidb_cloud.node_memory_capacity_bytesゲージクラスター名: <cluster name>
    インスタンス: tidb-0    		tidb-1…

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

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

    このページは役に立ちましたか？