TiDB 集群监控 API

TiDB 提供了以下两种接口来监控集群状态:

  • 状态接口:通过 HTTP 接口对外汇报组件的信息。
  • Metrics 接口:使用 Prometheus 记录组件中各种操作的详细信息,使用 Grafana 进行可视化展示。

使用状态接口

状态接口用于监控组件的一些基本信息,并且可以作为 keepalive 的监测接口。另外,通过 PD 的状态接口可以看到整个 TiKV 集群的详细信息。

TiDB Server

  • TiDB API 地址:http://${host}:${port}
  • 默认端口:10080

以下示例中,通过访问 http://${host}:${port}/status 获取当前 TiDB Server 的状态,并判断该 TiDB Server 是否存活。结果以 JSON 格式返回:

  1. curl http://127.0.0.1:10080/status
  1. {
  2. connections: 0, # 当前 TiDB Server 上的客户端连接数
  3. version: "5.7.25-TiDB-v4.0.0-rc-141-g7267747ae", # TiDB 版本号
  4. git_hash: "7267747ae0ec624dffc3fdedb00f1ed36e10284b" # TiDB 当前代码的 Git Hash
  5. }

PD Server

  • PD API 地址:http://${host}:${port}/pd/api/v1/${api_name}
  • 默认端口:2379
  • 各类 api_name 详细信息:参见 PD API Doc

通过该接口可以获取当前所有 TiKV 节点的状态以及负载均衡信息。下面以一个单节点的 TiKV 集群为例,说明用户需要了解的信息:

  1. curl http://127.0.0.1:2379/pd/api/v1/stores
  1. {
  2. "count": 1, # TiKV 节点数量
  3. "stores": [ # TiKV 节点的列表
  4. # 集群中单个 TiKV 节点的信息
  5. {
  6. "store": {
  7. "id": 1,
  8. "address": "127.0.0.1:20160",
  9. "version": "4.0.0-rc.2",
  10. "status_address": "172.16.5.90:20382",
  11. "git_hash": "2fdb2804bf8ffaab4b18c4996970e19906296497",
  12. "start_timestamp": 1590029618,
  13. "deploy_path": "/data2/tidb_test/v4.0.rc.2/tikv-20372/bin",
  14. "last_heartbeat": 1590030038949235439,
  15. "state_name": "Up"
  16. },
  17. "status": {
  18. "capacity": "3.581TiB", # 存储总容量
  19. "available": "3.552TiB", # 存储剩余容量
  20. "used_size": "31.77MiB",
  21. "leader_count": 174,
  22. "leader_weight": 1,
  23. "leader_score": 174,
  24. "leader_size": 174,
  25. "region_count": 531,
  26. "region_weight": 1,
  27. "region_score": 531,
  28. "region_size": 531,
  29. "start_ts": "2020-05-21T10:53:38+08:00",
  30. "last_heartbeat_ts": "2020-05-21T11:00:38.949235439+08:00",
  31. "uptime": "7m0.949235439s"
  32. }
  33. }
  34. ]

使用 metrics 接口

Metrics 接口用于监控整个集群的状态和性能。

  • 如果使用 TiDB Ansible 部署 TiDB 集群,监控系统(Prometheus 和 Grafana)会同时部署。
  • 如果使用其他方式部署 TiDB 集群,在使用 metrics 接口前,需先部署 Prometheus 和 Grafana

成功部署 Prometheus 和 Grafana 之后,配置 Grafana