获取集群中节点的统计信息，包括操作系统、JVM、索引、网络等方面的性能指标和资源使用情况。
API #
GET /_cluster/nodes/stats
GET /_nodes/stats
GET /_nodes/{nodeId}/stats
GET /_nodes/stats/{metric}
GET /_nodes/{nodeId}/stats/{metric}
GET /_nodes/stats/{metric}/{index_metric}
GET /_nodes/{nodeId}/stats/{metric}/{index_metric}
API 的作用 #
该 API 用于获取集群中节点的统计信息，可以返回关于集群中各个节点的各种性能指标、资源使用情况和系统状态，包括操作系统、JVM、索引、网络等方面的统计数据。
可用的统计指标（metric） #
| 指标值 | 描述 |
|---|---|
_all | 所有指标 |
breaker | 断路器统计 |
fs | 文件系统统计 |
http | HTTP 统计 |
indices | 索引统计 |
jvm | JVM 统计 |
os | 操作系统统计 |
process | 进程统计 |
thread_pool | 线程池统计 |
transport | 传输统计 |
discovery | 发现统计 |
indexing_pressure | 索引压力统计 |
索引级别的指标（index_metric） #
当 metric 为 indices 时，可以进一步指定以下指标：
| 指标值 | 描述 |
|---|---|
_all | 所有索引指标 |
completion | 完成度统计 |
docs | 文档统计 |
fielddata | 字段数据统计 |
query_cache | 查询缓存统计 |
flush | 刷新统计 |
get | 获取操作统计 |
indexing | 索引操作统计 |
merge | 合并统计 |
request_cache | 请求缓存统计 |
refresh | 刷新统计 |
search | 搜索统计 |
segments | 段统计 |
store | 存储统计 |
warmer | 预热统计 |
suggest | 建议统计 |
API 的参数 #
路由参数 #
| 参数 | 类型 | 是否必填 | 默认值 | 描述 |
|---|---|---|---|---|
{nodeId} | 字符串 | 否 | 所有节点 | 节点 ID 或名称列表（逗号分隔）。特殊值：_local 表示当前连接的节点 |
{metric} | 字符串 | 否 | _all | 指标类型名称 |
{index_metric} | 字符串 | 否 | - | 索引级别的具体指标（仅当 metric 为 indices 时有效） |
Query String 参数 #
| 参数 | 类型 | 是否必填 | 默认值 | 描述 |
|---|---|---|---|---|
nodeId | 字符串 | 否 | 所有节点 | 指定要获取统计信息的节点（逗号分隔）。特殊值：_local 表示当前连接的节点 |
metric | 字符串 | 否 | _all | 指定要获取的指标类型（逗号分隔） |
index_metric | 字符串 | 否 | _all | 指定索引级别的具体指标（逗号分隔）。仅当 metric 包含 indices 时有效 |
level | 枚举值 | 否 | node | 指定索引统计的聚合级别。可选值：indices（按索引聚合）、node（按节点聚合）、shards（按分片聚合） |
timeout | 时间值 | 否 | 默认超时 | 操作超时时间 |
include_segment_file_sizes | 布尔值 | 否 | false | 是否报告每个 Lucene 索引文件的聚合磁盘使用量（仅当请求段统计时适用） |
fields | 字符串 | 否 | - | 指定 fielddata 和 completion 索引指标的字段（支持通配符，逗号分隔） |
fielddata_fields | 字符串 | 否 | - | 指定 fielddata 索引指标的字段（支持通配符，逗号分隔） |
completion_fields | 字符串 | 否 | - | 指定 completion 索引指标的字段（支持通配符，逗号分隔） |
groups | 字符串 | 否 | - | 指定搜索索引指标的搜索组（逗号分隔） |
types | 字符串 | 否 | - | 指定索引索引指标的文档类型（逗号分隔） |
示例 #
获取所有节点的所有统计信息 #
GET /_cluster/nodes/stats
或
GET /_nodes/stats
获取指定节点的统计信息 #
GET /_nodes/node1/stats
获取所有节点的 JVM 统计 #
GET /_nodes/stats/jvm
获取指定节点的索引统计 #
GET /_nodes/node1/stats/indices
获取索引的文档统计 #
GET /_nodes/stats/indices/docs
获取索引的搜索统计（按分片级别） #
GET /_nodes/stats/indices/search?level=shards
获取本地节点的信息 #
GET /_nodes/_local/stats
获取多个节点的多个指标 #
GET /_nodes/node1,node2/stats/jvm,os,process
响应示例：
{
"cluster_name": "easysearch-cluster",
"nodes": {
"node1_id": {
"name": "node-1",
"host": "192.168.1.1",
"ip": "192.168.1.1",
"jvm": {
"mem": {
"heap_used_in_bytes": 536870912,
"heap_max_in_bytes": 1073741824,
"heap_used_percent": 50
},
"gc": {
"collectors": {
"young": {
"collection_count": 100,
"collection_time_in_millis": 500
}
}
}
},
"os": {
"cpu_percent": 25,
"load_average": [1.5, 1.2, 1.0]
},
"indices": {
"docs": {
"count": 10000,
"deleted": 100
},
"store": {
"size_in_bytes": 1073741824
},
"search": {
"open_contexts": 5,
"query_total": 1000,
"query_time_in_millis": 5000
}
}
}
}
}
