📣

TiDB Cloud Serverless が
Starter
に変わりました!このページは自動翻訳されたものです。
原文はこちらからご覧ください。

TiDB CloudとDatadogの統合

TiDB CloudはDatadogとの連携をサポートしています。TiDB 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日までに組織内でレガシープロジェクトレベルの Datadog または New Relic 統合が少なくとも1つ削除されていない場合、 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のプロジェクト内のターゲットクラスターにアクセスするためのProject Viewer以上のロールが必要です。

制限

  • TiDB CloudスターターまたはTiDB Cloudエッセンシャルクラスターでは Datadog 統合を使用できません。

  • クラスターのステータスがCREATINGRESTORINGPAUSED 、またはRESUMINGの場合、Datadog 統合は使用できません。

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

手順

ステップ1. Datadog APIキーとの統合

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

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

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

    3. 「統合」ページで、 「Datadog への統合」をクリックします。

    4. Datadog API キーを入力し、Datadog サイトを選択します。

    5. [統合のテスト]をクリックします。

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

    1. TiDB Cloudコンソールで、左上隅のコンボ ボックスを使用してターゲット プロジェクトに切り替えます。

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

    3. [統合]ページで、 [Datadog への統合 (ベータ版)]をクリックします。

    4. Datadog API キーを入力し、Datadog サイトを選択します。

    5. [統合のテスト]をクリックします。

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

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

    注記:

    DatadogにTiDB Cloud統合を既にインストールしている場合は、このセクションの以下の手順をスキップできます。ダッシュボードTiDB Cloudダイナミック トラッカーまたはTiDB Cloudクラスタの概要 、Datadog ダッシュボードリストで自動的に利用可能になります。

    1. データドッグにログインします。

    2. Datadog のTiDB Cloud統合ページへ進みます。

    3. [コンフィグレーション]タブで、 [統合のインストール]クリックします。

    あらかじめ構築されたダッシュボードをビュー

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

    2. Datadogセクションのダッシュボードリンクをクリックします。

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

    Datadogで利用可能なメトリクス

    Datadog は、TiDB クラスターの次のメトリクスを追跡します。

    メトリック名メトリックタイプラベル説明
    tidb_cloud.db_database_timeゲージsql_type: 選択挿入
    tidb_cloud.db_query_per_secondゲージタイプ: 選択挿入
    tidbcloud.db平均クエリ実行時間ゲージsql_type: 選択挿入
    tidb_cloud.db_failed_queriesゲージタイプ: executor:xxxxparser: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エラー
    tidb_cloud.db_command_per_secondゲージタイプ: QueryStmtPrepare
    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>
    devicenvme.*\|dm.*
    storageデバイスあたりの読み取りレイテンシー(秒)。
    tidb_cloud.node_disk_write_latencyゲージインスタンス: tidb-0\|tidb-1\|...
    コンポーネント: tikv\|tiflash
    クラスター名: <cluster name>
    devicenvme.*\|dm.*
    storageデバイスあたりの書き込みレイテンシー(秒)。
    tidb_cloud.db_kv_request_durationゲージインスタンス: tidb-0\|tidb-1\|...
    コンポーネント: tikv
    クラスター名: <cluster name>
    typeBatchGet\|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)ゲージチェンジフィードID: <changefeed-id>
    クラスター名: <cluster name>
    変更フィード所有者のチェックポイント タイムスタンプの遅延 (秒単位)。
    tidb_cloud.cdc_changefeed_resolved_ts_lagゲージチェンジフィードID: <changefeed-id>
    クラスター名: <cluster name>
    変更フィード所有者の解決されたタイムスタンプの遅延 (秒単位)。
    tidb_cloud.cdc_changefeed_statusゲージチェンジフィード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ゲージチェンジフィードID: <changefeed-id>
    クラスター名: <cluster name>
    TiCDC ノードが 1 秒あたりにダウンストリームに書き込むイベントの数。

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