title: TiDB Dashboard 实例性能持续分析页面 summary: TiDB Dashboard 持续性能分析功能 (Continuous Profiling)

TiDB Dashboard 实例性能分析 - 持续分析页面

警告:

持续性能分析目前为实验特性,不建议在生产环境中使用。

持续性能分析是 TiDB v5.3.0 引入的一种从系统调用层面解读资源开销的方法。引入该方法后,TiDB 可提供数据库源码级性能观测,通过火焰图的形式帮助研发、运维人员定位性能问题的根因。

该功能以低于 0.5% 的性能损耗,对数据库内部运行状态持续打快照(类似 CT 扫描),让原本“黑盒”的数据库变成“白盒”,具备更高的可观测性。该功能一键开启后自动运行,存储结果提供了保留时长的设定,过期的结果将会被回收,确保存储空间的有效利用。

使用限制

使用持续性能分析时,应留意如下使用限制:

  • 该功能可在 x86 架构下支持 TiDB、TiKV、PD ,暂不支持 TiFlash;而在 ARM 框架下还未完全兼容,不可开启。

  • 该功能暂时只用于使用 TiUP 部署和升级的集群,不支持 TiDB Operator 或二进制包部署和升级的集群。

分析内容

持续性能分析允许用户在不重启的情况下持续收集 TiDB、TiKV、PD 各个实例的性能数据,并且持久监控节点。收集到的性能数据可显示为有向无环图,直观展现实例在性能收集的时间段内执行的各种内部操作及其比例,方便用户快速了解该实例 CPU 资源消耗细节。目前支持的性能信息:

  • TiDB/PD: CPU profile、Heap、Mutex、Goroutine(debug=2)
  • TiKV: CPU Profile

启用持续性能分析

启用持续性能分析,需要首先检查 TiUP 版本信息,然后配置中控机和 TiDB Dashboard 相关参数。

检查版本

检查 TiUP Cluster 版本,若版本低于 1.7.0,则需要先升级 TiUP Cluster。

  1. 检查 TiUP 版本:

    1. tiup cluster --version

    上述命令可查看 TiUP 的具体版本。显示为:

    1. tiup version 1.7.0 tiup
    2. Go Version: go1.17.2
    3. Git Ref: v1.7.0

    若低于 v1.7.0,需要先升级 TiUP Cluster。

  2. 升级 TiUP 和 TiUP Cluster 版本至最新。

    • 升级 TiUP:

      1. tiup update --self
    • 升级 TiUP Cluster:

      1. tiup update cluster

升级后,完成启动前检查。

配置中控机和 TiDB Dashboard

  1. 在中控机上,通过 TiUP 添加 ng_port 配置项,并对 Prometheus 节点进行 reload 操作。

    1. 使用集群中控机,使用 TiUP 工具,以编辑模式打开该集群的配置文件:

      1. tiup cluster edit-config ${cluster-name}
    2. 设置参数,在 monitoring_servers 下面增加 “ng_port:${port}”:

      1. monitoring_servers:
      2. - host: 172.16.6.6
      3. ng_port: ${port}
    3. 重启 Prometheus 节点:

      1. tiup cluster reload ${cluster-name} --role prometheus

      重启后,完成中控机所需的操作。

  2. 启用持续性能分析。

    1. 进入 TiDB Dashboard,选择高级调试 (Advanced Debugging) > 实例性能分析 (Profile Instances) > 持续分析 (Continuous Profile)。
    2. 点击打开设置 (Open Settings)。在右侧设置 (Settings) 页面,将启用特性 (Enable Feature) 下方的开关打开。设置保留时间 (Retention Period) 或保留默认值。
    3. 点击保存 (Save)。

      启用功能

访问页面

启用持续性能分析功能后,你可以通过以下任一方式访问实例性能分析页面:

  • 登录后,左侧导航条点击高级调试 (Advanced Debugging) > 实例性能分析 (Profile Instances) > 持续分析 (Continuous Profile):

    访问页面

  • 在浏览器中访问 http://127.0.0.1:2379/dashboard/#/continuous_profiling(将 127.0.0.1:2379 替换为实际 PD 实例地址和端口)。

查看性能分析历史结果

开始持续性能分析后,可以在列表中看到已经完成的性能分析结果:

历史结果

性能分析会在后台运行,刷新或退出当前页面不会终止已经运行的性能分析任务。

下载性能分析结果

进入某次分析结果后,可点击右上角下载按钮 (Download Profiling Result) 打包下载所有性能分析结果:

下载某次分析结果

也可以点击列表中的单个实例,直接查看其性能分析结果:

查看单个实例分析结果

停用持续性能分析

  1. 进入 TiDB Dashboard,选择高级调试 (Advanced Debugging) > 实例性能分析 (Profile Instances) > 持续分析 (Continuous Profile)。
  2. 点击设置 (Settings),将启用特性 (Enable Feature) 下方的开关关闭。
  3. 在弹出的停用持续分析 (Disable Continuous Profiling Feature) 对话框中,选择停用 (Disable)。
  4. 点击保存 (Save)。

停用功能