升级 TiDB 集群监控组件
使用 TiUP 部署 TiDB 集群时,TiUP 会同时自动部署 Prometheus、Grafana 和 Alertmanager 等监控组件,并且在集群扩容中自动为新增节点添加监控配置。通过 TiUP 自动部署的监控组件并不是这些三方组件的最新版本,如果你需要使用最新的三方组件,可以按照本文的方法升级所需的监控组件。
当管理集群时,TiUP 会使用自己的配置参数覆盖监控组件的配置。如果你直接通过替换监控组件配置文件的方式升级监控组件,在之后对集群进行 deploy
、scale-out
、scale-in
、reload
等 TiUP 操作时,该升级可能被 TiUP 所覆盖,导致升级出错。如果需要升级 Prometheus、Grafana 和 Alertmanager,请参考本文介绍的升级步骤,而不是直接替换配置文件。
升级 Prometheus
为了更好地兼容 TiDB,推荐使用 TiDB 官方安装包中自带的 Prometheus 组件安装包,该组件包中的 Prometheus 版本是固定的。如果你需要使用更高版本的 Prometheus,可以在 Prometheus 官网的 Release Note 页面查看新版本特性,选择适合你生产环境的版本,或者咨询 PingCAP 技术支持服务寻求版本建议。
在以下升级步骤中,你需要先从 Prometheus 官网下载所需版本的软件安装包,然后将其构造为可被 TiUP 使用的 Prometheus 组件安装包。
第 1 步:从 Prometheus 官网下载新版本安装包
从 Prometheus 官网下载页面下载组件安装包,并解压。
第 2 步:下载 TiDB 官方 Prometheus 安装包
在 TiDB 官网下载页面下载
TiDB-community-server
软件包,并解压。在解压文件中,找到
prometheus-v{version}-linux-amd64.tar.gz
,并解压。tar -xzf prometheus-v{version}-linux-amd64.tar.gz
第 3 步:构造新的适用于 TiUP 的 Prometheus 组件包
复制第 1 步中解压的文件,替换第 2 步解压后的
./prometheus-v{version}-linux-amd64/prometheus
目录下的对应文件。重新压缩替换文件后的
./prometheus-v{version}-linux-amd64
目录,并将新的压缩包命名为prometheus-v{new-version}.tar.gz
。其中,{new-version}
可以由你自行指定。cd prometheus-v{version}-linux-amd64 tar -zcvf ../prometheus-v{new-version}.tar.gz ./
第 4 步:使用新的组件包升级 Prometheus
执行以下命令升级 Prometheus。
tiup cluster patch <cluster-name> prometheus-v{new-version}.tar.gz -R prometheus --overwrite
升级完成后,可以打开 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 官网的下载新版本安装包
- 从 Grafana 官网下载页面下载组件安装包。你可以根据需要选择下载
OSS
版或Enterprise
版。 - 解压下载的软件包。
第 2 步:下载 TiDB 官方 Grafana 安装包
在 TiDB 官网下载页面下载
TiDB-community-server
软件包,并解压。在解压文件中,找到
grafana-v{version}-linux-amd64.tar.gz
,并解压。tar -xzf grafana-v{version}-linux-amd64.tar.gz
第 3 步:构造新的适用于 TiUP 的 Grafana 组件包
复制第 1 步中解压的文件,替换第 2 步解压后的
./grafana-v{version}-linux-amd64/
目录下的对应文件。重新压缩替换文件后的
./grafana-v{version}-linux-amd64
目录,并将新的压缩包命名为grafana-v{new-version}.tar.gz
。其中,{new-version}
可以由你自行指定。cd grafana-v{version}-linux-amd64 tar -zcvf ../grafana-v{new-version}.tar.gz ./
第 4 步:使用新的组件包升级 Grafana
执行以下命令升级 Grafana。
tiup cluster patch <cluster-name> grafana-v{new-version}.tar.gz -R grafana --overwrite
升级完成后,可以打开 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 --overwrite
升级完成后,可以打开 Alertmanager 主页(地址通常是 http://<Alertmanager-server-host-name>:9093
),点击顶部导航菜单中的 Status,然后查看 Alertmanager 的版本信息,确认升级成功。