Elasticsearch _cluster/stats与_stats API返回统计结果差异原因咨询

两个API返回的统计值存在差异是设计层面的统计口径不同导致的，不属于集群异常，核心差异可以分为三类：

统计范围不一致 #

• _cluster/stats 是节点维度的全集群聚合统计，覆盖所有状态的索引和分片：包括闭合索引、隐藏索引、系统内置索引（如.security、.kibana、数据流后备索引等）、删除流程中未完成物理清理的残留索引，以及未分配、初始化中、重定位中的分片，只要在集群元数据中有记录就会被计入。
• 默认不带参数调用的 /_stats 是索引维度的统计，默认仅统计open状态的非隐藏普通业务索引，闭合索引、隐藏索引、系统索引默认不会被纳入统计范围，这是索引总数不一致的核心原因。

指标计算逻辑不一致 #

• 分片计数：_cluster/stats 会把集群元数据中记录的所有分片（含未分配分片、迁移中临时存在的双写分片、所有副本分片）全部计入；_stats 仅统计已经成功分配到数据节点、可正常提供服务的活跃分片，未分配、初始化未完成的分片不会被计入。
• 文档计数：
  • _cluster/stats 的文档数是节点上报的粗粒度聚合值，包含还未执行refresh的近实时写入文档、被标记为删除但尚未被段合并清理的文档，以及恢复中分片上的冗余临时文档。
  • _stats 的文档数是分片级的精确统计，仅统计已完成refresh、可被正常搜索到的可见文档，被标记删除的文档不会被计入；其Primary文档数仅统计活跃主分片的可见文档，Total文档数为活跃主分片+所有活跃副本的可见文档总和，未分配副本、恢复中分片的文档不会被纳入计算。

统计一致性级别不一致 #

• _cluster/stats 的数据来自各节点定期上报的状态信息，默认上报间隔为10秒，聚合结果不是调用时刻的强实时值，存在天然的时间窗口偏差。
• _stats 是调用时实时向所有涉及分片的所在节点拉取当前统计值，返回的是对应分片在调用时刻的精确统计，两者的统计时间点本身就可能存在偏差，在集群有持续写入、分片迁移、索引增删操作时，数值差异会更明显。

如果需要缩小两者的数值差，可以在调用/_stats时携带参数?expand_wildcards=all&forbid_closed_indices=false，同时确保集群无未分配分片、无正在运行的分片恢复/迁移任务，此时两个API的统计结果会非常接近，但受聚合逻辑差异影响，不会完全相等。

内容的提问来源于stack exchange，提问作者ColeGulledge