Minimum bucket 집계

min_bucket 집계는 이전 집계의 각 버킷에서 특정 지표(metric)의 최솟값을 계산하는 형제(sibling) 집계예요. 숫자 지표와 함께 쓰이며, 형제 집계는 반드시 다중 버킷(multi-bucket) 집계여야 해요.

출처: 문서

본문

min_bucket 집계는 이전 집계의 각 버킷에서 어떤 지표의 최솟값을 계산하는 형제(sibling) 집계입니다. 지정한 지표는 숫자여야 하며, 형제로 사용하는 집계는 다중 버킷(multi-bucket) 집계여야 합니다.

파라미터

min_bucket 집계는 다음 파라미터를 받습니다.

파라미터	필수/선택	데이터 타입	설명
`buckets_path`	필수	String	집계할 버킷들의 경로입니다. Buckets path를 참고하세요.
`gap_policy`	선택	String	누락된 데이터에 적용할 정책입니다. 유효한 값은 `skip`과 `insert_zeros`이며 기본값은 `skip`입니다. Data gaps를 참고하세요.
`format`	선택	String	`DecimalFormat` 서식 문자열입니다. 집계의 `value_as_string` 속성에 서식이 적용된 출력을 반환합니다.

예제

다음 예제는 OpenSearch Dashboards e-commerce 샘플 데이터에서 한 달 간격의 날짜 히스토그램을 만듭니다. sum 서브 집계가 매달 bytes의 합계를 계산하고, 마지막으로 min_bucket 집계가 이 버킷들 중 가장 작은 값을 찾습니다.

POST opensearch_dashboards_sample_data_logs/_search
{
  "size": 0,
  "aggs": {
    "visits_per_month": {
      "date_histogram": {
        "field": "@timestamp",
        "interval": "month"
      },
      "aggs": {
        "sum_of_bytes": {
          "sum": {
            "field": "bytes"
          }
        }
      }
    },
    "min_monthly_bytes": {
      "min_bucket": {
        "buckets_path": "visits_per_month>sum_of_bytes"
      }
    }
  }
}

예제 응답

max_bucket 집계는 여러 버킷에 걸쳐 지정된 지표의 최솟값을 반환합니다. 이 예제에서는 visits_per_month 안의 sum_of_bytes 지표에서 월별 최소 바이트 수를 계산합니다. value 필드는 모든 버킷에서 찾은 최솟값을 보여 주고, keys 배열은 이 최솟값이 관찰된 버킷들의 키를 담고 있습니다. 같은 최솟값을 가진 버킷이 둘 이상일 수 있으므로 배열로 반환되며, 그런 경우 일치하는 모든 버킷 키가 포함됩니다. 이렇게 하면 여러 기간(또는 용어)이 같은 최솟값을 가지더라도 결과가 정확하게 유지됩니다.

{
  "took": 7,
  "timed_out": false,
  "_shards": {
    "total": 1,
    "successful": 1,
    "skipped": 0,
    "failed": 0
  },
  "hits": {
    "total": {
      "value": 10000,
      "relation": "gte"
    },
    "max_score": null,
    "hits": []
  },
  "aggregations": {
    "visits_per_month": {
      "buckets": [
        {
          "key_as_string": "2025-03-01T00:00:00.000Z",
          "key": 1740787200000,
          "doc_count": 480,
          "sum_of_bytes": {
            "value": 2804103
          }
        },
        {
          "key_as_string": "2025-04-01T00:00:00.000Z",
          "key": 1743465600000,
          "doc_count": 6849,
          "sum_of_bytes": {
            "value": 39103067
          }
        },
        {
          "key_as_string": "2025-05-01T00:00:00.000Z",
          "key": 1746057600000,
          "doc_count": 6745,
          "sum_of_bytes": {
            "value": 37818519
          }
        }
      ]
    },
    "min_monthly_bytes": {
      "value": 2804103,
      "keys": [
        "2025-03-01T00:00:00.000Z"
      ]
    }
  }
}

더 알아보기 (Learn more)

OpenSearch 공식 문서