TiDB CloudとNew Relicを統合する

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

新しい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キーと連携する

新しい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の下にあるProject Settingsをクリックします。
Integrationsページで、 [New Relic との統合 (ベータ版)]をクリックします。
New RelicのAPIキーを入力し、New Relicのサイトを選択してください。
Test Integrationをクリックします。
- テストが成功すると、 Confirmボタンが表示されます。
- テストが失敗した場合は、エラーメッセージが表示されます。メッセージに従ってトラブルシューティングを行い、統合を再試行してください。
統合を完了するには、 Confirmをクリックしてください。

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

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

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

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

メトリック名	メトリックタイプ	ラベル	説明
tidb_cloud.db_database_time	ゲージ	sql_type: Select	Insert
tidb_cloud.db_query_per_second	ゲージ	タイプ: 選択	挿入
tidb_cloud.db_average_query_duration	ゲージ	sql_type: Select	Insert
tidb_cloud.db_failed_queries	ゲージ	タイプ: 実行者:xxxx	パーサー: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｜エラー｜不明クラスター名: `<cluster name>` インスタンス: tidb-0	tidb-1… コンポーネント: `tidb`
tidb_cloud.db_command_per_second	ゲージ	タイプ: クエリ	ステートメント準備
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…

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

メトリック名	メトリックタイプ	ラベル	説明
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>` `device` : `nvme.\\|dm.`	ストレージデバイスごとの読み取りレイテンシー（秒単位）。
tidb_cloud.node_disk_write_latency	ゲージ	インスタンス: `tidb-0\\|tidb-1\\|...` コンポーネント: `tikv\\|tiflash` クラスター名: `<cluster name>` `device` : `nvme.\\|dm.`	ストレージデバイスごとの書き込みレイテンシー（秒単位）。
tidb_cloud.db_kv_request_duration	ゲージ	インスタンス: `tidb-0\\|tidb-1\\|...` コンポーネント: `tikv` クラスター名: `<cluster name>` `type` : `BatchGet\\|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)	ゲージ	changefeed_id: `<changefeed-id>` クラスター名: `<cluster name>`	変更フィード所有者のチェックポイントタイムスタンプの遅延（秒単位）。
tidb_cloud.cdc_changefeed_resolved_ts_lag	ゲージ	changefeed_id: `<changefeed-id>` クラスター名: `<cluster name>`	変更フィード所有者の解決済みタイムスタンプ遅延（秒単位）。
tidb_cloud.cdc_changefeed_status	ゲージ	changefeed_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	ゲージ	changefeed_id: `<changefeed-id>` クラスター名: `<cluster name>`	TiCDCノードが1秒あたりにダウンストリームに書き込むイベントの数。
tidb_cloud.node_cpu_seconds_total_rate	ゲージ	クラスター名: `<cluster name>` インスタンス: tidb-0	tidb-1…