TiDB Cloudを Prometheus および Grafana と統合 (ベータ版)

TiDB Cloud はプロメテウス API エンドポイント (ベータ版) を提供します。 Prometheus サービスをお持ちの場合は、 TiDB Cloudの主要なメトリクスをエンドポイントから簡単に監視できます。

このドキュメントでは、 TiDB Cloudエンドポイントから主要なメトリクスを読み取るように Prometheus サービスを構成する方法と、 グラファナ使用してメトリクスを表示する方法について説明します。

前提条件

  • TiDB Cloudを Prometheus と統合するには、セルフホスト型またはマネージド型の Prometheus サービスが必要です。

  • TiDB Cloudのサードパーティ統合設定を編集するには、組織へのOrganization Ownerアクセス権、またはTiDB Cloudのターゲット プロジェクトへのProject Memberアクセス権が必要です。

制限

  • TiDB サーバーレスクラスターでは Prometheus と Grafana の統合を使用できません。

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

ステップ

ステップ1. Prometheusのscrape_configファイルを取得する

TiDB Cloudのメトリクスを読み取るように Prometheus サービスを構成する前に、まずTiDB Cloudでscrape_config YAML ファイルを生成する必要があります。 scrape_config ファイルには、Prometheus サービスが現在のプロジェクト内のデータベース クラスターを監視できるようにする一意のベアラー トークンが含まれています。

Prometheus のscrape_config ファイルを取得するには、次の手順を実行します。

  1. TiDB Cloudコンソールにログインします。

  2. クリック複数のプロジェクトがある場合は、左下隅でターゲット プロジェクトに切り替え、 [プロジェクト設定]をクリックします。

  3. プロジェクトの [**プロジェクト設定]ページで、左側のナビゲーション ペインの[統合]をクリックし、 [Prometheus への統合 (ベータ)]**をクリックします。

  4. 「ファイルの追加」をクリックして、現在のプロジェクトのscrape_configファイルを生成して表示します。

  5. 後で使用できるように、scrape_config ファイルの内容のコピーを作成します。

    注記:

    セキュリティ上の理由から、 TiDB Cloudは新しく生成されたscrape_config ファイルを 1 回だけ表示します。ファイル ウィンドウを閉じる前に、必ず内容をコピーしてください。これを忘れた場合は、 TiDB Cloudのscrape_config ファイルを削除し、新しいファイルを生成する必要があります。 Scrape_config ファイルを削除するには、ファイルを選択して[...]をクリックし、 [削除]をクリックします。

ステップ 2. Prometheus との統合

  1. Prometheus サービスによって指定された監視ディレクトリで、Prometheus 構成ファイルを見つけます。

    たとえば、 /etc/prometheus/prometheus.yml

  2. Prometheus 構成ファイルでscrape_configsセクションを見つけ、 TiDB Cloudから取得したscrape_config ファイルの内容をそのセクションにコピーします。

  3. Prometheus サービスで、 [ステータス] > [ターゲット]をチェックして、新しいscrape_config ファイルが読み取られていることを確認します。そうでない場合は、Prometheus サービスを再起動する必要がある場合があります。

ステップ 3. Grafana GUI ダッシュボードを使用してメトリクスを視覚化する

Prometheus サービスがTiDB Cloudからメトリクスを読み取った後、次のように Grafana GUI ダッシュボードを使用してメトリクスを視覚化できます。

  1. TiDB Cloud ここの Grafana ダッシュボード JSON をダウンロードします。
  2. この JSON を独自の Grafana GUI にインポートしますを指定すると、メトリクスが視覚化されます。
  3. (オプション) パネルの追加または削除、データ ソースの変更、表示オプションの変更により、必要に応じてダッシュボードをカスタマイズします。

Grafana の使用方法の詳細については、 Grafana のドキュメントを参照してください。

Scrape_config をローテーションするベスト プラクティス

データのセキュリティを向上させるには、scrape_config ファイルのベアラー トークンを定期的にローテーションすることが一般的なベスト プラクティスです。

  1. ステップ1に従って、Prometheus用の新しいscrape_configファイルを作成します。
  2. 新しいファイルの内容を Prometheus 構成ファイルに追加します。
  3. Prometheus サービスがまだTiDB Cloudから読み取ることができることを確認したら、古いscrape_config ファイルの内容を Prometheus 構成ファイルから削除します。
  4. プロジェクトの「統合」ページで、対応する古いscrape_config ファイルを削除して、他のユーザーがこのファイルを使用してTiDB Cloud Prometheus エンドポイントから読み取ることをブロックします。

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

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

メトリクス名メトリックタイプラベル説明
tidbcloud_db_queries_totalカウントSQL_type: Select\|Insert\|...
クラスター名: <cluster name>
インスタンス: tidb-0\|tidb-1…
コンポーネント: tidb
実行されたステートメントの総数
tidbcloud_db_failed_queries_totalカウントタイプ: planner:xxx\|executor:2345\|...
クラスター名: <cluster name>
インスタンス: tidb-0\|tidb-1…
コンポーネント: tidb
実行エラーの合計数
tidbcloud_db_connectionsゲージクラスター名: <cluster name>
インスタンス: tidb-0\|tidb-1…
コンポーネント: tidb
TiDBサーバーの現在の接続数
tidbclouddb_query_durationヒストグラムSQL_type: Select\|Insert\|...
クラスター名: <cluster name>
インスタンス: tidb-0\|tidb-1…
コンポーネント: tidb
ステートメントの長さのヒストグラム
tidbcloud_changefeed_latencyゲージフィードIDの変更変更フィードの上流と下流の間のデータ レプリケーションのレイテンシー
tidbcloud_changefeed_replica_rowsゲージフィードIDの変更チェンジフィードが 1 秒あたりにダウンストリームに書き込むレプリケートされた行の数
tidbcloud_node_storage_used_bytesゲージクラスター名: <cluster name>
インスタンス: tikv-0\|tikv-1…\|tiflash-0\|tiflash-1…
コンポーネント: tikv\|tiflash
TiKV/ TiFlashノードのディスク使用量バイト
tidbcloud_node_storage_capacity_bytesゲージクラスター名: <cluster name>
インスタンス: tikv-0\|tikv-1…\|tiflash-0\|tiflash-1…
コンポーネント: tikv\|tiflash
TiKV/ TiFlashノードのディスク容量バイト
tidbcloud_node_cpu_seconds_totalカウントクラスター名: <cluster name>
インスタンス: tidb-0\|tidb-1…\|tikv-0…\|tiflash-0…
コンポーネント: tidb\|tikv\|tiflash
TiDB/TiKV/ TiFlashノードの CPU 使用率
tidbcloud_node_cpu_capacity_coresゲージクラスター名: <cluster name>
インスタンス: tidb-0\|tidb-1…\|tikv-0…\|tiflash-0…
コンポーネント: tidb\|tikv\|tiflash
TiDB/TiKV/ TiFlashノードの CPU 制限コア
tidbcloud_node_memory_used_bytesゲージクラスター名: <cluster name>
インスタンス: tidb-0\|tidb-1…\|tikv-0…\|tiflash-0…
コンポーネント: tidb\|tikv\|tiflash
TiDB/TiKV/ TiFlashノードの使用メモリバイト
tidbcloud_node_memory_capacity_bytesゲージクラスター名: <cluster name>
インスタンス: tidb-0\|tidb-1…\|tikv-0…\|tiflash-0…
コンポーネント: tidb\|tikv\|tiflash
TiDB/TiKV/ TiFlashノードのメモリ容量バイト

FAQ

  • 同じメトリクスが Grafana とTiDB Cloudコンソールで同時に異なる値を持つのはなぜですか?

    Grafana とTiDB Cloudでは集計計算ロジックが異なるため、表示される集計値が異なる場合があります。 Grafana でmini step構成を調整して、より詳細なメトリック値を取得できます。

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

Playground
新規
登録なしで TiDB の機能をワンストップでインタラクティブに体験できます。
製品
TiDB Cloud
TiDB
価格
PoC お問い合わせ
エコシステム
TiKV
TiFlash
OSS Insight
© 2024 PingCAP. All Rights Reserved.
Privacy Policy.