平均バケット（Average bucket）

平均バケット集計

兄弟パイプライン集計で、兄弟集計内の指定されたメトリックの平均値を計算します。指定されたメトリックは数値でなければならず、兄弟集計はマルチバケット集計でなければなりません。

構文

Js

"avg_bucket": {
  "buckets_path": "sales_per_month>sales",
  "gap_policy": "skip",
  "format": "#,##0.00;(#,##0.00)"
}

パラメータ

• buckets_path
• (必須、文字列) 平均を取るバケットへのパス。構文については、buckets_path 構文を参照してください。
• gap_policy
• (オプション、文字列) データにギャップが見つかった場合に適用するポリシー。有効な値については、データのギャップの処理を参照してください。デフォルトは skip です。
• format
• (オプション、文字列) 出力値のためのDecimalFormatパターン。指定された場合、フォーマットされた値は集計の value_as_string プロパティに返されます。

レスポンスボディ

• value
• (float) buckets_path で指定されたメトリックの平均値。
• value_as_string
• (string) 集計のフォーマットされた出力値。このプロパティは、リクエストで format が指定された場合にのみ提供されます。

例

次の avg_monthly_sales 集計は、avg_bucket を使用して月ごとの平均売上を計算します:

Python

resp = client.search(
   size=0,
   aggs={
   "sales_per_month": {
   "date_histogram": {
   "field": "date",
   "calendar_interval": "month"
   },
   "aggs": {
   "sales": {
   "sum": {
   "field": "price"
   }
   }
   }
   },
   "avg_monthly_sales": {
   "avg_bucket": {
   "buckets_path": "sales_per_month>sales",
   "gap_policy": "skip",
   "format": "#,##0.00;(#,##0.00)"
   }
   }
   },
)
print(resp)

Js

const response = await client.search({
  size: 0,
  aggs: {
   sales_per_month: {
   date_histogram: {
   field: "date",
   calendar_interval: "month",
   },
   aggs: {
   sales: {
   sum: {
   field: "price",
   },
   },
   },
   },
   avg_monthly_sales: {
   avg_bucket: {
   buckets_path: "sales_per_month>sales",
   gap_policy: "skip",
   format: "#,##0.00;(#,##0.00)",
   },
   },
  },
});
console.log(response);

コンソール

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[]
   "avg_bucket": {
   "buckets_path": "sales_per_month>sales",
   "gap_policy": "skip",
   "format": "#,##0.00;(#,##0.00)"
   }
// end::avg-bucket-agg-syntax[]
   }
  }
}

リクエストは次のレスポンスを返します:

コンソール-結果

{
  "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"
   }
  }
}