diff --git a/docs/Aggregation/Histogram.md b/docs/Aggregation/Histogram.md new file mode 100644 index 0000000000000000000000000000000000000000..be18516a4f0ae96ca0245180c2989d9fc79d8104 --- /dev/null +++ b/docs/Aggregation/Histogram.md @@ -0,0 +1,34 @@ +# Histogram Aggregation + +> More info about histogram aggregation is in the [official elasticsearch docs][1] + +A multi-bucket values source based aggregation that can be applied on numeric values extracted from +the documents. It dynamically builds fixed size (a.k.a. interval) buckets over the values. + +## Simple example + +```JSON +{ + "aggregations": { + "agg_prices": { + "histogram": { + "field": "price", + "interval": 50 + } + } + } +} +``` + +And now the query via DSL: + +```php +$histogramAggregation = new HistogramAggregation('prices', 'price', 50); + +$search = new Search(); +$search->addAggregation($histogramAggregation); + +$queryArray = $search->toArray(); +``` + +[1]: https://www.elastic.co/guide/en/elasticsearch/reference/current/search-aggregations-bucket-histogram-aggregation.html