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

TiDB Cloud と New Relic を統合する (PREVIEW)

TiDB Cloud は New Relic との統合をサポートしています。TiDB Cloud を設定して、TiDB Cloud Essential インスタンスのメトリクスを New Relic に送信できます。その後、これらのメトリクスを New Relic のダッシュボードで直接表示できます。

前提条件

TiDB Cloud を New Relic と統合するには、New Relic アカウントを所有し、Ingest - License タイプの New Relic API key を作成している必要があります。
New Relic アカウントを持っていない場合は、https://newrelic.com/signup でサインアップしてください。
TiDB Cloud のサードパーティメトリクス統合を設定するには、TiDB Cloud で Organization Owner、Project Owner、または Instance Manager のアクセス権限が必要です。統合ページを表示するには、TiDB Cloud の組織配下にある対象の TiDB Cloud Essential インスタンスにアクセスできる、少なくとも Project Viewer または Instance Viewer ロールが必要です。

制限事項

New Relic 統合は TiDB Cloud Starter インスタンスでは利用できません。
TiDB Cloud Essential インスタンスのステータスが **CREATING**、**RESTORING**、**PAUSED**、または **RESUMING** の場合、New Relic 統合は利用できません。
New Relic 統合が設定されたインスタンスを削除すると、関連付けられた統合サービスも削除されます。

手順

手順 1. 事前構築済みの New Relic ダッシュボードをインポートする

現在、TiDB Cloud Essential 用の TiDB Cloud ダッシュボードは、まだ New Relic マーケットプレイスでは利用できません。公開されるまでは、ダッシュボード JSON ファイルを手動でダウンロードし、New Relic にインポートする必要があります。

インスタンスタイプに応じた New Relic ダッシュボード JSON ファイルをダウンロードします。
- 2026 年 7 月 1 日以降に作成された TiDB Cloud Essential インスタンスの場合は、この JSON ファイルをダウンロードします: https://github.com/pingcap/docs/blob/master/tidb-cloud/monitor-new-relic-integration-tidb-cloud-dynamic-tracker-essential-v2.json。v2 サフィックスは、ダッシュボード JSON ファイルのバージョンのみを示します。
- 2026 年 7 月 1 日より前に作成された TiDB Cloud Essential インスタンスの場合は、この JSON ファイルをダウンロードします: https://github.com/pingcap/docs/blob/master/tidb-cloud/monitor-new-relic-integration-tidb-cloud-dynamic-tracker-essential.json。
JSON ファイル内のすべての "accountIds": [] フィールドに、New Relic アカウント ID を追加します。
例:
```
"accountIds": [
  1234567
],
```
ノート
統合エラーを回避するため、JSON ファイル内のすべての "accountIds" フィールドにアカウント ID が追加されていることを確認してください。
New Relic にログインし、左側のナビゲーションバーで Dashboards をクリックしてから、右上隅の Import dashboard をクリックします。
表示されたダイアログで、準備した JSON ファイルの内容をテキストエリアに貼り付け、権限設定を選択してから Save をクリックします。

手順 2. New Relic API key と統合する

TiDB Cloud console で My TiDB ページに移動し、対象の TiDB Cloud Essential インスタンス名をクリックして概要ページを開きます。
左側のナビゲーションペインで Integrations をクリックします。
Integrations ページで New Relic (PREVIEW) 統合を見つけ、Connect をクリックします。
New Relic API key を入力し、New Relic アカウントがホストされているリージョンを選択してから、Test Integration をクリックします。
- テストが成功すると、Confirm ボタンが表示されます。
- テストが失敗すると、エラーメッセージが表示されます。メッセージに従ってトラブルシューティングを行い、統合を再試行してください。
Confirm をクリックして統合を完了します。

事前構築済みダッシュボードを表示する

統合後に事前構築済みダッシュボードを表示するには、New Relic で Dashboards > Dashboard List に移動し、手順 1 でインポートしたダッシュボードを選択します。ダッシュボードページでは、対象のインスタンス名またはインスタンス ID でフィルタリングして、メトリクスを表示できます。

TiDB Cloud console から New Relic の Dashboard List ページにアクセスすることもできます。対象インスタンスの Integrations ページに移動し、New Relic (PREVIEW) をクリックしてから Dashboard をクリックします。

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

New Relic は、TiDB Cloud Essential インスタンスについて、以下のメトリクスを追跡します。

ノート

tidb_cloud.cdc_changefeed_* メトリクスは、2026 年 7 月 1 日以降に作成された TiDB Cloud Essential インスタンスでのみ利用できます。

メトリクス名	メトリクスタイプ	ラベル	説明
`tidb_cloud.db_total_connection`	gauge	`instance_id: <instance id>` `instance_name: <instance name>`	TiDB サーバー内の現在の接続数
`tidb_cloud.db_active_connections`	gauge	`instance_id: <instance id>` `instance_name: <instance name>`	アクティブな接続数
`tidb_cloud.db_disconnections`	gauge	`result: Error\\|...` `instance_id: <instance id>` `instance_name: <instance name>`	接続結果ごとに切断されたクライアント数
`tidb_cloud.db_database_time`	gauge	`sql_type: Select\\|Insert\\|...` `instance_id: <instance id>` `instance_name: <instance name>`	TiDB で実行中のすべての SQL 文が 1 秒あたりに消費した合計時間。すべてのプロセスの CPU 時間と、アイドル状態ではない待機時間を含みます
`tidb_cloud.db_query_per_second`	gauge	`type: Select\\|Insert\\|...` `instance_id: <instance id>` `instance_name: <instance name>`	文のタイプ別に集計された、1 秒あたりに実行された SQL 文の数
`tidb_cloud.db_failed_queries`	gauge	`type: planner:xxx\\|executor:2345\\|...` `instance_id: <instance id>` `instance_name: <instance name>`	SQL 文の実行時に 1 秒あたりに発生するエラータイプ（構文エラーや主キー競合など）の統計
`tidb_cloud.db_command_per_second`	gauge	`type: Query\\|Ping\\|...` `instance_id: <instance id>` `instance_name: <instance name>`	TiDB が 1 秒あたりに処理したコマンド数
`tidb_cloud.db_queries_using_plan_cache_ops`	gauge	`instance_id: <instance id>` `instance_name: <instance name>`	実行プランキャッシュにヒットしたクエリの 1 秒あたりの数
`tidb_cloud.db_average_query_duration`	gauge	`sql_type: Select\\|Insert\\|...` `instance_id: <instance id>` `instance_name: <instance name>`	ネットワークリクエストが TiDB に送信されてから、レスポンスがクライアントに返されるまでの時間
`tidb_cloud.db_transaction_per_second`	gauge	`type: Commit\\|Rollback\\|...` `txn_mode: optimistic\\|pessimistic` `instance_id: <instance id>` `instance_name: <instance name>`	1 秒あたりに実行されたトランザクション数
`tidb_cloud.db_row_storage_used_bytes`	gauge	`instance_id: <instance id>` `instance_name: <instance name>`	TiDB Cloud Essential インスタンスの行ベースストレージサイズ（バイト）
`tidb_cloud.db_columnar_storage_used_bytes`	gauge	`instance_id: <instance id>` `instance_name: <instance name>`	TiDB Cloud Essential インスタンスの列指向ストレージサイズ（バイト）。TiFlash が有効になっていない場合は 0 を返します
`tidb_cloud.resource_manager_resource_request_unit_total`	gauge	`instance_id: <instance id>` `instance_name: <instance name>`	消費された合計 Request Units/s (RU/s)
`tidb_cloud.cdc_changefeed_latency`	gauge	`changefeed_id: <changefeed-id>` `instance_id: <instance id>` `instance_name: <instance name>`	changefeed の上流と下流の間のデータレプリケーションレイテンシー
`tidb_cloud.cdc_changefeed_status`	gauge	`changefeed_id: <changefeed-id>` `instance_id: <instance id>` `instance_name: <instance name>`	Changefeed のステータス: `-1`: Unknown `0`: Normal `1`: Warning `2`: Failed `3`: Stopped `4`: Finished `6`: Warning `7`: Other