미분 집계

미분 집계 (Derivative aggregation)

derivative 집계는 집계의 각 버킷에 대한 1차 및 2차 도함수를 계산하는 데 사용되는 부모(parent) 집계예요. "First-order derivative"(1차 도함수)와 "Second-order derivative"(2차 도함수)는 각각 "first derivative"와 "second derivative"로 축약되는 경우가 많아요. 이 페이지에서는 축약된 용어를 사용해요.

정렬된 버킷 수열의 경우, derivative는 현재 버킷과 이전 버킷의 메트릭 값 사이의 차이로 1차 도함수를 근사해요.

출처: 문서

본문

파라미터

derivative 집계는 다음과 같은 파라미터를 받아요.

예제: 1차 도함수 (First derivative)

다음 예제는 OpenSearch Dashboards e-커머스 샘플 데이터에서 한 달 간격의 날짜 히스토그램을 생성해요. sum 하위 집계가 매월 모든 바이트의 합계를 계산해요. 마지막으로 derivative 집계가 sum 하위 집계의 1차 도함수를 계산해요. 1차 도함수는 현재 달과 이전 달의 바이트 수 사이의 차이로 추정돼요:

GET opensearch_dashboards_sample_data_logs/_search
{
  "size": 0,
  "aggs": {
    "sales_per_month": {
      "date_histogram": {
        "field": "@timestamp",
        "calendar_interval": "month"
      },
      "aggs": {
        "number_of_bytes": {
          "sum": {
            "field": "bytes"
          }
        },
        "bytes_deriv": {
          "derivative": {
            "buckets_path": "number_of_bytes"
          }
        }
      }
    }
  }
}

예제 응답: 1차 도함수

응답은 두 번째와 세 번째 버킷에 대해 계산된 도함수를 보여줘요:

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

첫 번째 버킷에는 이전 버킷이 없으므로 도함수가 계산되지 않아요.

예제: 2차 도함수 (Second derivative)

2차 도함수를 계산하려면 한 derivative 집계를 다른 집계에 연결해요:

GET opensearch_dashboards_sample_data_logs/_search
{
  "size": 0,
  "aggs": {
    "sales_per_month": {
      "date_histogram": {
        "field": "@timestamp",
        "calendar_interval": "month"
      },
      "aggs": {
        "number_of_bytes": {
          "sum": {
            "field": "bytes"
          }
        },
        "bytes_1st_deriv": {
          "derivative": {
            "buckets_path": "number_of_bytes"
          }
        },
        "bytes_2nd_deriv": {
          "derivative": {
            "buckets_path": "bytes_1st_deriv"
          }
        }
      }
    }
  }
}

예제 응답: 2차 도함수

{
  "took": 6,
  "timed_out": false,
  "_shards": {
    "total": 1,
    "successful": 1,
    "skipped": 0,
    "failed": 0
  },
  "hits": {
    "total": {
      "value": 10000,
      "relation": "gte"
    },
    "max_score": null,
    "hits": []
  },
  "aggregations": {
    "sales_per_month": {
      "buckets": [
        {
          "key_as_string": "2025-03-01T00:00:00.000Z",
          "key": 1740787200000,
          "doc_count": 480,
          "number_of_bytes": {
            "value": 2804103
          }
        },
        {
          "key_as_string": "2025-04-01T00:00:00.000Z",
          "key": 1743465600000,
          "doc_count": 6849,
          "number_of_bytes": {
            "value": 39103067
          },
          "bytes_1st_deriv": {
            "value": 36298964
          }
        },
        {
          "key_as_string": "2025-05-01T00:00:00.000Z",
          "key": 1746057600000,
          "doc_count": 6745,
          "number_of_bytes": {
            "value": 37818519
          },
          "bytes_1st_deriv": {
            "value": -1284548
          },
          "bytes_2nd_deriv": {
            "value": -37583512
          }
        }
      ]
    }
  }
}

첫 번째 버킷에는 이전 버킷이 없으므로 1차 도함수가 계산되지 않아요. 마찬가지로 첫 번째 또는 두 번째 버킷에는 2차 도함수가 계산되지 않아요.

더 알아보기 (Learn more)

• OpenSearch 공식 문서