📣新登場!TiDB Cloud BYOC、TiDB Cloud Filesystem、PostgreSQL-compatible TiDB Cloud Starter がパブリックプレビュー中。このページは自動翻訳されたものです。原文はこちらからご覧ください。

TiDB CloudとNew Relicを統合する



TiDB CloudはNew Relicとの連携をサポートしています。TiDB Cloudを設定して、TiDBクラスターのメトリクスをNew Relicに送信できます。その後、New Relicダッシュボードでこれらのメトリクスを直接確認できます。

New Relic統合バージョン

TiDB Cloudは、2023年4月11日よりプロジェクトレベルのNew Relic統合(ベータ版)をサポートしてきました。2025年7月31日より、クラスターレベルのNew Relic統合(PREVIEW)を導入します。2025年9月30日より、クラスターレベルのNew Relic統合が一般提供(GA)となります。

  • クラスターレベルのNew Relic統合:2025年7月31日までに組織内で削除されていない従来のプロジェクトレベルのDatadogまたはNew Relic統合が残っていない場合、 TiDB Cloudは組織が最新の機能強化を体験できるように、クラスターレベルのNew Relic統合を提供します。
  • 従来のプロジェクトレベルの New Relic 統合 (ベータ版) : 2025年 7月 31日時点で組織内に少なくとも 1つの従来のプロジェクトレベルの Datadog または New Relic 統合が削除されずに残っている場合、 TiDB Cloud は、現在のダッシュボードへの影響を回避するために、組織向けにプロジェクトレベルで既存および新規の統合の両方を保持します。従来のプロジェクトレベルの New Relic 統合は、2025年 10月 31日に廃止されました。組織がこれらの従来の統合をまだ使用している場合は、DatadogとNew Relicの統合を移行する手順に従って、新しいクラスターレベルの統合に移行し、メトリクス関連サービスへの影響を最小限に抑えてください。

前提条件

  • TiDB Cloud をNew Relic と統合するには、New Relicアカウントと、 Ingest - LicenseタイプのNew Relic APIキーを作成する必要があります。

    New Relicのアカウントをお持ちでない場合は、ここでご登録ください。

  • TiDB Cloudのサードパーティメトリクス統合を設定するには、 TiDB CloudでOrganization OwnerまたはProject Ownerアクセス権が必要です。統合ページを表示したり、提供されたリンクから設定済みのダッシュボードにアクセスしたりするには、TiDB Cloudのプロジェクト内の対象のTiDB Cloud DedicatedクラスターにアクセスするためのProject Viewerロール以上が必要です。

制限

  • New Relicとの連携機能は、現在TiDB Cloud Dedicatedクラスターでのみ利用可能です。

  • クラスターの状態がCREATING 、 RESTORING 、 PAUSED 、 RESUMINGの場合は、New Relic の統合は利用できません。

  • New Relicとの連携が確立されたクラスターが削除されると、それに関連付けられた連携サービスも削除されます。

手順

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

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

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

    2. 左側のナビゲーションペインで、 Settings > Integrationsをクリックします。

    3. Integrationsページで、 Integration to New Relicをクリックします。

    4. New Relic APIキーを入力し、New Relicアカウントがホストされているリージョンを選択してください。

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

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

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

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

    3. 左側のナビゲーションペインで、 Project Settingsの下にあるIntegrationsをクリックします。

    4. Integrationsページで、 Integration to New Relic (BETA)をクリックします。

    5. New Relic APIキーを入力し、New Relicアカウントがホストされているリージョンを選択してください。

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

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

    ステップ2. New RelicにTiDB Cloudダッシュボードを追加する

    New Relic統合バージョンに応じて、手順は異なります。

      新しいTiDB Cloudダッシュボードは、保留中のPRがNew Relicによってマージされた後にNew Relicで利用可能になります。それまでは、以下の手順でダッシュボードをNew Relicに手動でインポートできます。

      1. 新しいダッシュボード用のJSONファイルを準備します。

        1. テンプレートの JSON ファイルをここからダウンロードします。

        2. JSONファイルで、4行目に"permissions": "PUBLIC_READ_WRITE"を以下のように追加します。

          { "name": "TiDB Cloud Dynamic Tracker", "description": null, "permissions": "PUBLIC_READ_WRITE", ... }
        3. JSON ファイル内のすべての"accountIds": []フィールドに New Relic アカウント ID を追加してください。

          例えば:

          "accountIds": [ 1234567 ],
      2. New Relicにログインし、左側のナビゲーションバーのDashboardsをクリックし、右上隅のImport dashboardをクリックします。

      3. 表示されたダイアログで、準備した JSON ファイルの内容をテキストエリアに貼り付け、権限設定を選択してから、Saveをクリックします。

      1. New Relicにログインします。
      2. Add Dataをクリックし、 TiDB Cloudを検索して、 TiDB Cloud Monitoringページに移動します。または、 リンクをクリックして直接ページにアクセスすることもできます。
      3. アカウントIDを選択し、New Relicでダッシュボードを作成してください。

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

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

      2. New RelicセクションのDashboardリンクをクリックすると、TiDBクラスターの事前構築済みダッシュボードが表示されます。

      3. New Relic統合バージョンに応じて、次のいずれかを実行します。

        • クラスターレベルのNew Relic統合の場合は、 TiDB Cloud Dynamic Trackerをクリックして新しいダッシュボードを表示してください。
        • 従来のプロジェクトレベルのNew Relic統合(ベータ版)については、 TiDB Cloud Monitoringをクリックして従来のダッシュボードを表示してください。

      New Relicで利用可能なメトリクス

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

      メトリック名メトリックタイプラベル説明
      tidb_cloud.db_database_timegaugesql_type: Select|Insert|...

      cluster_name: <cluster name>

      instance: tidb-0|tidb-1…

      component: tidb
      TiDBで実行されるすべてのSQL文が1秒あたりに消費する合計時間。これには、すべてのプロセスのCPU時間と、アイドル状態ではない待機時間が含まれます。
      tidb_cloud.db_query_per_secondgaugetype: Select|Insert|...

      cluster_name: <cluster name>

      instance: tidb-0|tidb-1…

      component: tidb
      すべての TiDB ノードで 1秒あたりに実行される SQL文の数。これはSELECT 、 INSERT 、 UPDATE 、およびその他のタイプの文に従ってカウントされます。
      tidb_cloud.db_average_query_durationgaugesql_type: Select|Insert|...

      cluster_name: <cluster name>

      instance: tidb-0|tidb-1…

      component: tidb
      クライアントのネットワークリクエストがTiDBに送信されてから、TiDBがリクエストを実行した後、クライアントにリクエストが返されるまでの時間。
      tidb_cloud.db_failed_queriesgaugetype: executor:xxxx|parser:xxxx|...

      cluster_name: <cluster name>

      instance: tidb-0|tidb-1…

      component: tidb
      各TiDBノードで1秒あたりに発生するSQL実行エラーに基づいた、エラーの種類(構文エラーや主キーの競合など)の統計情報。
      tidb_cloud.db_total_connectiongaugecluster_name: <cluster name>

      instance: tidb-0|tidb-1…

      component: tidb
      TiDBサーバーにおける現在の接続数。
      tidb_cloud.db_active_connectionsgaugecluster_name: <cluster name>

      instance: tidb-0|tidb-1…

      component: tidb
      アクティブな接続数。
      tidb_cloud.db_disconnectionsgaugeresult: ok|error|undetermined

      cluster_name: <cluster name>

      instance: tidb-0|tidb-1…

      component: tidb
      接続が切断されたクライアントの数。
      tidb_cloud.db_command_per_secondgaugetype: Query|StmtPrepare|...

      cluster_name: <cluster name>

      instance: tidb-0|tidb-1…

      component: tidb
      TiDBが1秒間に処理するコマンド数。コマンド実行結果の成否に応じて分類されます。
      tidb_cloud.db_queries_using_plan_cache_opsgaugecluster_name: <cluster name>

      instance: tidb-0|tidb-1…

      component: tidb
      プランキャッシュを使用したクエリの 1秒あたりの統計。実行プランキャッシュは、プリペアドステートメントコマンドのみをサポートします。
      tidb_cloud.db_transaction_per_secondgaugetxn_mode: pessimistic|optimistic

      type: abort|commit|...

      cluster_name: <cluster name>

      instance: tidb-0|tidb-1…

      component: tidb
      1秒あたりに実行されるトランザクション数。
      tidb_cloud.node_storage_used_bytesgaugecluster_name: <cluster name>

      instance: tikv-0|tikv-1…|tiflash-0|tiflash-1…

      component: tikv|tiflash
      TiKV またはTiFlashノードのディスク使用量(バイト単位)。このメトリックは主にストレージエンジンの論理データサイズを表し、WAL ファイルと一時ファイルは除外されます。実際のディスク使用率を計算するには、代わりに(capacity - available) / capacityを使用してください。TiKV のストレージ使用率が 80% を超えると、レイテンシーの急増が発生する可能性があり、使用率が高くなるとリクエストが失敗する可能性があります。すべてのTiFlashノードのストレージ使用率が 80% に達すると、 TiFlashレプリカを追加する DDL文は無期限にハングします。
      tidb_cloud.node_storage_capacity_bytesgaugecluster_name: <cluster name>

      instance: tikv-0|tikv-1…|tiflash-0|tiflash-1…

      component: tikv|tiflash
      TiKV/ TiFlashノードのディスク容量(バイト単位)。
      tidb_cloud.node_cpu_seconds_total (ベータ版のみ)countcluster_name: <cluster name>

      instance: tidb-0|tidb-1…|tikv-0…|tiflash-0…

      component: tidb|tikv|tiflash
      TiDB/TiKV/ TiFlashノードのCPU使用率。
      tidb_cloud.node_cpu_capacity_coresgaugecluster_name: <cluster name>

      instance: tidb-0|tidb-1…|tikv-0…|tiflash-0…

      component: tidb|tikv|tiflash
      TiDB/TiKV/ TiFlashノードのCPUコア数の制限。
      tidb_cloud.node_memory_used_bytesgaugecluster_name: <cluster name>

      instance: tidb-0|tidb-1…|tikv-0…|tiflash-0…

      component: tidb|tikv|tiflash
      TiDB/TiKV/ TiFlashノードで使用されているメモリ(バイト単位)。
      tidb_cloud.node_memory_capacity_bytesgaugecluster_name: <cluster name>

      instance: tidb-0|tidb-1…|tikv-0…|tiflash-0…

      component: tidb|tikv|tiflash
      TiDB/TiKV/ TiFlashノードのメモリ容量(バイト単位)。

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

      メトリック名メトリックタイプラベル説明
      tidb_cloud.node_storage_available_bytesgaugeinstance: tidb-0\|tidb-1\|...

      component: tikv\|tiflash

      cluster_name: <cluster name>
      TiKVまたはTiFlashノードで使用可能なディスク容量(バイト単位)。
      tidb_cloud.node_disk_read_latencygaugeinstance: tidb-0\|tidb-1\|...

      component: tikv\|tiflash

      cluster_name: <cluster name>

      device: nvme.*\|dm.*
      ストレージデバイスごとの読み取りレイテンシー(秒単位)。
      tidb_cloud.node_disk_write_latencygaugeinstance: tidb-0\|tidb-1\|...

      component: tikv\|tiflash

      cluster_name: <cluster name>

      device: nvme.*\|dm.*
      ストレージデバイスごとの書き込みレイテンシー(秒単位)。
      tidb_cloud.db_kv_request_durationgaugeinstance: tidb-0\|tidb-1\|...

      component: tikv

      cluster_name: <cluster name>

      type: BatchGet\|Commit\|Prewrite\|...
      TiKVリクエストの種類別の所要時間(秒)。
      tidb_cloud.db_component_uptimegaugeinstance: tidb-0\|tidb-1\|...

      component: tidb\|tikv\|tiflash

      cluster_name: <cluster name>
      TiDBコンポーネントの稼働時間(秒単位)。
      tidb_cloud.cdc_changefeed_latency (別名 cdc_changefeed_checkpoint_ts_lag)gaugechangefeed_id: <changefeed-id>

      cluster_name: <cluster name>
      変更フィード所有者のチェックポイントタイムスタンプの遅延(秒単位)。
      tidb_cloud.cdc_changefeed_resolved_ts_laggaugechangefeed_id: <changefeed-id>

      cluster_name: <cluster name>
      変更フィード所有者の解決済みタイムスタンプ遅延(秒単位)。
      tidb_cloud.cdc_changefeed_statusgaugechangefeed_id: <changefeed-id>

      cluster_name: <cluster name>
      変更フィードのステータス:

      -1 : Unknown

      0 : Normal

      1 : Warning

      2 : Failed

      3 : Stopped

      4 : Finished

      6 : Warning

      7 : Other
      tidb_cloud.resource_manager_resource_unit_read_request_unitgaugecluster_name: <cluster name>

      resource_group: <group-name>
      リソースマネージャーによって消費された読み取りリクエストユニット(RU)。
      tidb_cloud.resource_manager_resource_unit_write_request_unitgaugecluster_name: <cluster name>

      resource_group: <group-name>
      リソースマネージャーによって消費される書き込みリクエストユニット(RU)。
      tidb_cloud.dm_task_stategaugeinstance: instance

      task: task

      cluster_name: <cluster name>
      データ移行のタスク状態:

      0 : Invalid

      1 : New

      2 : Running

      3 : Paused

      4 : Stopped

      5 : Finished

      15 : Error
      tidb_cloud.dm_syncer_replication_lag_bucketgaugeinstance: instance

      cluster_name: <cluster name>
      データ移行のレプリケーション遅延(バケット)。
      tidb_cloud.dm_syncer_replication_lag_gaugegaugeinstance: instance

      task: task

      cluster_name: <cluster name>
      データ移行のレプリケーション遅延(gauge)。
      tidb_cloud.dm_relay_read_error_countgaugeinstance: instance

      cluster_name: <cluster name>
      マスターからのbinlogの読み取りに失敗しました。
      tidb_cloud.node_memory_available_bytesgaugecluster_name: <cluster name>

      instance: tidb-0|tidb-1…|tikv-0…|tiflash-0…

      component: tidb|tikv|tiflash
      TiDB/TiKV/ TiFlashノードで使用可能なメモリ(バイト単位)。
      tidb_cloud.cdc_changefeed_replica_rowsgaugechangefeed_id: <changefeed-id>

      cluster_name: <cluster name>
      TiCDCノードが1秒あたりにダウンストリームに書き込むイベントの数。
      tidb_cloud.node_cpu_seconds_total_rategaugecluster_name: <cluster name>

      instance: tidb-0|tidb-1…|tikv-0…|tiflash-0…

      component: tidb|tikv|tiflash
      TiDB/TiKV/ TiFlashノードのCPU使用率。

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