如何检查集群状态
etcd 集群状态检查指南
先决条件
检查整体状态
使用 endpoint status 检查 --endpoints 标志中指定的每个端点的总体状态:
etcdctl endpoint status (--endpoints=$ENDPOINTS|--cluster)选项
--cluster[=false]: use all endpoints from the cluster member list检查健康状况
使用 endpoint health 检查 --endpoints 标志中指定的每个端点的健康状态:
etcdctl endpoint health (--endpoints=$ENDPOINTS|--cluster)选项
--cluster[=false]: use all endpoints from the cluster member list检查键值哈希
使用 endpoint hashkv 检查 --endpoints 标志中指定的每个端点的 KV 历史哈希值:
etcdctl endpoint hashkv (--endpoints=$ENDPOINTS|--cluster) [rev=$REV]选项
--cluster[=false]: use all endpoints from the cluster member list
--rev=0: maximum revision to hash (default: latest revision)继承自父命令的选项
--endpoints="127.0.0.1:2379": gRPC endpoints
-w, --write-out="simple": set the output format (fields, json, protobuf, simple, table)示例
etcdctl --write-out=table --endpoints=$ENDPOINTS endpoint status
+------------------+------------------+---------+---------+-----------+------------+-----------+------------+--------------------+--------+
| ENDPOINT | ID | VERSION | DB SIZE | IS LEADER | IS LEARNER | RAFT TERM | RAFT INDEX | RAFT APPLIED INDEX | ERRORS |
+------------------+------------------+---------+---------+-----------+------------+-----------+------------+--------------------+--------+
| 10.240.0.17:2379 | 4917a7ab173fabe7 | 3.5.0 | 45 kB | true | false | 4 | 16726 | 16726 | |
| 10.240.0.18:2379 | 59796ba9cd1bcd72 | 3.5.0 | 45 kB | false | false | 4 | 16726 | 16726 | |
| 10.240.0.19:2379 | 94df724b66343e6c | 3.5.0 | 45 kB | false | false | 4 | 16726 | 16726 | |
+------------------+------------------+---------+---------+-----------+------------+-----------+------------+--------------------+--------|etcdctl --endpoints=$ENDPOINTS endpoint health
10.240.0.17:2379 is healthy: successfully committed proposal: took = 3.345431ms
10.240.0.19:2379 is healthy: successfully committed proposal: took = 3.767967ms
10.240.0.18:2379 is healthy: successfully committed proposal: took = 4.025451msetcdctl --cluster endpoint hashkv --write-out=table
+------------------+------------+---------------+
| ENDPOINT | HASH | HASH REVISION |
+------------------+------------+---------------+
| 10.240.0.17:2379 | 3892279174 | 3 |
| 10.240.0.18:2379 | 3892279174 | 3 |
| 10.240.0.19:2379 | 3892279174 | 3 |
+------------------+------------+---------------+
最后修改 2026年9月8日 · refactor(docs): move component documentation under /docs (f643529)
本页改编自 etcd v3.7 documentation (v3.7, commit 8245979),Copyright 2013-present etcd Authors,依 CC BY 4.0 授权,详见归属声明与修改历史。
本页为译文,如有出入以原文为准。