ElasticSearch的REST APIs 之 索引的监控(monitoring)

基于ES7.7 官方文档

内容包括:

• 索引的统计信息 (Index stats)
• 索引的段 (Index segments)
• 索引的恢复信息 (Index recovery)
• 索引分片的存储 (Index shard stores)

索引的统计信息 (Index stats API)

获取索引的统计信息。官方文档

GET /<index>/_stats
GET /<index>/_stats/<index-metric>
GET /_stats

使用索引的统计API来获取索引的高级聚合和统计信息。

默认情况下，返回的统计信息是索引级别(index-level)的，包含primaries和total聚合。 primaries只是主分片(primary shards)的信息，total是主分片和副本分片(replica shards)的累加。

要获取分片级(shard-level)的统计信息，请将level参数设置为shards。

当移动到另一个节点时，该分片的分片级统计信息将从原节点清除。 尽管该分片不再是原节点的一部分，但该原节点仍保留了这个分片的所有节点级(node-level)统计信息。

路径参数

<index>

  (可选, string) 索引名称，支持多个索引名称的英文逗号分割、通配符表达式。如果要获取所有索引的统计信息，使用all或*或干脆直接忽略这个参数。

<index-metric>

  (可选, string) 索引的指标，支持多个索引名称的英文逗号分割。可选的指标包括：

• all 返回所有统计信息
• completion 自动完成建议(Completion suggester) 的统计信息。是有关自动完成(auto-complete)、即时搜索(search-as-you-type)的统计信息
• docs 文档及已删除但尚未合并的文档的数量。 索引刷新(index refreshes)会影响这个统计数据。
• fielddata 字段数据(fielddata)的统计信息。
• flush 刷数据到磁盘(flush)统计信息
• get et的统计信息, 包括丢失的(missing)统计信息。
• indexing 索引(indexing)统计信息
• merge 合并(merge)统计信息
• query_cache: 查询缓存(query cache) 统计信息
• refresh 刷缓存数据到操作系统缓存(refresh)统计信息
• request_cache 分片请求缓存(shard request cache)统计信息
• search 搜索的统计信息包括建议(suggest)的统计。可以通过添加额外的参数groups(搜索操作可以与一个或多个组关联)来包含自定义组的统计信息。 参数groups接受逗号分割的组名称列表。 使用_all返回所有组的统计信息。
• segments 所有打开的段(segments)使用的内存。 如果参数include_segment_file_sizes设置为true，该指标会包括每个Lucene索引文件的磁盘占用的总和。
• store 索引的大小(size), 使用字节单位(byte unit)
• suggest [自动补全(suggester)]统计
• translog translog统计
• warmer warmer统计. 注: warmers已被移除，有更好的方法替代之。

查询参数

expand_wildcards

  (可选, string) 通配符查询时可以匹配的索引的条件， 多个值之间以英文逗号分割， 比如"open,hidden"。

  默认open，可用的值有：

• all: 匹配所有open和closed的索引, 包括隐藏的(hidden).
• open: 表示只匹配开放中的索引
• closed: 只匹配关闭的(closed)的索引
• hidden: 匹配隐藏的(hidden)的