mirror of
https://github.com/elastic/elasticsearch.git
synced 2025-04-25 23:57:20 -04:00
139 lines
3.2 KiB
Text
139 lines
3.2 KiB
Text
[[search-aggregations-pipeline-avg-bucket-aggregation]]
|
|
=== Average bucket aggregation
|
|
++++
|
|
<titleabbrev>Average bucket</titleabbrev>
|
|
++++
|
|
|
|
A sibling pipeline aggregation which calculates the mean value of a specified
|
|
metric in a sibling aggregation. The specified metric must be numeric and the
|
|
sibling aggregation must be a multi-bucket aggregation.
|
|
|
|
[[avg-bucket-agg-syntax]]
|
|
==== Syntax
|
|
|
|
[source,js,indent=0]
|
|
----
|
|
include::avg-bucket-aggregation.asciidoc[tag=avg-bucket-agg-syntax]
|
|
----
|
|
// NOTCONSOLE
|
|
|
|
[[avg-bucket-params]]
|
|
==== Parameters
|
|
|
|
`buckets_path`::
|
|
(Required, string)
|
|
Path to the buckets to average. For syntax, see <<buckets-path-syntax>>.
|
|
|
|
`gap_policy`::
|
|
(Optional, string)
|
|
Policy to apply when gaps are found in the data. For valid values, see
|
|
<<gap-policy>>. Defaults to `skip`.
|
|
|
|
`format`::
|
|
(Optional, string)
|
|
{javadoc}/java.base/java/text/DecimalFormat.html[DecimalFormat pattern] for the
|
|
output value. If specified, the formatted value is returned in the aggregation's
|
|
`value_as_string` property.
|
|
|
|
[[avg-bucket-agg-response]]
|
|
==== Response body
|
|
|
|
`value`::
|
|
(float)
|
|
Mean average value for the metric specified in `buckets_path`.
|
|
|
|
`value_as_string`::
|
|
(string)
|
|
Formatted output value for the aggregation. This property is only provided if
|
|
a `format` is specified in the request.
|
|
|
|
[[avg-bucket-agg-ex]]
|
|
==== Example
|
|
|
|
The following `avg_monthly_sales` aggregation uses `avg_bucket` to calculate
|
|
average sales per month:
|
|
|
|
[source,console,subs="specialchars+"]
|
|
----
|
|
POST _search
|
|
{
|
|
"size": 0,
|
|
"aggs": {
|
|
"sales_per_month": {
|
|
"date_histogram": {
|
|
"field": "date",
|
|
"calendar_interval": "month"
|
|
},
|
|
"aggs": {
|
|
"sales": {
|
|
"sum": {
|
|
"field": "price"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"avg_monthly_sales": {
|
|
// tag::avg-bucket-agg-syntax[] <1>
|
|
"avg_bucket": {
|
|
"buckets_path": "sales_per_month>sales",
|
|
"gap_policy": "skip",
|
|
"format": "#,##0.00;(#,##0.00)"
|
|
}
|
|
// end::avg-bucket-agg-syntax[] <2>
|
|
}
|
|
}
|
|
}
|
|
----
|
|
// TEST[setup:sales]
|
|
|
|
<1> Start of the `avg_bucket` configuration. Comment is not part of the example.
|
|
<2> End of the `avg_bucket` configuration. Comment is not part of the example.
|
|
|
|
The request returns the following response:
|
|
|
|
[source,console-result]
|
|
----
|
|
{
|
|
"took": 11,
|
|
"timed_out": false,
|
|
"_shards": ...,
|
|
"hits": ...,
|
|
"aggregations": {
|
|
"sales_per_month": {
|
|
"buckets": [
|
|
{
|
|
"key_as_string": "2015/01/01 00:00:00",
|
|
"key": 1420070400000,
|
|
"doc_count": 3,
|
|
"sales": {
|
|
"value": 550.0
|
|
}
|
|
},
|
|
{
|
|
"key_as_string": "2015/02/01 00:00:00",
|
|
"key": 1422748800000,
|
|
"doc_count": 2,
|
|
"sales": {
|
|
"value": 60.0
|
|
}
|
|
},
|
|
{
|
|
"key_as_string": "2015/03/01 00:00:00",
|
|
"key": 1425168000000,
|
|
"doc_count": 2,
|
|
"sales": {
|
|
"value": 375.0
|
|
}
|
|
}
|
|
]
|
|
},
|
|
"avg_monthly_sales": {
|
|
"value": 328.33333333333333,
|
|
"value_as_string": "328.33"
|
|
}
|
|
}
|
|
}
|
|
----
|
|
// TESTRESPONSE[s/"took": 11/"took": $body.took/]
|
|
// TESTRESPONSE[s/"_shards": \.\.\./"_shards": $body._shards/]
|
|
// TESTRESPONSE[s/"hits": \.\.\./"hits": $body.hits/]
|