数据流统计 API
检索一个或多个数据流的统计数据。
GET /_data_stream/my-data-stream/_stats
前置条件
- 如果 Elasticsearch 安全特性启用，你必须有
monitor或manage的索引权限。
请求
GET /_data_stream/<data-stream>/_stats
路径参数
<data-stream>(可选，字符串） 用于限制请求的数据流的逗号分隔列表。支持通配符表达式 (
*)。要以集群中的所有数据流为目标，请省略此参数或使用
*。
查询参数
expand_wildcards（可选，字符串）通配符模式可以匹配的数据流类型。支持逗号分隔值，例如
open,hidden。有效值为：all，hidden匹配任何数据流或索引，包括隐藏的。
open，closed匹配任何非隐藏的数据流。无法关闭 Data Streams。
none不接受通配符模式。默认为
open。
human(可选，布尔值） 如果为
true，则响应会包含以人类可读字节值表示的统计数据。默认为false。
响应体
_shards(对象）包含试图执行请求的分片的信息。
_shards属性total(整数）尝试执行请求的分片总数。
successful(整数）成功执行请求的分片数。
failed(整数）未能执行请求的分片数量。
data_stream_count(整数）所选数据流的总数。
backing_indices(整数）所选数据流的备份索引总数。
total_store_size(字节值）所选数据流的所有分块的总大小。只有当
human查询参数为true时，才会包含此属性。total_store_size_bytes(整数）所选数据流所有分块的总大小（字节）。
data_streams(对象数组） 包含所选数据流的统计数据。
data_streams对象属性data_stream(字符串） 数据流的名称。
backing_indices(整数）数据流的当前后备索引数。
store_size(字节值）数据流后备索引所有分片的总大小。只有当
human查询参数为true时，才会返回该参数。store_size_bytes(整数）数据流后备索引所有分片的总大小（以字节为单位）。
maximum_timestamp(整数) 数据流的最高
@timestamp值，转换为 Unix epoch以来的毫秒数。提示如果满足以下一个或多个条件，数据流中的
@timestamp值可能高于此值：- 数据流包含已关闭的后备索引。
- 生成时间较短的备份索引包含较高的
@timestamp值。
示例
GET /_data_stream/my-data-stream*/_stats?human=true
API 返回以下响应。
{
"_shards": {
"total": 10,
"successful": 5,
"failed": 0
},
"data_stream_count": 2,
"backing_indices": 5,
"total_store_size": "7kb",
"total_store_size_bytes": 7268,
"data_streams": [
{
"data_stream": "my-data-stream",
"backing_indices": 3,
"store_size": "3.7kb",
"store_size_bytes": 3772,
"maximum_timestamp": 1607512028000
},
{
"data_stream": "my-data-stream-two",
"backing_indices": 2,
"store_size": "3.4kb",
"store_size_bytes": 3496,
"maximum_timestamp": 1607425567000
}
]
}