# Metric 聚合

URL: https://caijiao.org/elasticsearch/03.advanced/08.agg-metric
Source: docs/elasticsearch/03.advanced/08.agg-metric.md
Description: 本章介绍 Elasticsearch 中常用的 Metric 聚合类型及使用方法，帮助实现数据的统计、求和、平均等分析功能。

Metric 聚合用于对数值字段进行统计和计算，是数据分析和报表展示的重要手段。Elasticsearch 提供多种常用的度量聚合，满足不同的统计需求。

## 1. 常见 Metric 聚合类型

- **avg**：计算字段的平均值  
- **sum**：计算字段的总和  
- **min**：求字段的最小值  
- **max**：求字段的最大值  
- **stats**：综合统计，包含 count、min、max、avg、sum  
- **extended_stats**：扩展统计，包含标准差、方差等

## 2. 示例：计算平均值

```json
GET /my-index/_search
{
  "size": 0,
  "aggs": {
    "average_price": {
      "avg": {
        "field": "price"
      }
    }
  }
}
````

## 3. 示例：获取统计信息

```json
GET /my-index/_search
{
  "size": 0,
  "aggs": {
    "price_stats": {
      "stats": {
        "field": "price"
      }
    }
  }
}
```

返回结果包含文档数、最小值、最大值、平均值和总和。

## 4. 注意事项

* 聚合操作不返回文档，只返回计算结果
* 使用 `size: 0` 可避免返回大量文档，节省资源
* 聚合字段应为数值类型或支持数值计算的字段

---

Metric 聚合帮助你快速实现数值统计与分析，支持业务决策和数据洞察。