集成 TiDB Cloud 与 New Relic

TiDB Cloud 支持与 New Relic 集成。你可以配置 TiDB Cloud，将你的 TiDB 集群的统计/指标（信息）发送到 New Relic。之后，你可以直接在 New Relic 仪表盘中查看这些统计/指标（信息）。

New Relic 集成版本

自 2023 年 4 月 11 日起，TiDB Cloud 支持项目级 New Relic 集成（Beta）。自 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 集成（Beta）：如果在 2025 年 7 月 31 日前，你的组织内至少有一个未删除的旧版项目级 Datadog 或 New Relic 集成，TiDB Cloud 会保留现有和新建的项目级集成，以避免影响当前仪表盘。请注意，旧版项目级 New Relic 集成将于 2025 年 10 月 31 日弃用。如果你的组织仍在使用这些旧版集成，请按照迁移 Datadog 和 New Relic 集成迁移到新的集群级集成，以最大程度减少对统计/指标（信息）相关服务的影响。

前提条件

要将 TiDB Cloud 集成到 New Relic，你必须拥有 New Relic 账户，并创建一个 Ingest - License 类型的 New Relic API key。
如果你还没有 New Relic 账户，请在这里注册。
要为 TiDB Cloud 设置第三方统计/指标（信息）集成，你必须拥有 TiDB Cloud 的 Organization Owner 或 Project Owner 访问权限。要通过提供的链接查看集成页面或访问已配置的仪表盘，你至少需要 Project Viewer 角色，以访问你项目下的目标集群。

限制

New Relic 集成目前仅适用于 TiDB Cloud Dedicated 集群。
当集群状态为 CREATING、RESTORING、PAUSED 或 RESUMING 时，不支持 New Relic 集成。
当带有 New Relic 集成的集群被删除时，其关联的集成服务也会被移除。

操作步骤

步骤 1. 使用你的 New Relic API Key 集成

根据你的 New Relic 集成版本，访问集成页面的步骤有所不同。

在 TiDB Cloud 控制台中，进入你项目的 Clusters 页面，然后点击目标集群名称，进入其概览页面。
在左侧导航栏，点击 Settings > Integrations。
在 Integrations 页面，点击 Integration to New Relic。
输入你的 New Relic API key，并选择 New Relic 的站点。
点击 Test Integration。
- 如果测试成功，会显示 Confirm 按钮。
- 如果测试失败，会显示错误信息。请根据提示排查并重试集成。
点击 Confirm 完成集成。

在 TiDB Cloud 控制台中，使用左上角的下拉框切换到你的目标项目。
在左侧导航栏，点击 Project Settings > Integrations。
在 Integrations 页面，点击 Integration to New Relic (BETA)。
输入你的 New Relic API key，并选择 New Relic 的站点。
点击 Test Integration。
- 如果测试成功，会显示 Confirm 按钮。
- 如果测试失败，会显示错误信息。请根据提示排查并重试集成。
点击 Confirm 完成集成。

步骤 2. 在 New Relic 中添加 TiDB Cloud 仪表盘

根据你的 New Relic 集成版本，操作步骤有所不同。

在 New Relic 合并待处理的 PR 后，将会有新的 TiDB Cloud 仪表盘可用。在此之前，你可以通过以下步骤手动导入仪表盘到 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
],
```
  注意
  为避免集成报错，请确保你的账户 ID 已添加到 JSON 文件中所有 "accountIds" 字段。
登录 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 区域点击 Dashboard 链接，查看你的 TiDB 集群的预置仪表盘。
根据你的 New Relic 集成版本，执行以下操作之一：
- 对于集群级 New Relic 集成，点击 TiDB Cloud Dynamic Tracker 查看新仪表盘。
- 对于旧版项目级 New Relic 集成（Beta），点击 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 语句消耗的总时间，包括所有进程的 CPU 时间和非空闲等待时间。
tidb_cloud.db_query_per_second	gauge	type: Select\|Insert\|... cluster_name: `<cluster name>` instance: tidb-0\|tidb-1… component: `tidb`	所有 TiDB 实例每秒执行的 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 实例发生的 SQL 执行错误类型（如语法错误、主键冲突等）统计。
tidb_cloud.db_total_connection	gauge	cluster_name: `<cluster name>` instance: tidb-0\|tidb-1… component: `tidb`	当前 TiDB server 的连接数。
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 每秒处理的命令数，按命令执行结果的成功或失败分类。
tidb_cloud.db_queries_using_plan_cache_ops	gauge	cluster_name: `<cluster name>` instance: tidb-0\|tidb-1… component: `tidb`	每秒使用 Plan Cache 的查询统计。执行计划缓存仅支持 prepared statement 命令。
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`	每秒执行的事务数量。
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 (Beta only)	count	cluster_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_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 (AKA cdc_changefeed_checkpoint_ts_lag)	gauge	changefeed_id: `<changefeed-id>` cluster_name: `<cluster name>`	changefeed owner 的 checkpoint 时间戳延迟（秒）。
tidb_cloud.cdc_changefeed_resolved_ts_lag	gauge	changefeed_id: `<changefeed-id>` cluster_name: `<cluster name>`	changefeed owner 的 resolved 时间戳延迟（秒）。
tidb_cloud.cdc_changefeed_status	gauge	changefeed_id: `<changefeed-id>` cluster_name: `<cluster name>`	Changefeed 状态： `-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>`	Resource Manager 消耗的读请求单元（RU）。
tidb_cloud.resource_manager_resource_unit_write_request_unit	gauge	cluster_name: `<cluster name>` resource_group: `<group-name>`	Resource Manager 消耗的写请求单元（RU）。
tidb_cloud.dm_task_state	gauge	instance: `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_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 节点每秒写入下游的事件数。
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 使用率。