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日より、TiDB Cloudレベルの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統合バージョンに応じて、統合ページにアクセスする手順は異なります。

TiDB Cloudコンソールで、My TiDBページに移動し、ターゲットのTiDB Cloud Dedicatedクラスターの名前をクリックして、その概要ページに移動します。
左側のナビゲーションペインで、 Settings > Integrationsをクリックします。
Integrationsページで、 Integration to New Relicをクリックします。
New RelicのAPIキーを入力し、New Relicのサイトを選択してください。
Test Integrationをクリックします。
- テストが成功すると、 Confirmボタンが表示されます。
- テストが失敗した場合は、エラーメッセージが表示されます。メッセージに従ってトラブルシューティングを行い、統合を再試行してください。
統合を完了するには、 Confirmをクリックしてください。

TiDB Cloudコンソールで、組織のMy TiDBページに移動し、 Project viewタブをクリックします。
プロジェクトビューで、対象のプロジェクトを見つけて、そのプロジェクトのをクリックします。
左側のナビゲーションペインで、 Project Settingsの下にあるIntegrationsをクリックします。
Integrationsページで、 Integration to New Relic (BETA)をクリックします。
New RelicのAPIキーを入力し、New Relicのサイトを選択してください。
Test Integrationをクリックします。
- テストが成功すると、 Confirmボタンが表示されます。
- テストが失敗した場合は、エラーメッセージが表示されます。メッセージに従ってトラブルシューティングを行い、統合を再試行してください。
統合を完了するには、 Confirmをクリックしてください。

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

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

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

新しいダッシュボード用の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
],
```
  ノート
  統合エラーを回避するために、JSON ファイル内のすべての"accountIds"フィールドにアカウント ID が追加されていることを確認してください。
New Relicにログインし、左側のナビゲーションバーのDashboardsをクリックし、右上隅のImport dashboardをクリックします。
表示されたダイアログで、準備した JSON ファイルの内容をすべてテキストエリアに貼り付け、次にImport dashboardをクリックします。

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

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

TiDB Cloudコンソールで、 Integrationsページに移動します。
New RelicセクションのNew Relicリンクをクリックすると、TiDBクラスターの事前構築済みダッシュボードが表示されます。
New Relic統合バージョンに応じて、次のいずれかを実行します。
- クラスタレベルでのNew Relic統合を行うには、 TiDB Cloud Dynamic Trackerをクリックして新しいダッシュボードを表示してください。
- 従来のプロジェクトレベルのNew Relic統合（ベータ版）については、 TiDB Cloud Monitoringをクリックして従来のダッシュボードを表示してください。

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

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

メトリック名	メトリックタイプ	ラベル	説明
tidb_cloud.db_database_time	gauge	sql_type: Select\|Insert\|... cluster_name: `<cluster name>` instance: tidb-0\|tidb-1… component: `tidb`	TiDBで実行されるすべてのSQL文が1秒あたりに消費する合計時間。これには、すべてのプロセスのCPU時間と、アイドル状態ではない待機時間が含まれます。
tidb_cloud.db_query_per_second	gauge	type: Select\|Insert\|... cluster_name: `<cluster name>` instance: tidb-0\|tidb-1… component: `tidb`	すべての TiDB ノードで 1秒あたりに実行される SQL文の数。これは`SELECT` 、 `INSERT` 、 `UPDATE` 、およびその他のタイプの文に従ってカウントされます。
tidb_cloud.db_average_query_duration	gauge	sql_type: Select\|Insert\|... cluster_name: `<cluster name>` instance: tidb-0\|tidb-1… component: `tidb`	クライアントのネットワークリクエストがTiDBに送信されてから、TiDBがリクエストを実行した後、クライアントにリクエストが返されるまでの時間。
tidb_cloud.db_failed_queries	gauge	type: executor:xxxx\|parser:xxxx\|... cluster_name: `<cluster name>` instance: tidb-0\|tidb-1… component: `tidb`	各TiDBノードで1秒あたりに発生するSQL実行エラーに基づいた、エラーの種類（構文エラーや主キーの競合など）の統計情報。
tidb_cloud.db_total_connection	gauge	cluster_name: `<cluster name>` instance: tidb-0\|tidb-1… component: `tidb`	TiDBサーバーにおける現在の接続数。
tidb_cloud.db_active_connections	gauge	cluster_name: `<cluster name>` instance: tidb-0\|tidb-1… component: `tidb`	アクティブな接続数。
tidb_cloud.db_disconnections	gauge	result: ok\|error\|undetermined cluster_name: `<cluster name>` instance: tidb-0\|tidb-1… component: `tidb`	接続が切断されたクライアントの数。
tidb_cloud.db_command_per_second	gauge	type: Query\|StmtPrepare\|... cluster_name: `<cluster name>` instance: tidb-0\|tidb-1… component: `tidb`	TiDBが1秒間に処理するコマンド数。コマンド実行結果の成否に応じて分類されます。
tidb_cloud.db_queries_using_plan_cache_ops	gauge	cluster_name: `<cluster name>` instance: tidb-0\|tidb-1… component: `tidb`	プランキャッシュを使用したクエリの 1秒あたりの統計。実行プランキャッシュは、プリペアドステートメントコマンドのみをサポートします。
tidb_cloud.db_transaction_per_second	gauge	txn_mode: pessimistic\|optimistic type: abort\|commit\|... cluster_name: `<cluster name>` instance: tidb-0\|tidb-1… component: `tidb`	1秒あたりに実行されるトランザクション数。
tidb_cloud.node_storage_used_bytes	gauge	cluster_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_bytes	gauge	cluster_name: `<cluster name>` instance: tikv-0\|tikv-1…\|tiflash-0\|tiflash-1… component: tikv\|tiflash	TiKV/ TiFlashノードのディスク容量（バイト単位）。
tidb_cloud.node_cpu_seconds_total (ベータ版のみ)	count	クラスター名: `<cluster name>` インスタンス: tidb-0	tidb-1…
tidb_cloud.node_cpu_capacity_cores	gauge	cluster_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_bytes	gauge	cluster_name: `<cluster name>` instance: tidb-0\|tidb-1…\|tikv-0…\|tiflash-0… component: tidb\|tikv\|tiflash	TiDB/TiKV/ TiFlashノードで使用されているメモリ（バイト単位）。
tidb_cloud.node_memory_capacity_bytes	gauge	cluster_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_bytes	gauge	instance: `tidb-0\\|tidb-1\\|...` component: `tikv\\|tiflash` cluster_name: `<cluster name>`	TiKVまたはTiFlashノードで使用可能なディスク容量（バイト単位）。
tidb_cloud.node_disk_read_latency	gauge	instance: `tidb-0\\|tidb-1\\|...` component: `tikv\\|tiflash` cluster_name: `<cluster name>` `device`: `nvme.\\|dm.`	ストレージデバイスごとの読み取りレイテンシー（秒単位）。
tidb_cloud.node_disk_write_latency	gauge	instance: `tidb-0\\|tidb-1\\|...` component: `tikv\\|tiflash` cluster_name: `<cluster name>` `device`: `nvme.\\|dm.`	ストレージデバイスごとの書き込みレイテンシー（秒単位）。
tidb_cloud.db_kv_request_duration	gauge	instance: `tidb-0\\|tidb-1\\|...` component: `tikv` cluster_name: `<cluster name>` `type`: `BatchGet\\|Commit\\|Prewrite\\|...`	TiKVリクエストの種類別の所要時間（秒）。
tidb_cloud.db_component_uptime	gauge	instance: `tidb-0\\|tidb-1\\|...` component: `tidb\\|tikv\\|tiflash` cluster_name: `<cluster name>`	TiDBコンポーネントの稼働時間（秒単位）。
tidb_cloud.cdc_changefeed_latency (別名 cdc_changefeed_checkpoint_ts_lag)	gauge	changefeed_id: `<changefeed-id>` クラスター名: `<cluster name>`	変更フィード所有者のチェックポイントタイムスタンプの遅延（秒単位）。
tidb_cloud.cdc_changefeed_resolved_ts_lag	gauge	changefeed_id: `<changefeed-id>` cluster_name: `<cluster name>`	変更フィード所有者の解決済みタイムスタンプ遅延（秒単位）。
tidb_cloud.cdc_changefeed_status	gauge	changefeed_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_unit	gauge	cluster_name: `<cluster name>` resource_group: `<group-name>`	リソースマネージャによって消費された読み取りリクエストユニット（RU）。
tidb_cloud.resource_manager_resource_unit_write_request_unit	gauge	cluster_name: `<cluster name>` resource_group: `<group-name>`	リソースマネージャによって消費される書き込みリクエストユニット（RU）。
tidb_cloud.dm_task_state	gauge	instance: `instance` task: `task` cluster_name: `<cluster name>`	データ移行のタスク状態: `0` : 無効 `1` : 新規 `2` : 実行中 `3` : 一時停止 `4` : 停止しました `5` : 完了 `15` : エラー
tidb_cloud.dm_syncer_replication_lag_bucket	gauge	instance: `instance` cluster_name: `<cluster name>`	データ移行の遅延（バケット）を複製します。
tidb_cloud.dm_syncer_replication_lag_gauge	gauge	instance: `instance` task: `task` cluster_name: `<cluster name>`	データ移行の遅延（gauge）を複製します。
tidb_cloud.dm_relay_read_error_count	gauge	instance: `instance` cluster_name: `<cluster name>`	マスターからのbinlogの読み取りに失敗しました。
tidb_cloud.node_memory_available_bytes	gauge	cluster_name: `<cluster name>` instance: tidb-0\|tidb-1…\|tikv-0…\|tiflash-0… component: tidb\|tikv\|tiflash	TiDB/TiKV/ TiFlashノードで使用可能なメモリ（バイト単位）。
tidb_cloud.cdc_changefeed_replica_rows	gauge	changefeed_id: `<changefeed-id>` cluster_name: `<cluster name>`	TiCDCノードが1秒あたりにダウンストリームに書き込むイベントの数。
tidb_cloud.node_cpu_seconds_total_rate	gauge	cluster_name: `<cluster name>` instance: tidb-0\|tidb-1…\|tikv-0…\|tiflash-0… component: tidb\|tikv\|tiflash	TiDB/TiKV/ TiFlashノードのCPU使用率。