From 13f6c8b192eca7af644805e9ea75e86ae673ac44 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Tue, 2 Jul 2024 10:22:33 +0800 Subject: [PATCH 1/9] Update deploy-monitoring-services.md --- deploy-monitoring-services.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/deploy-monitoring-services.md b/deploy-monitoring-services.md index 853d51a0ef2e..d8e2c55e2fb3 100644 --- a/deploy-monitoring-services.md +++ b/deploy-monitoring-services.md @@ -28,9 +28,9 @@ summary: 本文适用于手动部署 TiDB 监控报警系统的用户。假设 T {{< copyable "shell-regular" >}} ```bash -wget https://download.pingcap.org/prometheus-2.27.1.linux-amd64.tar.gz +wget https://download.pingcap.org/prometheus-2.49.1.linux-amd64.tar.gz wget https://download.pingcap.org/node_exporter-v1.3.1-linux-amd64.tar.gz -wget https://download.pingcap.org/grafana-7.5.11.linux-amd64.tar.gz +wget https://download.pingcap.org/grafana-7.5.17.linux-amd64.tar.gz ``` 解压二进制包： @@ -38,9 +38,9 @@ wget https://download.pingcap.org/grafana-7.5.11.linux-amd64.tar.gz {{< copyable "shell-regular" >}} ```bash -tar -xzf prometheus-2.27.1.linux-amd64.tar.gz +tar -xzf prometheus-2.49.1.linux-amd64.tar.gz tar -xzf node_exporter-v1.3.1-linux-amd64.tar.gz -tar -xzf grafana-7.5.11.linux-amd64.tar.gz +tar -xzf grafana-7.5.17.linux-amd64.tar.gz ``` ### 第 2 步：在 Node1，Node2，Node3，Node4 上启动 `node_exporter` @@ -67,7 +67,7 @@ cd node_exporter-v1.3.1-linux-amd64 {{< copyable "shell-regular" >}} ```bash -cd prometheus-2.27.1.linux-amd64 && +cd prometheus-2.49.1.linux-amd64 && vi prometheus.yml ``` @@ -139,7 +139,7 @@ scrape_configs: 编辑 Grafana 的配置文件： ```bash -cd grafana-7.5.11 && +cd grafana-7.5.17 && vi conf/grafana.ini ``` From 8131b48ac484f46a65e58833584a67508a5e28da Mon Sep 17 00:00:00 2001 From: wuhuizuo Date: Tue, 2 Jul 2024 10:53:13 +0800 Subject: [PATCH 2/9] Update deploy-monitoring-services.md --- deploy-monitoring-services.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-monitoring-services.md b/deploy-monitoring-services.md index d8e2c55e2fb3..fda4cda950b3 100644 --- a/deploy-monitoring-services.md +++ b/deploy-monitoring-services.md @@ -28,7 +28,7 @@ summary: 本文适用于手动部署 TiDB 监控报警系统的用户。假设 T {{< copyable "shell-regular" >}} ```bash -wget https://download.pingcap.org/prometheus-2.49.1.linux-amd64.tar.gz +wget https://github.com/prometheus/prometheus/releases/download/v2.49.1/prometheus-2.49.1.linux-amd64.tar.gz wget https://download.pingcap.org/node_exporter-v1.3.1-linux-amd64.tar.gz wget https://download.pingcap.org/grafana-7.5.17.linux-amd64.tar.gz ``` From a60f7c9813daabc84b71ffa75c4fa690be50afc4 Mon Sep 17 00:00:00 2001 From: xhe Date: Wed, 17 Jul 2024 10:57:51 +0800 Subject: [PATCH 3/9] example config for alert Signed-off-by: xhe --- deploy-monitoring-services.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/deploy-monitoring-services.md b/deploy-monitoring-services.md index fda4cda950b3..7912c0c9ec9a 100644 --- a/deploy-monitoring-services.md +++ b/deploy-monitoring-services.md @@ -119,6 +119,16 @@ scrape_configs: ... ``` +如需告警，可额外下载告警文件 (可从 [pingcap/tidb](https://github.com/pingcap/tidb/blob/master/pkg/metrics/alertmanager/tidb.rules.yml)，[tikv/tikv](https://github.com/tikv/tikv/blob/master/metrics/alertmanager/tikv.rules.yml)，[tikv/pd](https://github.com/tikv/pd/blob/master/metrics/alertmanager/pd.rules.yml) 下载）。并在 prometheus 中添加如下配置： + +``` +rule_files: + - 'tidb.rules.yml' + - 'pd.rules.yml' + - 'tikv.rules.yml' + - 'tikv.accelerate.rules.yml' +``` + 启动 Prometheus 服务： {{< copyable "shell-regular" >}} From ff9ce809782e02977e93b13955bb2b408f6612f7 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Wed, 17 Jul 2024 16:31:34 +0800 Subject: [PATCH 4/9] Apply suggestions from code review --- deploy-monitoring-services.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/deploy-monitoring-services.md b/deploy-monitoring-services.md index 7912c0c9ec9a..4949b84680ad 100644 --- a/deploy-monitoring-services.md +++ b/deploy-monitoring-services.md @@ -119,9 +119,9 @@ scrape_configs: ... ``` -如需告警，可额外下载告警文件 (可从 [pingcap/tidb](https://github.com/pingcap/tidb/blob/master/pkg/metrics/alertmanager/tidb.rules.yml)，[tikv/tikv](https://github.com/tikv/tikv/blob/master/metrics/alertmanager/tikv.rules.yml)，[tikv/pd](https://github.com/tikv/pd/blob/master/metrics/alertmanager/pd.rules.yml) 下载）。并在 prometheus 中添加如下配置： +如需开启 [TiDB 集群报警规则](/alert-rules.md)，请单独下载 [TiDB](https://github.com/pingcap/tidb/blob/master/pkg/metrics/alertmanager/tidb.rules.yml)、[TiKV](https://github.com/tikv/tikv/blob/master/metrics/alertmanager/tikv.rules.yml) 和 [PD](https://github.com/tikv/pd/blob/master/metrics/alertmanager/pd.rules.yml) 组件的报警规则文件，并在 Prometheus 的配置文件中添加如下配置： -``` +```ini rule_files: - 'tidb.rules.yml' - 'pd.rules.yml' From c37d353b26c250d174c57582ecfd6b2decb201e8 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Thu, 18 Jul 2024 11:13:53 +0800 Subject: [PATCH 5/9] Update deploy-monitoring-services.md --- deploy-monitoring-services.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/deploy-monitoring-services.md b/deploy-monitoring-services.md index 4949b84680ad..ab1927d33a0d 100644 --- a/deploy-monitoring-services.md +++ b/deploy-monitoring-services.md @@ -119,7 +119,7 @@ scrape_configs: ... ``` -如需开启 [TiDB 集群报警规则](/alert-rules.md)，请单独下载 [TiDB](https://github.com/pingcap/tidb/blob/master/pkg/metrics/alertmanager/tidb.rules.yml)、[TiKV](https://github.com/tikv/tikv/blob/master/metrics/alertmanager/tikv.rules.yml) 和 [PD](https://github.com/tikv/pd/blob/master/metrics/alertmanager/pd.rules.yml) 组件的报警规则文件，并在 Prometheus 的配置文件中添加如下配置： +如需开启 [TiDB 集群报警规则](/alert-rules.md)，请单独下载 TiDB、TiKV 和 PD 组件的报警规则文件 [`tidb.rules.yml`](https://github.com/pingcap/tidb/blob/master/pkg/metrics/alertmanager/tidb.rules.yml)、[`tikv.rules.yml`](https://github.com/tikv/tikv/blob/master/metrics/alertmanager/tikv.rules.yml) 和 [`pd.rules.yml`](https://github.com/tikv/pd/blob/master/metrics/alertmanager/pd.rules.yml)，并在 Prometheus 的配置文件中添加如下配置： ```ini rule_files: From 0e8606638a0774c98d9001d293b1f69ac09001f1 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Thu, 18 Jul 2024 12:10:30 +0800 Subject: [PATCH 6/9] add changes --- releases/release-8.0.0.md | 2 ++ upgrade-tidb-using-tiup.md | 2 +- 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/releases/release-8.0.0.md b/releases/release-8.0.0.md index 8c73d6ce05b7..c5fe24971e26 100644 --- a/releases/release-8.0.0.md +++ b/releases/release-8.0.0.md @@ -291,6 +291,8 @@ TiDB 版本：8.0.0 > > 以下为从 v7.6.0 升级至当前版本 (v8.0.0) 所需兼容性变更信息。如果从 v7.5.0 或之前版本升级到当前版本，可能也需要考虑和查看中间版本 Release Notes 中提到的兼容性变更信息。 +- 由 TiUP 默认部署的 Prometheus 版本从 v2.27.1 升级到 2.49.1 +- 由 TiUP 默认部署的 Grafana 版本从 7.5.11 升级到 7.5.17 - 移除未 GA 但默认启用的 witness 相关调度器 [#7765](https://github.com/tikv/pd/pull/7765) @[rleungx](https://github.com/rleungx) ### 行为变更 diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index 5c3674ca0675..985f7318dda5 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -66,7 +66,7 @@ summary: TiUP 可用于 TiDB 升级。升级过程中需注意不支持 TiFlash - 支持 TiDB Binlog，TiCDC，TiFlash 等组件版本的升级。 - 将 v6.3.0 之前的 TiFlash 升级至 v6.3.0 及之后的版本时，需要特别注意：在 Linux AMD64 架构的硬件平台部署 TiFlash 时，CPU 必须支持 AVX2 指令集。而在 Linux ARM64 架构的硬件平台部署 TiFlash 时，CPU 必须支持 ARMv8 架构。具体请参考 [6.3.0 版本 Release Notes](/releases/release-6.3.0.md#其他) 中的描述。 - 具体不同版本的兼容性说明，请查看各个版本的 [Release Note](/releases/release-notes.md)。请根据各个版本的 Release Note 的兼容性更改调整集群的配置。 -- 升级 v5.3 之前版本的集群到 v5.3 及后续版本时，默认部署的 Prometheus 会从 v2.8.1 升级到 v2.27.1，v2.27.1 提供更多的功能并解决了安全风险。Prometheus v2.27.1 相对于 v2.8.1 存在 Alert 时间格式变化，详情见 [Prometheus commit](https://github.com/prometheus/prometheus/commit/7646cbca328278585be15fa615e22f2a50b47d06)。 +- 升级 v5.3 之前版本的集群到 v5.3 及后续版本时，TiUP 默认部署的 Prometheus 生成的 Alert 存在时间格式变化。该格式变化是从 Prometheus v2.27.1 开始引入的，详情见 [Prometheus commit](https://github.com/prometheus/prometheus/commit/7646cbca328278585be15fa615e22f2a50b47d06)。 ## 2. 升级前准备 From 9f899313b070dba4f3f3b8cdd2a2f942290a079d Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Thu, 18 Jul 2024 12:14:03 +0800 Subject: [PATCH 7/9] Update release-8.0.0.md --- releases/release-8.0.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/releases/release-8.0.0.md b/releases/release-8.0.0.md index c5fe24971e26..f7df3bb3059e 100644 --- a/releases/release-8.0.0.md +++ b/releases/release-8.0.0.md @@ -291,7 +291,7 @@ TiDB 版本：8.0.0 > > 以下为从 v7.6.0 升级至当前版本 (v8.0.0) 所需兼容性变更信息。如果从 v7.5.0 或之前版本升级到当前版本，可能也需要考虑和查看中间版本 Release Notes 中提到的兼容性变更信息。 -- 由 TiUP 默认部署的 Prometheus 版本从 v2.27.1 升级到 2.49.1 +- 由 TiUP 默认部署的 Prometheus 版本从 2.27.1 升级到 2.49.1 - 由 TiUP 默认部署的 Grafana 版本从 7.5.11 升级到 7.5.17 - 移除未 GA 但默认启用的 witness 相关调度器 [#7765](https://github.com/tikv/pd/pull/7765) @[rleungx](https://github.com/rleungx) From 177ac32e091e7c71f84dc8cedc5927a5bcdae2df Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Tue, 23 Jul 2024 15:30:42 +0800 Subject: [PATCH 8/9] Update deploy-monitoring-services.md --- deploy-monitoring-services.md | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/deploy-monitoring-services.md b/deploy-monitoring-services.md index ab1927d33a0d..ee5505148b98 100644 --- a/deploy-monitoring-services.md +++ b/deploy-monitoring-services.md @@ -119,14 +119,23 @@ scrape_configs: ... ``` -如需开启 [TiDB 集群报警规则](/alert-rules.md)，请单独下载 TiDB、TiKV 和 PD 组件的报警规则文件 [`tidb.rules.yml`](https://github.com/pingcap/tidb/blob/master/pkg/metrics/alertmanager/tidb.rules.yml)、[`tikv.rules.yml`](https://github.com/tikv/tikv/blob/master/metrics/alertmanager/tikv.rules.yml) 和 [`pd.rules.yml`](https://github.com/tikv/pd/blob/master/metrics/alertmanager/pd.rules.yml)，并在 Prometheus 的配置文件中添加如下配置： +如需开启 TiDB、PD 和 TiKV 等组件的报警规则，请单独下载组件对应的报警规则文件，并在 Prometheus 的配置文件中添加报警规则文件的配置。 + +- TiDB：[`tidb.rules.yml`](https://github.com/pingcap/tidb/blob/master/pkg/metrics/alertmanager/tidb.rules.yml) +- PD：[`pd.rules.yml`](https://github.com/tikv/pd/blob/master/metrics/alertmanager/pd.rules.yml) +- TiKV：[`tikv.rules.yml`](https://github.com/tikv/tikv/blob/master/metrics/alertmanager/tikv.rules.yml) +- TiFlash：[`tiflash.rules.yml`](https://github.com/pingcap/tiflash/blob/master/metrics/alertmanager/tiflash.rules.yml) +- TiCDC：[`ticdc.rules.yml`](https://github.com/pingcap/tiflow/blob/master/metrics/alertmanager/ticdc.rules.yml) +- TiDB Lightning：[`lightning.rules.yml`](https://github.com/pingcap/tidb/blob/master/br/metrics/alertmanager/lightning.rules.yml) ```ini rule_files: - 'tidb.rules.yml' - 'pd.rules.yml' - 'tikv.rules.yml' - - 'tikv.accelerate.rules.yml' + - 'tiflash.rules.yml' + - 'ticdc.rules.yml' + - 'lightning.rules.yml' ``` 启动 Prometheus 服务： From 5c82e7932f1487683bde3b28405fc1a16e8e91c3 Mon Sep 17 00:00:00 2001 From: Grace Cai Date: Tue, 23 Jul 2024 16:40:47 +0800 Subject: [PATCH 9/9] Update upgrade-tidb-using-tiup.md --- upgrade-tidb-using-tiup.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/upgrade-tidb-using-tiup.md b/upgrade-tidb-using-tiup.md index 985f7318dda5..13f777d20e67 100644 --- a/upgrade-tidb-using-tiup.md +++ b/upgrade-tidb-using-tiup.md @@ -66,7 +66,7 @@ summary: TiUP 可用于 TiDB 升级。升级过程中需注意不支持 TiFlash - 支持 TiDB Binlog，TiCDC，TiFlash 等组件版本的升级。 - 将 v6.3.0 之前的 TiFlash 升级至 v6.3.0 及之后的版本时，需要特别注意：在 Linux AMD64 架构的硬件平台部署 TiFlash 时，CPU 必须支持 AVX2 指令集。而在 Linux ARM64 架构的硬件平台部署 TiFlash 时，CPU 必须支持 ARMv8 架构。具体请参考 [6.3.0 版本 Release Notes](/releases/release-6.3.0.md#其他) 中的描述。 - 具体不同版本的兼容性说明，请查看各个版本的 [Release Note](/releases/release-notes.md)。请根据各个版本的 Release Note 的兼容性更改调整集群的配置。 -- 升级 v5.3 之前版本的集群到 v5.3 及后续版本时，TiUP 默认部署的 Prometheus 生成的 Alert 存在时间格式变化。该格式变化是从 Prometheus v2.27.1 开始引入的，详情见 [Prometheus commit](https://github.com/prometheus/prometheus/commit/7646cbca328278585be15fa615e22f2a50b47d06)。 +- 升级 v5.3 之前版本的集群到 v5.3 及后续版本时，默认部署的 Prometheus 生成的 Alert 存在时间格式变化。该格式变化是从 Prometheus v2.27.1 开始引入的，详情见 [Prometheus commit](https://github.com/prometheus/prometheus/commit/7646cbca328278585be15fa615e22f2a50b47d06)。 ## 2. 升级前准备