集群统计 API编辑

返回集群统计信息。

请求编辑

GET /_cluster/stats

GET /_cluster/stats/nodes/<node_filter>

先决条件编辑

  • 如果启用了 Elasticsearch 安全功能,则必须具有 monitormanage 集群权限 才能使用此 API。

描述编辑

集群统计 API 允许从集群范围的角度检索统计信息。该 API 返回基本索引指标(分片数量、存储大小、内存使用情况)以及有关构成集群的当前节点的信息(数量、角色、操作系统、JVM 版本、内存使用情况、CPU 和已安装的插件)。

路径参数编辑

<node_filter>
(可选,字符串) 用于限制返回信息的 节点过滤器 的逗号分隔列表。默认为集群中的所有节点。

查询参数编辑

timeout
(可选,时间单位) 等待每个节点响应的期限。如果节点在超时时间到期之前没有响应,则响应不包含其统计信息。但是,超时节点将包含在响应的 _nodes.failed 属性中。默认为无超时。

响应主体编辑

_nodes

(对象) 包含有关请求的 节点过滤器 选择的节点数量的统计信息。

_nodes 的属性
total
(整数) 请求选择的节点总数。
successful
(整数) 成功响应请求的节点数量。
failed
(整数) 拒绝请求或无法响应的节点数量。如果此值不为 0,则响应中将包含拒绝或失败的原因。
cluster_name
(字符串) 集群名称,基于 集群名称设置 设置。
cluster_uuid
(字符串) 集群的唯一标识符。
timestamp
(整数) Unix 时间戳(以毫秒为单位),表示上次刷新集群统计信息的时间。
status

(字符串) 集群的健康状况,基于其主分片和副本分片的状态。状态为

  • green:所有分片都已分配。
  • yellow:所有主分片都已分配,但一个或多个副本分片未分配。如果集群中的节点发生故障,则某些数据可能不可用,直到该节点修复为止。
  • red:一个或多个主分片未分配,因此某些数据不可用。这可能在集群启动期间短暂发生,因为主分片已分配。

请参阅 集群健康

indices

(对象) 包含有关已将分片分配给所选节点的索引的统计信息。

indices 的属性
count
(整数) 已将分片分配给所选节点的索引总数。
shards

(对象) 包含有关已将分片分配给所选节点的统计信息。

shards 的属性
total
(整数) 已将分片分配给所选节点的总数。
primaries
(整数) 已将主分片分配给所选节点的数量。
replication
(浮点数) 所有所选节点中副本分片与主分片的比率。
index

(对象) 包含有关已将分片分配给所选节点的统计信息。

index 的属性
shards

(对象) 包含有关已将分片分配给所选节点的数量的统计信息。

shards 的属性
min
(整数) 索引中的最小分片数量,仅计算已分配给所选节点的分片。
max
(整数) 索引中的最大分片数量,仅计算已分配给所选节点的分片。
avg
(浮点数) 索引中的平均分片数量,仅计算已分配给所选节点的分片。
primaries

(对象) 包含有关已将主分片分配给所选节点的数量的统计信息。

primaries 的属性
min
(整数) 索引中的最小主分片数量,仅计算已分配给所选节点的分片。
max
(整数) 索引中的最大主分片数量,仅计算已分配给所选节点的分片。
avg
(浮点数) 索引中的平均主分片数量,仅计算已分配给所选节点的分片。
replication

(对象) 包含有关已将副本分片分配给所选节点的数量的统计信息。

replication 的属性
min
(浮点数) 索引中的最小副本因子,仅计算已分配给所选节点的分片。
max
(浮点数) 索引中的最大副本因子,仅计算已分配给所选节点的分片。
avg
(浮点数) 索引中的平均副本因子,仅计算已分配给所选节点的分片。
docs

(对象) 包含所选节点中文档的计数。

docs 的属性
count

(整数) 所有已分配给所选节点的主分片中未删除文档的总数。

此数字基于 Lucene 段中的文档,可能包括来自嵌套字段的文档。

deleted

(整数) 所有已分配给所选节点的主分片中已删除文档的总数。

此数字基于 Lucene 段中的文档。Elasticsearch 在合并段时会回收已删除的 Lucene 文档的磁盘空间。

total_size_in_bytes
(整数) 所有已分配给所选节点的主分片中的总大小(以字节为单位)。
store

(对象) 包含有关已将分片分配给所选节点的大小统计信息。

store 的属性
size
(字节单位) 已将所有分片分配给所选节点的总大小。
size_in_bytes
(整数) 已将所有分片分配给所选节点的总大小(以字节为单位)。
total_data_set_size
(字节单位) 已将所有分片分配给所选节点的总数据集大小。这包括未完全存储在节点上的分片的大小,例如 部分挂载索引 的缓存。
total_data_set_size_in_bytes
(整数) 已将所有分片分配给所选节点的总数据集大小(以字节为单位)。这包括未完全存储在节点上的分片的大小,例如 部分挂载索引 的缓存。
reserved
(字节值) 对由于正在进行的同行恢复、还原快照和类似活动而导致的分片存储最终增长多少的预测。
reserved_in_bytes
(整数) 对由于正在进行的同行恢复、还原快照和类似活动而导致的分片存储最终增长多少的预测(以字节为单位)。
fielddata

(对象) 包含有关所选节点的 字段数据缓存 的统计信息。

fielddata 的属性
memory_size
(字节单位) 所有已分配给所选节点的分片中用于字段数据缓存的总内存量。
memory_size_in_bytes
(整数) 所有已分配给所选节点的分片中用于字段数据缓存的总内存量(以字节为单位)。
evictions
(整数) 所有已分配给所选节点的分片中从字段数据缓存中驱逐的总数。
global_ordinals.build_time
(时间单位) 为所有字段构建全局序数所花费的总时间。
global_ordinals.build_time_in_millis
(整数) 为所有字段构建全局序数所花费的总时间(以毫秒为单位)。
global_ordinals.fields.[field-name].build_time
(时间单位) 为指定名称的字段构建全局序数所花费的总时间。
global_ordinals.fields.[field-name].build_time_in_millis
(整数) 为指定名称的字段构建全局序数所花费的总时间(以毫秒为单位)。
global_ordinals.fields.[field-name].shard_max_value_count
(长整数) 为指定名称的字段构建全局序数所花费的总时间。
query_cache

(对象) 包含有关所选节点的查询缓存的统计信息。

query_cache 的属性
memory_size
(字节单位) 所有已分配给所选节点的分片中用于查询缓存的总内存量。
memory_size_in_bytes
(整数) 所有已分配给所选节点的分片中用于查询缓存的总内存量(以字节为单位)。
total_count
(整数) 所有已分配给所选节点的分片中查询缓存中命中和未命中的总数。
hit_count
(整数) 所有已分配给所选节点的分片中查询缓存命中的总数。
miss_count
(整数) 所有已分配给所选节点的分片中查询缓存未命中的总数。
cache_size
(整数) 所有已分配给所选节点的分片中当前在查询缓存中的条目总数。
cache_count
(整数) 所有已分配给所选节点的分片中添加到查询缓存中的条目总数。此数字包括当前条目和已驱逐条目。
evictions
(整数) 所有已分配给所选节点的分片中查询缓存驱逐的总数。
completion

(对象) 包含有关所选节点中用于完成的内存使用情况的统计信息。

completion 的属性
size
(字节单位) 所有已分配给所选节点的分片中用于完成的总内存量。
size_in_bytes
(整数) 所有已分配给所选节点的分片中用于完成的总内存量(以字节为单位)。
segments

(对象) 包含有关所选节点中段的统计信息。

segments 的属性
count
(整数) 所有已分配给所选节点的分片中的段总数。
memory
(字节单位) 所有已分配给所选节点的分片中用于段的总内存量。
memory_in_bytes
(整数) 所有已分配给所选节点的分片中用于段的总内存量(以字节为单位)。
terms_memory
(字节单位) 所有已分配给所选节点的分片中用于术语的总内存量。
terms_memory_in_bytes
(整数) 所有已分配给所选节点的分片中用于术语的总内存量(以字节为单位)。
stored_fields_memory
(字节单位) 所有分配给所选节点的分片中存储字段使用的总内存量。
stored_fields_memory_in_bytes
(整数) 所有分配给所选节点的分片中存储字段使用的总内存量(以字节为单位)。
term_vectors_memory
(字节单位) 所有分配给所选节点的分片中术语向量使用的总内存量。
term_vectors_memory_in_bytes
(整数) 所有分配给所选节点的分片中术语向量使用的总内存量(以字节为单位)。
norms_memory
(字节单位) 所有分配给所选节点的分片中规范化因子使用的总内存量。
norms_memory_in_bytes
(整数) 所有分配给所选节点的分片中规范化因子使用的总内存量(以字节为单位)。
points_memory
(字节单位) 所有分配给所选节点的分片中点使用的总内存量。
points_memory_in_bytes
(整数) 所有分配给所选节点的分片中点使用的总内存量(以字节为单位)。
doc_values_memory
(字节单位) 所有分配给所选节点的分片中文档值使用的总内存量。
doc_values_memory_in_bytes
(整数) 所有分配给所选节点的分片中文档值使用的总内存量(以字节为单位)。
index_writer_memory
(字节单位) 所有分配给所选节点的分片中所有索引写入器使用的总内存量。
index_writer_memory_in_bytes
(整数) 所有分配给所选节点的分片中所有索引写入器使用的总内存量(以字节为单位)。
version_map_memory
(字节单位) 所有分配给所选节点的分片中所有版本映射使用的总内存量。
version_map_memory_in_bytes
(整数) 所有分配给所选节点的分片中所有版本映射使用的总内存量(以字节为单位)。
fixed_bit_set

(字节单位) 所有分配给所选节点的分片中固定位集使用的总内存量。

固定位集用于嵌套对象字段类型和连接字段的类型过滤器。

fixed_bit_set_memory_in_bytes
(整数) 所有分配给所选节点的分片中固定位集使用的总内存量(以字节为单位)。
max_unsafe_auto_id_timestamp
(整数) 最近一次重试的索引请求的Unix 时间戳(以毫秒为单位)。
file_sizes

(对象) 此对象不会由集群统计信息 API 填充。

要获取有关段文件的信息,请使用节点统计信息 API

mappings

(对象) 包含有关所选节点中字段映射的统计信息。

mappings 的属性
total_field_count
(整数) 所有非系统索引中的字段总数。
total_deduplicated_field_count
(整数) 所有非系统索引中的字段总数,考虑了映射去重。
total_deduplicated_mapping_size
(字节单位) 去重和压缩后所有映射的总大小。
total_deduplicated_mapping_size_in_bytes
(整数) 去重和压缩后所有映射的总大小(以字节为单位)。
field_types

(对象数组) 包含有关所选节点中使用的字段数据类型的统计信息。

field_types 对象的属性
name
(字符串) 所选节点中使用的字段数据类型。
count
(整数) 所选节点中映射到字段数据类型的字段数量。
index_count
(整数) 所选节点中包含字段数据类型映射的索引数量。
indexed_vector_count
(整数) 对于 dense_vector 字段类型,所选节点中索引的向量类型的数量。
indexed_vector_dim_min
(整数) 对于 dense_vector 字段类型,所选节点中所有索引的向量类型的最小维度。
indexed_vector_dim_max
(整数) 对于 dense_vector 字段类型,所选节点中所有索引的向量类型的最大维度。
script_count
(整数) 声明脚本的字段数量。
lang
(字符串数组) 用于可选脚本的脚本语言
lines_max
(整数) 单个字段脚本的最大行数
lines_total
(整数) 脚本的总行数
chars_max
(整数) 单个字段脚本的最大字符数
chars_total
(整数) 脚本的总字符数
source_max
(整数) 单个字段脚本对 _source 的最大访问次数
source_total
(整数) 脚本对 _source 的总访问次数
doc_max
(整数) 单个字段脚本对 doc_values 的最大访问次数
doc_total
(整数) 脚本对 doc_values 的总访问次数
runtime_field_types

(对象数组) 包含有关所选节点中使用的运行时字段数据类型的统计信息。

runtime_field_types 对象的属性
name
(字符串) 所选节点中使用的字段数据类型。
count
(整数) 所选节点中映射到字段数据类型的运行时字段数量。
index_count
(整数) 所选节点中包含运行时字段数据类型映射的索引数量。
scriptless_count
(整数) 不声明脚本的运行时字段数量。
shadowed_count
(整数) 覆盖索引字段的运行时字段数量。
lang
(字符串数组) 用于运行时字段脚本的脚本语言
lines_max
(整数) 单个运行时字段脚本的最大行数
lines_total
(整数) 定义当前运行时字段数据类型的脚本的总行数
chars_max
(整数) 单个运行时字段脚本的最大字符数
chars_total
(整数) 定义当前运行时字段数据类型的脚本的总字符数
source_max
(整数) 单个运行时字段脚本对 _source 的最大访问次数
source_total
(整数) 定义当前运行时字段数据类型的脚本对 _source 的总访问次数
doc_max
(整数) 单个运行时字段脚本对 doc_values 的最大访问次数
doc_total
(整数) 定义当前运行时字段数据类型的脚本对 doc_values 的总访问次数
analysis

(对象) 包含有关所选节点中使用的分析器和分析器组件的统计信息。

analysis 的属性
char_filter_types

(对象数组) 包含有关所选节点中使用的字符过滤器类型的统计信息。

char_filter_types 对象的属性
name
(字符串) 所选节点中使用的字符过滤器类型。
count
(整数) 所选节点中使用字符过滤器类型的分析器或规范化器的数量。
index_count
(整数) 所选节点中字符过滤器类型的索引数量。
tokenizer_types

(对象数组) 包含有关所选节点中使用的分词器类型的统计信息。

tokenizer_types 对象的属性
name
(字符串) 所选节点中使用的分词器类型。
count
(整数) 所选节点中使用分词器类型的分析器或规范化器的数量。
index_count
(整数) 所选节点中使用分词器类型的索引数量。
filter_types

(对象数组) 包含有关所选节点中使用的标记过滤器类型的统计信息。

filter_types 对象的属性
name
(字符串) 所选节点中使用的标记过滤器类型。
count
(整数) 所选节点中使用标记过滤器类型的分析器或规范化器的数量。
index_count
(整数) 所选节点中使用标记过滤器类型的索引数量。
analyzer_types

(对象数组) 包含有关所选节点中使用的分析器类型的统计信息。

analyzer_types 对象的属性
name
(字符串) 所选节点中使用的分析器类型。
count
(整数) 所选节点中分析器类型的出现次数。
index_count
(整数) 所选节点中使用分析器类型的索引数量。
built_in_char_filters

(对象数组) 包含有关所选节点中使用的内置字符过滤器的统计信息。

built_in_char_filters 对象的属性
name
(字符串) 所选节点中使用的内置字符过滤器。
count
(整数) 所选节点中使用内置字符过滤器的分析器或规范化器的数量。
index_count
(整数) 所选节点中使用内置字符过滤器的索引数量。
built_in_tokenizers

(对象数组) 包含有关所选节点中使用的内置分词器的统计信息。

built_in_tokenizers 对象的属性
name
(字符串) 所选节点中使用的内置分词器。
count
(整数) 所选节点中使用内置分词器的分析器或规范化器的数量。
index_count
(整数) 所选节点中使用内置分词器的索引数量。
built_in_filters

(对象数组) 包含有关所选节点中使用的内置标记过滤器的统计信息。

built_in_filters 对象的属性
name
(字符串) 所选节点中使用的内置标记过滤器。
count
(整数) 所选节点中使用内置标记过滤器的分析器或规范化器的数量。
index_count
(整数) 所选节点中使用内置标记过滤器的索引数量。
built_in_analyzers

(对象数组) 包含有关所选节点中使用的内置分析器的统计信息。

built_in_analyzers 对象的属性
name
(字符串) 所选节点中使用的内置分析器。
count
(整数) 所选节点中内置分析器的出现次数。
index_count
(整数) 所选节点中使用内置分析器的索引数量。
synonyms

(对象) 包含有关在同义词同义词图标记过滤器配置中定义的同义词的统计信息。

synonyms 对象的属性
inline

(对象) 使用同义词或同义词图标记过滤器中的synonyms 配置定义的内联同义词。

inline 对象的属性
count
(整数) 在选定节点中内联同义词配置的出现次数。每个内联同义词配置将被单独计算,无论定义了哪些同义词。两个具有相同同义词的同义词配置将被视为单独的出现。
index_count
(整数) 使用内联同义词配置用于同义词标记过滤器索引的数量。
路径

(对象) 包含有关在 同义词同义词图 标记过滤器配置中定义为 synonyms_path 的同义词文件的统计信息。

paths 对象的属性
count
(整数) 在选定节点中唯一同义词路径的出现次数。
index_count
(整数) 使用 synonyms_path 配置用于同义词标记过滤器的索引数量。

(对象) 包含有关在 同义词同义词图 标记过滤器配置中定义为 synonyms_set 的同义词集的统计信息。

sets 对象的属性
count
(整数) 在选定节点中唯一同义词集的出现次数。
index_count
(整数) 使用 synonyms_set 配置用于同义词标记过滤器的索引数量。
搜索

(对象) 包含有关提交给选定节点(在搜索执行期间充当协调器)的搜索请求的使用统计信息。当搜索请求成功解析时,会跟踪搜索请求,无论其结果如何:解析后产生错误的请求会计入使用统计信息,以及未访问任何数据的请求。

search 对象的属性
total
(整数) 接收到的搜索请求总数。未指定请求体的搜索请求不计入。
查询
(对象) 在选定节点中使用的查询类型。对于每个查询,都会报告名称和在 querypost_filter 部分中使用次数。每个搜索请求只计算一次查询,这意味着如果在同一个搜索请求中多次使用相同的查询类型,则其计数器将增加 1,而不是增加在该单个搜索请求中使用次数。
部分
(对象) 在选定节点中使用的搜索部分。对于每个部分,都会报告名称和使用次数。
密集向量

(对象) 包含有关在选定节点中使用的索引密集向量的统计信息。

dense_vector 的属性
值计数
(整数) 在选定节点中索引的密集向量总数。
节点

(对象) 包含有关由请求的 节点过滤器 选择的节点的统计信息。

nodes 的属性
count

(对象) 包含由请求的 节点过滤器 选择的节点的计数。

count 的属性
total
(整数) 选定节点的总数。
仅协调
(整数) 没有 角色 的选定节点数量。这些节点被认为是 仅协调 节点。
<角色>
(整数) 具有该角色的选定节点数量。有关角色列表,请参阅 节点
版本
(字符串数组) 在选定节点上使用的 Elasticsearch 版本数组。
操作系统

(对象) 包含有关选定节点使用的操作系统的统计信息。

os 的属性
可用处理器
(整数) 所有选定节点上 JVM 可用的处理器数量。
已分配处理器

(整数) 用于计算所有选定节点的线程池大小的处理器数量。

此数字可以通过节点的 processors 设置进行设置,默认值为操作系统报告的处理器数量。在这两种情况下,此数字都不会大于 32

名称

(对象数组) 包含有关选定节点使用的操作系统的统计信息。

names 的属性
name
(字符串) 一个或多个选定节点使用的操作系统的名称。
count
(字符串) 使用该操作系统的选定节点数量。
漂亮名称

(对象数组) 包含有关选定节点使用的操作系统的统计信息。

pretty_names 的属性
漂亮名称
(字符串) 一个或多个选定节点使用的操作系统的易于理解的名称。
count
(字符串) 使用该操作系统的选定节点数量。
架构

(对象数组) 包含有关选定节点使用的处理器架构(例如,x86_64 或 aarch64)的统计信息。

architectures 的属性
架构
(字符串) 一个或多个选定节点使用的架构的名称。
count
(字符串) 使用该架构的选定节点数量。
内存

(对象) 包含有关选定节点使用的内存的统计信息。

mem 的属性
total
(字节大小单位) 所有选定节点的物理内存总量。
总字节数
(整数) 所有选定节点的物理内存总量(以字节为单位)。
调整后的总计
(字节值) 所有选定节点的内存总量,但使用使用 es.total_memory_bytes 系统属性指定的数值,而不是测量那些设置了该系统属性的节点的总内存。
调整后的总字节数
(整数) 所有选定节点的内存总量(以字节为单位),但使用使用 es.total_memory_bytes 系统属性指定的数值,而不是测量那些设置了该系统属性的节点的总内存。
空闲
(字节大小单位) 所有选定节点的空闲物理内存量。
空闲字节数
(整数) 所有选定节点的空闲物理内存量(以字节为单位)。
已使用
(字节大小单位) 所有选定节点中正在使用的物理内存量。
已使用字节数
(整数) 所有选定节点中正在使用的物理内存量(以字节为单位)。
空闲百分比
(整数) 所有选定节点的空闲物理内存百分比。
已使用百分比
(整数) 所有选定节点中正在使用的物理内存百分比。
进程

(对象) 包含有关选定节点使用的进程的统计信息。

process 的属性
CPU

(对象) 包含有关选定节点使用的 CPU 的统计信息。

cpu 的属性
百分比
(整数) 所有选定节点使用的 CPU 百分比。如果不受支持,则返回 -1
打开的文件描述符

(对象) 包含有关选定节点中打开的文件描述符的统计信息。

open_file_descriptors 的属性
min
(整数) 所有选定节点中并发打开的文件描述符的最小数量。如果不受支持,则返回 -1
max
(整数) 所有选定节点中并发打开的文件描述符的最大数量。如果不受支持,则返回 -1
avg
(整数) 并发打开的文件描述符的平均数量。如果不受支持,则返回 -1
JVM

(对象) 包含有关选定节点使用的 Java 虚拟机 (JVM) 的统计信息。

jvm 的属性
最大正常运行时间
(时间单位) 自 JVM 上次启动以来的正常运行时间持续时间。
最大正常运行时间(毫秒)
(整数) 自 JVM 上次启动以来的正常运行时间持续时间(以毫秒为单位)。
版本

(对象数组) 包含有关选定节点使用的 JVM 版本的统计信息。

versions 的属性
版本
(字符串) 一个或多个选定节点使用的 JVM 版本。
VM 名称
(字符串) JVM 的名称。
VM 版本

(字符串) JVM 的完整版本号。

完整版本号包括一个加号 (+),后跟构建号。

VM 供应商
(字符串) JVM 的供应商。
捆绑的 JDK
(布尔值) 始终为 true。所有发行版都附带捆绑的 Java 开发工具包 (JDK)。
使用捆绑的 JDK
(布尔值) 如果为 true,则 JVM 正在使用捆绑的 JDK。
count
(整数) 使用 JVM 的选定节点总数。
内存

(对象) 包含有关选定节点使用的内存的统计信息。

mem 的属性
堆已使用
(字节大小单位) 所有选定节点的堆当前正在使用的内存。
堆已使用字节数
(整数) 所有选定节点的堆当前正在使用的内存(以字节为单位)。
堆最大值
(字节大小单位) 所有选定节点的堆可用于使用的最大内存量(以字节为单位)。
堆最大字节数
(整数) 所有选定节点的堆可用于使用的最大内存量(以字节为单位)。
线程
(整数) 所有选定节点的 JVM 正在使用的活动线程数量。
文件系统

(对象) 包含有关选定节点的文件存储的统计信息。

fs 的属性
total
(字节大小单位) 所有选定节点的所有文件存储的总大小。
总字节数
(整数) 所有选定节点的所有文件存储的总大小(以字节为单位)。
空闲
(字节大小单位) 所有选定节点的文件存储中未分配的磁盘空间量。
空闲字节数
(整数) 所有选定节点的文件存储中未分配的字节总数。
可用

(字节大小单位) 所有选定节点的文件存储中 JVM 可用的磁盘空间总量。

根据操作系统或进程级限制,此数量可能小于 nodes.fs.free。这是选定的 Elasticsearch 节点可以使用的实际空闲磁盘空间量。

可用字节数

(整数) 所有选定节点的文件存储中 JVM 可用的字节总数。

根据操作系统或进程级限制,此数量可能小于 nodes.fs.free_in_byes。这是选定的 Elasticsearch 节点可以使用的实际空闲磁盘空间量。

插件

(对象数组) 包含有关选定节点安装的插件和模块的统计信息。

如果未安装任何插件或模块,则此数组为空。

plugins 的属性
<插件>

(对象) 包含有关已安装插件或模块的统计信息。

<plugin> 的属性
name
(字符串) Elasticsearch 插件的名称。
版本
(字符串) 构建插件的 Elasticsearch 版本。
elasticsearch_version
(字符串) 构建插件的 Elasticsearch 版本。
java_version
(字符串) 构建插件的 Java 版本。
描述
(字符串) 插件的简短描述。
类名
(字符串) 用作插件入口点的类名。
扩展插件

(字符串数组) 通过 Java 服务提供者接口 (SPI) 由此插件扩展的其他插件的数组。

如果此插件未扩展任何其他插件,则此数组为空。

具有本机控制器
(布尔值) 如果为 true,则该插件具有本机控制器进程。
网络类型

(对象) 包含有关选定节点使用的传输和 HTTP 网络的统计信息。

属性 network_types
transport_types

(对象) 包含有关选定节点使用的传输网络类型的统计信息。

属性 transport_types
<transport_type>
(整数) 使用该传输类型的选定节点数量。
http_types

(对象) 包含有关选定节点使用的 HTTP 网络类型的统计信息。

属性 http_types
<http_type>
(整数) 使用该 HTTP 类型的选定节点数量。
discovery_types

(对象) 包含有关选定节点使用的 发现类型 的统计信息。

属性 discovery_types
<discovery_type>
(整数) 使用该 发现类型 查找其他节点的选定节点数量。
packaging_types

(对象数组) 包含有关安装在选定节点上的 Elasticsearch 发行版的统计信息。

属性 packaging_types
flavor
(字符串) Elasticsearch 发行版的类型。这始终为 default
type
(字符串) 用于发行版包的文件类型,例如 tarzip
count
(整数) 使用该发行版风格和文件类型的选定节点数量。
snapshots

(对象) 包含有关集群中 快照 活动的统计信息。

属性 snapshots
current_counts

(对象) 包含报告集群中各种正在进行的快照活动的数量的统计信息。

属性 current_counts
snapshots
(整数) 集群当前正在创建的快照和克隆的总数。
shard_snapshots
(整数) 集群中未完成的分片快照总数。
snapshot_deletions
(整数) 集群当前正在运行的快照删除操作总数。
concurrent_operations
(整数) 集群当前正在并发运行的快照操作总数。这是 snapshotssnapshot_deletions 条目的总数,并且受 snapshot.max_concurrent_operations 设置 的限制。
cleanups
(整数) 集群当前正在运行的存储库清理操作总数。这些操作不计入并发操作总数。
repositories

(对象) 包含报告按存储库细分的快照活动进度的统计信息。此对象包含集群注册的每个存储库的一个条目。

属性 repositories
current_counts

(对象) 包含报告该存储库中各种正在进行的快照活动的数量的统计信息。

属性 current_counts
snapshots
(整数) 该存储库中正在进行的快照总数。
clones
(整数) 该存储库中正在进行的快照克隆总数。
finalizations
(整数) 该存储库中正在进行的快照和克隆操作总数,这些操作大部分已完成,但其最后的“最终化”步骤除外。
deletions
(整数) 该存储库中正在进行的快照删除操作总数。
snapshot_deletions
(整数) 当前正在从该存储库中删除的快照总数。
active_deletions
(整数) 该存储库中当前处于活动状态的正在进行的快照删除操作总数。快照删除不会与其他快照操作并发运行,因此如果任何待处理的删除正在等待其他操作完成,则这可能为 0
shards

(对象) 包含报告存储库中正在进行的快照活动的细粒度进度的统计信息。请注意,这些统计信息仅与正在进行的快照相关。

shards 的属性
total
(整数) 该存储库当前跟踪的分片快照总数。此统计信息仅计算正在进行的快照中的分片,因此当快照完成时它将下降,如果没有任何正在进行的快照,则它将为 0
complete
(整数) 该存储库中已完成的跟踪分片快照总数。此统计信息仅计算正在进行的快照中的分片,因此当快照完成时它将下降,如果没有任何正在进行的快照,则它将为 0
incomplete
(整数) 该存储库中未完成的跟踪分片快照总数。这是 totalcomplete 值之间的差值。
states
(对象) 该存储库中每个命名状态的分片快照总数。这些状态是快照过程的实现细节,可能会在不同版本之间发生变化。它们包含在这里是为了专家用户,但在其他情况下应忽略。
oldest_start_time
(字符串) 该存储库中运行时间最长的快照的开始时间。
oldest_start_time_in_millis
(整数) 该存储库中运行时间最长的快照的开始时间,以自 Unix 纪元以来的毫秒数表示。

示例编辑

response = client.cluster.stats(
  human: true,
  pretty: true
)
puts response
GET /_cluster/stats?human&pretty

API 返回以下响应

{
   "_nodes" : {
      "total" : 1,
      "successful" : 1,
      "failed" : 0
   },
   "cluster_uuid": "YjAvIhsCQ9CbjWZb2qJw3Q",
   "cluster_name": "elasticsearch",
   "timestamp": 1459427693515,
   "status": "green",
   "indices": {
      "count": 1,
      "shards": {
         "total": 5,
         "primaries": 5,
         "replication": 0,
         "index": {
            "shards": {
               "min": 5,
               "max": 5,
               "avg": 5
            },
            "primaries": {
               "min": 5,
               "max": 5,
               "avg": 5
            },
            "replication": {
               "min": 0,
               "max": 0,
               "avg": 0
            }
         }
      },
      "docs": {
         "count": 10,
         "deleted": 0,
         "total_size_in_bytes": 8833
      },
      "store": {
         "size": "16.2kb",
         "size_in_bytes": 16684,
         "total_data_set_size": "16.2kb",
         "total_data_set_size_in_bytes": 16684,
         "reserved": "0b",
         "reserved_in_bytes": 0
      },
      "search": {
          ...
      },
      "fielddata": {
         "memory_size": "0b",
         "memory_size_in_bytes": 0,
         "evictions": 0,
         "global_ordinals": {
            "build_time" : "0s",
            "build_time_in_millis" : 0
         }
      },
      "query_cache": {
         "memory_size": "0b",
         "memory_size_in_bytes": 0,
         "total_count": 0,
         "hit_count": 0,
         "miss_count": 0,
         "cache_size": 0,
         "cache_count": 0,
         "evictions": 0
      },
      "completion": {
         "size": "0b",
         "size_in_bytes": 0
      },
      "segments": {
         "count": 4,
         "memory": "8.6kb",
         "memory_in_bytes": 0,
         "terms_memory": "0b",
         "terms_memory_in_bytes": 0,
         "stored_fields_memory": "0b",
         "stored_fields_memory_in_bytes": 0,
         "term_vectors_memory": "0b",
         "term_vectors_memory_in_bytes": 0,
         "norms_memory": "0b",
         "norms_memory_in_bytes": 0,
         "points_memory" : "0b",
         "points_memory_in_bytes" : 0,
         "doc_values_memory": "0b",
         "doc_values_memory_in_bytes": 0,
         "index_writer_memory": "0b",
         "index_writer_memory_in_bytes": 0,
         "version_map_memory": "0b",
         "version_map_memory_in_bytes": 0,
         "fixed_bit_set": "0b",
         "fixed_bit_set_memory_in_bytes": 0,
         "max_unsafe_auto_id_timestamp" : -9223372036854775808,
         "file_sizes": {}
      },
      "mappings": {
        "total_field_count": 0,
        "total_deduplicated_field_count": 0,
        "total_deduplicated_mapping_size": "0b",
        "total_deduplicated_mapping_size_in_bytes": 0,
        "field_types": [],
        "runtime_field_types": []
      },
      "analysis": {
        "char_filter_types": [],
        "tokenizer_types": [],
        "filter_types": [],
        "analyzer_types": [],
        "built_in_char_filters": [],
        "built_in_tokenizers": [],
        "built_in_filters": [],
        "built_in_analyzers": [],
        "synonyms": {}
      },
      "versions": [
        {
          "version": "8.0.0",
          "index_count": 1,
          "primary_shard_count": 1,
          "total_primary_size": "7.4kb",
          "total_primary_bytes": 7632
        }
      ],
      "dense_vector": {
          "value_count": 0
      }
   },
   "nodes": {
      "count": {
         "total": 1,
         "data": 1,
         "coordinating_only": 0,
         "master": 1,
         "ingest": 1,
         "voting_only": 0
      },
      "versions": [
         "8.14.2"
      ],
      "os": {
         "available_processors": 8,
         "allocated_processors": 8,
         "names": [
            {
               "name": "Mac OS X",
               "count": 1
            }
         ],
         "pretty_names": [
            {
               "pretty_name": "Mac OS X",
               "count": 1
            }
         ],
         "architectures": [
            {
               "arch": "x86_64",
               "count": 1
            }
         ],
         "mem" : {
            "total" : "16gb",
            "total_in_bytes" : 17179869184,
            "adjusted_total" : "16gb",
            "adjusted_total_in_bytes" : 17179869184,
            "free" : "78.1mb",
            "free_in_bytes" : 81960960,
            "used" : "15.9gb",
            "used_in_bytes" : 17097908224,
            "free_percent" : 0,
            "used_percent" : 100
         }
      },
      "process": {
         "cpu": {
            "percent": 9
         },
         "open_file_descriptors": {
            "min": 268,
            "max": 268,
            "avg": 268
         }
      },
      "jvm": {
         "max_uptime": "13.7s",
         "max_uptime_in_millis": 13737,
         "versions": [
            {
               "version": "12",
               "vm_name": "OpenJDK 64-Bit Server VM",
               "vm_version": "12+33",
               "vm_vendor": "Oracle Corporation",
               "bundled_jdk": true,
               "using_bundled_jdk": true,
               "count": 1
            }
         ],
         "mem": {
            "heap_used": "57.5mb",
            "heap_used_in_bytes": 60312664,
            "heap_max": "989.8mb",
            "heap_max_in_bytes": 1037959168
         },
         "threads": 90
      },
      "fs": {
         "total": "200.6gb",
         "total_in_bytes": 215429193728,
         "free": "32.6gb",
         "free_in_bytes": 35064553472,
         "available": "32.4gb",
         "available_in_bytes": 34802409472
      },
      "plugins": [
        {
          "name": "analysis-icu",
          "version": "8.14.2",
          "description": "The ICU Analysis plugin integrates Lucene ICU module into elasticsearch, adding ICU relates analysis components.",
          "classname": "org.elasticsearch.plugin.analysis.icu.AnalysisICUPlugin",
          "has_native_controller": false
        },
        ...
      ],
      "ingest": {
        "number_of_pipelines" : 1,
        "processor_stats": {
          ...
        }
      },
      "indexing_pressure": {
        "memory": {
            "current": {
                 "combined_coordinating_and_primary": "0b",
                 "combined_coordinating_and_primary_in_bytes": 0,
                 "coordinating": "0b",
                 "coordinating_in_bytes": 0,
                 "primary": "0b",
                 "primary_in_bytes": 0,
                 "replica": "0b",
                 "replica_in_bytes": 0,
                 "all": "0b",
                 "all_in_bytes": 0
            },
            "total": {
                "combined_coordinating_and_primary": "0b",
                "combined_coordinating_and_primary_in_bytes": 0,
                "coordinating": "0b",
                "coordinating_in_bytes": 0,
                "primary": "0b",
                "primary_in_bytes": 0,
                "replica": "0b",
                "replica_in_bytes": 0,
                "all": "0b",
                "all_in_bytes": 0,
                "coordinating_rejections": 0,
                "primary_rejections": 0,
                "replica_rejections": 0,
                "primary_document_rejections": 0
            },
            "limit" : "0b",
            "limit_in_bytes": 0
        }
      },
      "network_types": {
        ...
      },
      "discovery_types": {
        ...
      },
      "packaging_types": [
        {
          ...
        }
      ]
   },
   "snapshots": {
     ...
   }
}

此 API 可以使用 节点过滤器 限制为节点的子集

response = client.cluster.stats(
  node_id: 'node1,node*,master:false'
)
puts response
GET /_cluster/stats/nodes/node1,node*,master:false