TiDB CloudとNew Relicの統合

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

New Relic統合バージョン

TiDB Cloudは、 2023年4月11日よりプロジェクトレベルのNew Relic統合（ベータ版）をサポートしています。2025年7月31日より、 TiDB CloudはクラスターレベルのNew Relic統合（プレビュー版）を導入します。2025年9月30日より、クラスターレベルのNew Relic統合が一般提供（GA）されます。

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

前提条件

TiDB Cloud をNew Relic と統合するには、アカウントをニューレリック、 Ingest - LicenseタイプのうちNew Relic APIキーを作成する必要です。
New Relic アカウントをお持ちでない場合は、サインアップしてくださいここ。
TiDB Cloudのサードパーティメトリクス統合を設定するには、 TiDB CloudのOrganization OwnerまたはProject Ownerアクセス権が必要です。統合ページを表示したり、提供されているリンクを介して設定済みのダッシュボードにアクセスしたりするには、 TiDB Cloudのプロジェクト内のターゲットクラスターにアクセスするためのProject Viewer以上のロールが必要です。

制限

New Relic 統合は現在TiDB Cloud専用クラスターでのみ利用可能です。
クラスターのステータスがCREATING 、 RESTORING 、 PAUSED 、またはRESUMINGの場合、New Relic 統合は使用できません。
New Relic 統合を備えたクラスターが削除されると、それに関連付けられている統合サービスも削除されます。

手順

ステップ1. New Relic APIキーとの統合

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

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

TiDB Cloudコンソールで、左上隅のコンボボックスを使用してターゲットプロジェクトに切り替えます。
左側のナビゲーションペインで、 [プロジェクト設定] > [統合]をクリックします。
「統合」ページで、 「New Relic への統合 (ベータ版)」をクリックします。
New Relic の API キーを入力し、New Relic のサイトを選択します。
[統合のテスト]をクリックします。
- テストが成功すると、 「確認」ボタンが表示されます。
- テストに失敗した場合は、エラーメッセージが表示されます。メッセージに従ってトラブルシューティングを行い、統合を再試行してください。
「確認」をクリックして統合を完了します。

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

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

保留中の広報 New Relicにマージされると、新しいTiDB Cloudダッシュボードが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 が追加されていることを確認してください。
ニューレリックにログインし、左側のナビゲーションバーで[ダッシュボード]をクリックして、右上隅の [ダッシュ**ボードのインポート] を**クリックします。
表示されたダイアログで、準備した JSON ファイルのすべてのコンテンツをテキスト領域に貼り付け、 [ダッシュボードのインポート] をクリックします。

ニューレリックにログインします。
「データを追加」をクリックし、 TiDB Cloudを検索してTiDB Cloud監視ページに移動します。または、「リンクをクリックして直接ページにアクセスすることもできます。
アカウント ID を選択し、New Relic でダッシュボードを作成します。

あらかじめ構築されたダッシュボードをビュー

TiDB Cloudコンソールで、 「統合」ページに移動します。
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	ゲージ	sql_type: 選択	挿入
tidb_cloud.db_query_per_second	ゲージ	タイプ: 選択	挿入
tidbcloud.db平均クエリ実行時間	ゲージ	sql_type: 選択	挿入
tidb_cloud.db_failed_queries	ゲージ	タイプ: executor:xxxx	parser: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	エラー
tidb_cloud.db_command_per_second	ゲージ	タイプ: Query	StmtPrepare
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.`	storageデバイスごとの読み取りレイテンシー(秒単位)。
tidb_cloud.node_disk_write_latency	ゲージ	インスタンス: `tidb-0\\|tidb-1\\|...` コンポーネント: `tikv\\|tiflash` クラスター名: `<cluster name>` `device`時`nvme.\\|dm.`	storageデバイスごとの書き込みレイテンシー(秒単位)。
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)	ゲージ	チェンジフィードID: `<changefeed-id>` クラスター名: `<cluster name>`	変更フィード所有者のチェックポイントタイムスタンプの遅延 (秒単位)。
tidb_cloud.cdc_changefeed_resolved_ts_lag	ゲージ	チェンジフィードID: `<changefeed-id>` クラスター名: `<cluster name>`	変更フィード所有者の解決されたタイムスタンプの遅延 (秒単位)。
tidb_cloud.cdc_changefeed_status	ゲージ	チェンジフィード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	ゲージ	チェンジフィードID: `<changefeed-id>` クラスター名: `<cluster name>`	TiCDC ノードが 1 秒あたりにダウンストリームに書き込むイベントの数。
tidb_cloud.node_cpu_seconds_total_rate	ゲージ	クラスター名: `<cluster name>` インスタンス: tidb-0	tidb-1…