升级 TiDB 集群监控组件

使用 TiUP 部署 TiDB 集群时,TiUP 会同时自动部署 Prometheus、Grafana 和 Alertmanager 等监控组件,并且在集群扩容中自动为新增节点添加监控配置。通过 TiUP 自动部署的监控组件并不是这些三方组件的最新版本,如果你需要使用最新的三方组件,可以按照本文的方法升级所需的监控组件。

当管理集群时,TiUP 会使用自己的配置参数覆盖监控组件的配置。如果你直接通过替换监控组件配置文件的方式升级监控组件,在之后对集群进行 deployscale-outscale-inreload 等 TiUP 操作时,该升级可能被 TiUP 所覆盖,导致升级出错。如果需要升级 Prometheus、Grafana 和 Alertmanager,请参考本文介绍的升级步骤,而不是直接替换配置文件。

升级 Prometheus

为了更好地兼容 TiDB,推荐使用 TiDB 官方安装包中自带的 Prometheus 组件安装包,该组件包中的 Prometheus 版本是固定的。如果你需要使用更高版本的 Prometheus,可以在 Prometheus 官网的 Release Note 页面查看新版本特性,选择适合你生产环境的版本,或者咨询 PingCAP 技术支持服务寻求版本建议。

在以下升级步骤中,你需要先从 Prometheus 官网下载所需版本的软件安装包,然后将其构造为可被 TiUP 使用的 Prometheus 组件安装包。

第 1 步:从 Prometheus 官网下载新版本安装包

Prometheus 官网下载页面下载组件安装包,并解压。

第 2 步:下载 TiDB 官方 Prometheus 安装包

  1. TiDB 官网下载页面下载 TiDB-community-server 软件包,并解压。

  2. 在解压文件中,找到 prometheus-v{version}-linux-amd64.tar.gz,并解压。

    tar -xzf prometheus-v{version}-linux-amd64.tar.gz

第 3 步:构造新的适用于 TiUP 的 Prometheus 组件包

  1. 复制第 1 步中解压的文件,替换第 2 步解压后的 ./prometheus-v{version}-linux-amd64/prometheus 目录下的对应文件。

  2. 重新压缩替换文件后的 ./prometheus-v{version}-linux-amd64 目录,并将新的压缩包命名为 prometheus-v{new-version}.tar.gz。其中,{new-version} 可以由你自行指定。

    cd prometheus-v{version}-linux-amd64.tar.gz tar -zcvf ../prometheus-v{new-version}.tar.gz ./

第 4 步:使用新的组件包升级 Prometheus

执行以下命令升级 Prometheus。

tiup cluster patch <cluster-name> prometheus-v{new-version}.tar.gz -R prometheus

升级完成后,可以打开 Prometheus 主页(地址通常是 http://<Prometheus-server-host-name>:9090),点击顶部导航菜单中的 Status,然后打开 Runtime & Build Information 页面,查看 Prometheus 的版本信息,确认升级成功。

升级 Grafana

为了更好地兼容 TiDB,推荐使用 TiDB 官方安装包中自带的 Grafana 组件安装包,该组件包中的 Grafana 版本是固定的。如果你需要使用更高版本的 Grafana,可以在 Grafana 官网的 Release Note 页面查看新版本特性,选择适合你生产环境的版本,或者咨询 PingCAP 技术支持服务寻求版本建议。

在以下升级步骤中,你需要先从 Grafana 官网下载所需版本的软件安装包,然后将其构造为可被 TiUP 使用的 Grafana 组件安装包。

第 1 步:从 Grafana 官网的下载新版本安装包

  1. Grafana 官网下载页面下载组件安装包。你可以根据需要选择下载 OSS 版或 Enterprise 版。
  2. 解压下载的软件包。

第 2 步:下载 TiDB 官方 Grafana 安装包

  1. TiDB 官网下载页面下载 TiDB-community-server 软件包,并解压。

  2. 在解压文件中,找到 grafana-v{version}-linux-amd64.tar.gz,并解压。

    tar -xzf grafana-v{version}-linux-amd64.tar.gz

第 3 步:构造新的适用于 TiUP 的 Grafana 组件包

  1. 复制第 1 步中解压的文件,替换第 2 步解压后的 ./grafana-v{version}-linux-amd64/ 目录下的对应文件。

  2. 重新压缩替换文件后的 ./grafana-v{version}-linux-amd64 目录,并将新的压缩包命名为 grafana-v{new-version}.tar.gz。其中,{new-version} 可以由你自行指定。

    cd grafana-v{version}-linux-amd64.tar.gz tar -zcvf ../grafana-v{new-version}.tar.gz ./

第 4 步:使用新的组件包升级 Grafana

执行以下命令升级 Grafana。

tiup cluster patch <cluster-name> grafana-v{new-version}.tar.gz -R grafana

升级完成后,可以打开 Grafana 主页(地址通常是 http://<Grafana-server-host-name>:3000),查看 Grafana 的版本信息,确认升级成功。

升级 Alertmanager

TiDB 安装包中直接使用了 Alertmanager 官方组件包,因此升级 Alertmanager 时你只需要下载并安装新版本的官方组件包。

第 1 步:从 Prometheus 官网下载新版本安装包

Prometheus 官网下载页面下载 alertmanager 组件安装包。

第 2 步:使用新的组件包升级 Alertmanager

执行以下命令升级 Alertmanager:

tiup cluster patch <cluster-name> alertmanager-v{new-version}-linux-amd64.tar.gz -R alertmanager

升级完成后,可以打开 Alertmanager 主页(地址通常是 http://<Alertmanager-server-host-name>:9093),点击顶部导航菜单中的 Status,然后查看 Alertmanager 的版本信息,确认升级成功。