산술
산술 (Arithmetic)
산술 함수는 메트릭의 절댓값, 반올림, 거듭제곱, 로그, 누적 합, 적분 등을 계산해 주는 함수예요. 메트릭 값을 변환해서 그래프의 형태를 원하는 대로 만들 때 유용합니다.
출처: 문서
본문
절댓값 (Absolute)
| 함수 | 설명 | 예시 |
|---|---|---|
abs() |
메트릭의 절댓값을 그래프로 그립니다. | abs(<METRIC_NAME>{*}) |
이 사인 시계열 sin{*}이 아래와 같다면,
다음과 같이 abs(sin{*})로 변환됩니다.
반올림 (Rounding)
| 함수 | 설명 | 예시 |
|---|---|---|
round() |
메트릭의 각 포인트를 가장 가까운 값으로 반올림합니다. 선택적으로 정밀도를 지정할 수 있어요. | round(<METRIC_NAME>{*}), round(<METRIC_NAME>{*}, <DECIMAL_PLACES>) |
ceil() |
메트릭의 각 포인트를 가장 가까운 정수로 올림합니다. | ceil(<METRIC_NAME>{*}) |
floor() |
메트릭의 각 포인트를 가장 가까운 정수로 내림합니다. | floor(<METRIC_NAME>{*}) |
round()와 함께 선택적인 두 번째 인자를 사용해 유지할 소수 자릿수를 설정할 수 있어요.
지수 (Exponent)
| 함수 | 설명 | 예시 |
|---|---|---|
pow() |
메트릭 또는 상수의 각 포인트를 다른 메트릭 또는 상수의 거듭제곱으로 올립니다. | pow(<METRIC_NAME>{*}, CONSTANT), pow(<METRIC_NAME>{*}, <METRIC_NAME>{*}), pow(CONSTANT, <METRIC_NAME>{*}), pow(CONSTANT, CONSTANT) |
공식에서 거듭제곱이 필요할 때 pow()를 사용하세요. 예를 들어 pow(<METRIC_NAME>{*}, 2)로 메트릭을 제곱하거나, pow(2, <METRIC_NAME>{*})로 메트릭을 지수로 사용할 수 있어요.
로그 (Logarithm)
밑이 2인 로그 (Log base 2)
| 함수 | 설명 | 예시 |
|---|---|---|
log2() |
메트릭의 밑이 2인 로그를 그래프로 그립니다. | log2(<METRIC_NAME>{*}) |
예시:
메트릭 x{*}가 각 데이터 포인트마다 1씩 증가한다면, log2(x{*})는 다음과 같은 모양이 됩니다.
밑이 10인 로그 (Log base 10)
| 함수 | 설명 | 예시 |
|---|---|---|
log10() |
메트릭의 밑이 10인 로그를 그래프로 그립니다. | log10(<METRIC_NAME>{*}) |
예시:
메트릭 x{*}가 각 데이터 포인트마다 1씩 증가한다면, log10(x{*})는 다음과 같은 모양이 됩니다.
누적 합 (Cumulative sum)
| 함수 | 설명 | 예시 |
|---|---|---|
cumsum() |
표시된 시간 창에 걸친 메트릭의 누적 합을 그래프로 그립니다. | cumsum(<METRIC_NAME>{*}) |
예시:
메트릭 const_1{*}가 값이 1인 상수라면, cumsum(const_1{*})는 다음과 같은 모양이 됩니다.
모니터에서의 누적 합 (Cumulative sum in monitors)
누적 합 함수는 시각적 함수이므로 모니터 쿼리에서는 사용을 피해야 해요. 대시보드나 노트북에서 사용하면 포인트가 선택한 시간대에 따라 값을 반영합니다. 하지만 모니터는 어떤 시간대를 사용해야 할지 알 수 없기 때문에 이 방식이 모니터에 잘 맞지 않습니다.
대신 모니터 평가 기간에서 누적 시간 창(Cumulative Time Windows)을 구성하세요.
적분 (Integral)
| 함수 | 설명 | 예시 |
|---|---|---|
integral() |
메트릭의 적분을 그래프로 그립니다. | integral(<METRIC_NAME>{*}) |
참고: Datadog의 integral()은 특정 메트릭에 대해 표시된 시간 창 내 모든 연속된 포인트 쌍에 대한 [시간 델타] x [값 델타]의 누적 합입니다.
기타 함수 (Other functions)
사용할 수 있는 다른 함수들을 확인해 보세요:
- 알고리즘 (Algorithmic): 메트릭에 이상 탐지(Anomaly) 또는 이상치(Outlier) 탐지를 적용합니다.
- 카운트 (Count): 메트릭 값 중 0이 아니거나 null이 아닌 값을 셉니다.
- 제외 (Exclusion): 메트릭의 특정 값을 제외합니다.
- 보간 (Interpolation): 메트릭의 기본값을 채우거나 설정합니다.
- 랭크 (Rank): 메트릭의 일부 하위 집합만 선택합니다.
- 레이트 (Rate): 메트릭에 대한 사용자 지정 미분값을 계산합니다.
- 회귀 (Regression): 메트릭에 머신러닝 함수를 적용합니다.
- 롤업 (Rollup): 메트릭에 사용되는 원시 데이터 포인트 수를 제어합니다.
- 스무딩 (Smoothing): 메트릭의 변동을 완만하게 다듬습니다.
- 타임시프트 (Timeshift): 메트릭 데이터 포인트를 타임라인을 따라 이동합니다.