技术分享 | 技术分享 | Zabbix 监控 TiDB (二)

Zabbix监控TiDB：手工创建模板与配置实战

最新推荐文章于 2025-09-19 01:11:50 发布

原创

最新推荐文章于 2025-09-19 01:11:50 发布 · 1.3k 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#TiDB #Zabbix #监控

本文介绍了如何在Zabbix 5.0.5中手工创建监控模板来监控TiDB，包括如何配置HTTP agent获取监控数据，使用数据预处理将Prometheus格式转换为JSON，以及创建监控项(item)和触发器(trigger)，以监控tidb_session_schema_lease_error_total等指标。详细步骤和示例帮助理解如何在无法升级到Zabbix 5.4时实现TiDB监控。

作者：胡呈清

爱可生 DBA 团队成员，擅长故障分析、性能优化，个人博客：https://www.jianshu.com/u/a95ec11f67a8，欢迎讨论。

本文来源：原创投稿

*爱可生开源社区出品，原创内容未经授权不得随意使用，转载请联系小编并注明来源。

如果要使用 Zabbix 监控使用 TiDB，需使用 HTTP agent ，主动调用 TiDB 监控接口获取监控数据，然后配置数据预处理：选择使用 Prometheus pattern 或者 Prometheus to JSON 方法，但是这两个功能是在 Zabbix4.2 中加入的，Zabbix4.0.x 没有这个功能（即使是最新的 zabbix4.0.35）：

所以在没法升级到 Zabbix5.4 时，我们可以在大于 4.2 的版本上手工创建监控模板，以下演示环境为 Zabbix5.0.5。

TiDB 监控接口

在开始前，需要先了解 TiDB 的监控接口：https://docs.pingcap.com/zh/tidb/v5.1/tidb-monitoring-api

示例：

curl http://127.0.0.1:10080/metrics > /tmp/tidb_metics

参考TiDB 官网上的告警规则（https://docs.pingcap.com/zh/tidb/v5.1/alert-rules）中的第一条告警规则：

increase(tidb_session_schema_lease_error_total{type="outdated"}[15m]) > 0

这个是 prometheus 的语法，我们只需要知道 tidb_session_schema_lease_error_total 是 metrics name 就行，然后我们去监控数据中找到这个 metric（TiDB的不同版本metric可能不一样，示例中的 metric 在4.0.10中就没有，在5.1中有）：

[root@localhost tmp]# grep tidb_session_schema_lease_error_total /tmp/tidb_metics 
# HELP tidb_session_schema_lease_error_total Counter of schema lease error 
# TYPE tidb_session_schema_lease_error_total counter t

最低0.47元/天解锁文章