Avg Aggregation

单值度量标准聚合，用于计算从聚合文档中提取的数值的平均值。可以从文档中的特定数字字段提取这些值，也可以通过提供的脚本生成这些值。

假设数据由代表考试成绩（0到100）的学生组成，我们可以将他们的分数平均为：

POST /exams/_search?size=0
{
    "aggs" : {
        "avg_grade" : { "avg" : { "field" : "grade" } }
    }
}

上述聚合计算所有文档的平均成绩。聚合类型是avg，字段设置定义将计算平均值的文档的数字字段。以上将返回以下内容：

{
    ...
    "aggregations": {
        "avg_grade": {
            "value": 75.0
        }
    }
}

Script

根据脚本计算平均成绩：

POST /exams/_search?size=0
{
    "aggs" : {
        "avg_grade" : {
            "avg" : {
                "script" : {
                    "source" : "doc.grade.value"
                }
            }
        }
    }
}

这将使用 painless 脚本语言并且没有脚本参数将脚本参数解释为内联脚本。要使用存储的脚本，请使用以下语法：

POST /exams/_search?size=0
{
    "aggs" : {
        "avg_grade" : {
            "avg" : {
                "script" : {
                    "id": "my_script",
                    "params": {
                        "field": "grade"
                    }
                }
            }
        }
    }
}

Value Script

事实证明，考试高于学生的水平，需要进行等级校正。我们可以使用值脚本来获得新的平均值：

POST /exams/_search?size=0
{
    "aggs" : {
        "avg_corrected_grade" : {
            "avg" : {
                "field" : "grade",
                "script" : {
                    "lang": "painless",
                    "source": "_value * params.correction",
                    "params" : {
                        "correction" : 1.2
                    }
                }
            }
        }
    }
}

Missing value

缺少的参数定义了应该如何处理缺少值的文档。默认情况下，它们将被忽略，但也可以将它们视为具有值。

POST /exams/_search?size=0
{
    "aggs" : {
        "grade_avg" : {
            "avg" : {
                "field" : "grade",
                "missing": 10     @1
            }
        }
    }
}

@1: 在成绩字段中没有值的文档将与具有值10的文档属于同一个存储桶。