📖 概念与教程请阅读 指标聚合教程
指标聚合 - API 参考 #
本节详细列出所有指标聚合的参数与用法。
相关资源 #
指标聚合类型 #
指标聚合分为单值聚合（返回单个数值）和多值聚合（返回多个数值）两类。
单值指标聚合 #
返回单个数值的指标，适合基础统计：
| 聚合 | 说明 | 常见用途 |
|---|---|---|
| avg | 计算平均值 | 平均延迟、平均收入 |
| sum | 计算总和 | 总销售额、总请求数 |
| min | 计算最小值 | 最小延迟、最低价格 |
| max | 计算最大值 | 最大延迟、最高价格 |
| cardinality | 去重计数（近似值） | 独立用户数、不同IP数 |
| value_count | 计算字段值数量 | 有值的文档数 |
| median_absolute_deviation | 中位数绝对偏差 | 分布离散度分析 |
| weighted_avg | 加权平均值 | 加权平均评分、加权成本 |
| rate | 速率计算（单位时间内的值） | 每日请求速率、年化收入 |
多值指标聚合 #
返回多个数值的指标，一次获取多种统计：
| 聚合 | 说明 | 常见用途 |
|---|---|---|
| stats | 返回 count、min、max、avg、sum | 一次获取基本统计信息 |
| extended_stats | stats + 方差、标准差、四分位等 | 详细的分布统计 |
| percentiles | 百分位数（P50、P95、P99 等） | 性能分析、SLA监控 |
| percentile_ranks | 值所在的百分位 | 给定值的排名分析 |
| top_hits | 返回桶内 Top N 文档 | 查看每组的示例记录 |
| scripted_metric | 使用脚本自定义指标计算 | 复杂的自定义统计 |
地理位置指标 #
用于地理数据的统计：
| 聚合 | 说明 | 常见用途 |
|---|---|---|
| geo_bounds | 地理点的边界框 | 地图缩放范围 |
| geo_centroid | 地理点的中心点 | 地图中心位置 |
矩阵指标 #
跨多个字段的联合统计：
| 聚合 | 说明 | 常见用途 |
|---|---|---|
| matrix_stats | 多字段的相关性矩阵统计 | 字段间相关性分析、多变量统计 |