mirror of
https://github.com/iSharkFly-Docs/opensearch-docs-cn
synced 2025-03-09 14:38:01 +00:00
02f40d7efd
* Refactor metric aggregation section Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> * Update _query-dsl/aggregations/metric/matrix-stats.md Co-authored-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> Signed-off-by: kolchfa-aws <105444904+kolchfa-aws@users.noreply.github.com> * Update _query-dsl/aggregations/metric/extended-stats.md Co-authored-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com> Signed-off-by: kolchfa-aws <105444904+kolchfa-aws@users.noreply.github.com> --------- Signed-off-by: Fanit Kolchina <kolchfa@amazon.com> Signed-off-by: kolchfa-aws <105444904+kolchfa-aws@users.noreply.github.com> Co-authored-by: Naarcha-AWS <97990722+Naarcha-AWS@users.noreply.github.com>
60 lines
1.3 KiB
Markdown
60 lines
1.3 KiB
Markdown
---
|
|
layout: default
|
|
title: Date histogram
|
|
parent: Bucket aggregations
|
|
grand_parent: Aggregations
|
|
nav_order: 20
|
|
---
|
|
|
|
# Date histogram aggregations
|
|
|
|
The `date_histogram` aggregation uses [date math]({{site.url}}{{site.baseurl}}/opensearch/supported-field-types/date/#date-math) to generate histograms for time-series data.
|
|
|
|
For example, you can find how many hits your website gets per month:
|
|
|
|
```json
|
|
GET opensearch_dashboards_sample_data_logs/_search
|
|
{
|
|
"size": 0,
|
|
"aggs": {
|
|
"logs_per_month": {
|
|
"date_histogram": {
|
|
"field": "@timestamp",
|
|
"interval": "month"
|
|
}
|
|
}
|
|
}
|
|
}
|
|
```
|
|
{% include copy-curl.html %}
|
|
|
|
#### Example response
|
|
|
|
```json
|
|
...
|
|
"aggregations" : {
|
|
"logs_per_month" : {
|
|
"buckets" : [
|
|
{
|
|
"key_as_string" : "2020-10-01T00:00:00.000Z",
|
|
"key" : 1601510400000,
|
|
"doc_count" : 1635
|
|
},
|
|
{
|
|
"key_as_string" : "2020-11-01T00:00:00.000Z",
|
|
"key" : 1604188800000,
|
|
"doc_count" : 6844
|
|
},
|
|
{
|
|
"key_as_string" : "2020-12-01T00:00:00.000Z",
|
|
"key" : 1606780800000,
|
|
"doc_count" : 5595
|
|
}
|
|
]
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
The response has three months worth of logs. If you graph these values, you can see the peak and valleys of the request traffic to your website month over month.
|