PercentilesAggregation

在多元索引统计聚合中表示百分位统计,百分位统计常用来统计一组数据的百分位分布情况,例如在日常系统运维中统计每次请求访问的耗时情况时,需要关注系统请求耗时的P25、P50、P90、P99值等分布情况。

请求数据结构

message PercentilesAggregation {
    optional string field_name = 1;
    repeated double percentiles = 2;
    optional bytes missing = 3;
}

名称

类型

是否必选

描述

field_name

string

用于统计聚合的字段。

percentiles

double

百分位分布例如50、90、99,可根据需要设置一个或者多个百分位。多个百分位之间用半角逗号(,)分隔,例如25.0,50.0,99.0

单个百分位的取值范围为1~100的数字。

missing

bytes

当某行数据中的字段为空时字段值的默认值,由Plainbuffer编码,详见Plainbuffer编码。

  • 如果未设置missing值,则在统计聚合时会忽略该行。

  • 如果设置了missing值,则使用missing值作为字段值的默认值参与统计聚合。

响应数据消息

message PercentilesAggregationResult {
    repeated PercentilesAggregationItem percentiles_aggregation_items = 1;
}

名称

类型

是否必选

描述

percentiles_aggregation_items

repeated PercentilesAggregationItem

百分位统计中百分位分布信息。