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

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 にインポートする必要があります。

  1. インスタンスタイプに対応する Datadog ダッシュボード JSON ファイルをダウンロードします。

    https://github.com/pingcap/docs/blob/master/tidb-cloud/monitor-datadog-integration-tidb-cloud-dynamic-tracker-essential.json

  2. Datadog にログインし、Dashboards > Dashboard List に移動します。

  3. 右上の + New Dashboard をクリックします。ダッシュボード名を入力し、Start from blank dashboard を選択します。

  4. 新しいダッシュボードで、右上の歯車アイコン (Configure) をクリックし、Import dashboard JSON... を選択します。

  5. 表示されるダイアログで、JSON の内容を貼り付けるか、JSON ファイルをドラッグアンドドロップします。

  6. Yes, Replace をクリックしてインポートを確定します。

手順 2. Datadog API key と統合する

  1. TiDB Cloud console で My TiDB ページに移動し、対象の TiDB Cloud Essential インスタンス名をクリックして概要ページを開きます。

  2. 左側のナビゲーションペインで、Integrations > Integration to Datadog (Preview) をクリックします。

  3. Datadog API key を入力し、Datadog Region を選択します。

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

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

  5. Confirm をクリックして統合を完了します。

事前構築済みダッシュボードを表示する

統合後に事前構築済みダッシュボードを表示するには、Datadog で Dashboards > Dashboard List に移動し、手順 1 でインポートしたダッシュボードを選択します。ダッシュボードページでは、対象のインスタンス名でフィルタリングしてメトリクスを表示できます。

また、TiDB Cloud console から Datadog の Dashboard List ページにアクセスすることもできます。対象インスタンスの Integrations ページに移動し、Datadog (Preview) をクリックしてから Dashboard をクリックします。

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

Datadog は、TiDB Cloud Essential インスタンスについて、以下のメトリクスを追跡します。

メトリック名メトリックタイプラベル説明
tidb_cloud.db_total_connectiongaugeinstance_id: <instance id>
instance_name: <instance name>		TiDB server における現在の接続数
tidb_cloud.db_active_connectionsgaugeinstance_id: <instance id>
instance_name: <instance name>		アクティブな接続数
tidb_cloud.db_disconnectionsgaugeresult: Error\|...
instance_id: <instance id>
instance_name: <instance name>		接続結果ごとに切断されたクライアント数
tidb_cloud.db_database_timegaugesql_type: Select\|Insert\|...
instance_id: <instance id>
instance_name: <instance name>		TiDB で実行中のすべての SQL 文が 1 秒あたりに消費した合計時間。すべてのプロセスの CPU 時間と、アイドル状態ではない待機時間を含みます
tidb_cloud.db_query_per_secondgaugetype: Select\|Insert\|...
instance_id: <instance id>
instance_name: <instance name>		文の種類ごとに集計された、1 秒あたりに実行された SQL 文の数
tidb_cloud.db_failed_queriesgaugetype: planner:xxx\|executor:2345\|...
instance_id: <instance id>
instance_name: <instance name>		SQL 文の実行時に 1 秒あたりに発生したエラー種別（構文エラーや主キー競合など）の統計
tidb_cloud.db_command_per_secondgaugetype: Query\|Ping\|...
instance_id: <instance id>
instance_name: <instance name>		TiDB が 1 秒あたりに処理したコマンド数
tidb_cloud.db_queries_using_plan_cache_opsgaugeinstance_id: <instance id>
instance_name: <instance name>		1 秒あたりに実行計画キャッシュにヒットしたクエリ数
tidb_cloud.db_average_query_durationgaugesql_type: Select\|Insert\|...
instance_id: <instance id>
instance_name: <instance name>		ネットワークリクエストが TiDB に送信されてから、レスポンスがクライアントに返されるまでの時間
tidb_cloud.db_transaction_per_secondgaugetype: Commit\|Rollback\|...
txn_mode: optimistic\|pessimistic
instance_id: <instance id>
instance_name: <instance name>		1 秒あたりに実行されたトランザクション数
tidb_cloud.db_row_storage_used_bytesgaugeinstance_id: <instance id>
instance_name: <instance name>		TiDB Cloud Essential インスタンスの行ベースストレージサイズ（バイト）
tidb_cloud.db_columnar_storage_used_bytesgaugeinstance_id: <instance id>
instance_name: <instance name>		TiDB Cloud Essential インスタンスのカラムナー ストレージサイズ（バイト）。TiFlash が有効でない場合は 0 を返します
tidb_cloud.resource_manager_resource_request_unit_totalgaugeinstance_id: <instance id>
instance_name: <instance name>		消費された合計 Request Units/s (RU/s)

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