본문 바로가기
WIKI 기술 지식 베이스

메트릭 모니터

원문 보기 위키 갱신

메트릭 모니터는 지속적인 데이터 스트림을 모니터링하는 데 유용해요. Datadog로 전송되는 모든 메트릭은 일정 기간 동안 임계값을 넘으면 알림을 받을 수 있지요. 임계값, 변화, 이상 징후, 아웃라이어, 예측 등 원하는 감지 방법을 선택해 모니터를 만들 수 있어요.

출처: 문서

본문

개요

메트릭 모니터는 지속적인 데이터 스트림에 유용해요. Datadog로 전송되는 모든 메트릭은 일정 기간 동안 임계값을 넘으면 알림을 받을 수 있어요.

Datadog에서 메트릭 모니터를 만들려면 Monitors > New Monitor로 이동해 Metric 모니터 유형을 선택하세요.

감지 방법 선택

{% tab title="Threshold" %} 임계값 알림은 메트릭 값을 정적 임계값과 비교해요.

각 알림 평가에서 Datadog는 선택한 기간 동안 평균, 최솟값, 최댓값 또는 합계를 계산하고 그것이 임계값보다 위, 아래, 같음 또는 같지 않은지 확인해요. 예상 값을 알고 있는 표준 알림 사례에 적합해요. distribution metric type은 선택한 기간 동안 백분위수를 계산하는 추가 임계값 옵션을 제공해요.

자세한 내용은 알림 조건 설정 섹션을 참고하세요. {% /tab %}

{% tab title="Change" %} 변화 알림은 N분 전과 현재 사이의 값의 절대 또는 상대(%) 변화를 주어진 임계값과 비교해요. 비교되는 데이터 포인트는 단일 포인트가 아니라 메트릭 정의 섹션의 매개변수를 사용해 계산돼요.

각 알림 평가에서 Datadog는 현재 시리즈와 N분 전 시리즈 사이의 원시 차이(양수 또는 음수 값)를 계산한 다음, 선택한 기간 동안 평균/최솟값/최댓값/합계를 계산해요. 계산된 시리즈가 임계값을 넘으면 알림이 트리거돼요.

이 알림 유형은 예상하지 못한 임계값이 없을 때 메트릭의 급증, 급락, 또는 느린 변화를 추적하는 데 유용해요.

자세한 내용은 Change alert monitors 가이드를 참고하세요. {% /tab %}

{% tab title="Anomaly" %} 이상 징후 감지 알림은 과거 동작을 사용해 메트릭이 비정상적으로 동작하고 있는지 감지해요.

이상 징후 알림은 과거를 기반으로 시리즈에 대한 예상 값 범위를 계산해요. 일부 이상 징후 알고리즘은 하루 중 시간과 요일을 사용해 예상 범위를 결정하므로, 단순 임계값 알림으로는 감지할 수 없는 이상 징후를 포착해요. 예를 들어 시리즈가 오전 5시에 비정상적으로 높은데 오전 10시에는 정상으로 간주되는 경우가 있어요.

각 알림 평가에서 Datadog는 시리즈가 예상 범위 위, 아래, 밖에 해당하는 백분율을 계산해요. 이 백분율이 구성된 임계값을 넘으면 알림이 트리거돼요.

자세한 내용은 Anomaly Monitor 페이지를 참고하세요. {% /tab %}

{% tab title="Outliers" %} 아웃라이어 모니터는 그룹의 구성원(호스트, 가용 영역, 파티션 등)이 나머지와 다르게 비정상적으로 동작할 때 감지해요.

각 알림 평가에서 Datadog는 모든 그룹이 서로 뭉쳐 있고 동일한 동작을 보이는지 확인해요. 하나 이상의 그룹이 나머지 그룹에서 벗어나면 알림이 트리거돼요.

자세한 내용은 Outlier Monitor 페이지를 참고하세요. {% /tab %}

{% tab title="Forecast" %} 예측 알림은 메트릭의 미래 동작을 예측하고 정적 임계값과 비교해요. 강한 추세나 반복 패턴이 있는 메트릭에 특히 잘 맞아요.

각 알림 평가에서 예측 알림은 예상 편차 경계와 함께 메트릭의 미래 값을 예측해요. 경계의 어떤 부분이 구성된 임계값을 넘으면 알림이 트리거돼요.

자세한 내용은 Forecast Monitor 페이지를 참고하세요. {% /tab %}

메트릭 정의

Datadog에 보고되는 모든 메트릭을 모니터에 사용할 수 있어요. 에디터와 아래 단계를 사용해 메트릭을 정의하세요. 쿼리 매개변수는 선택한 감지 방법에 따라 약간 달라져요.

{% tab title="Threshold" %}

{% image source="https://docs.dd-static.net/images/monitors/monitor_types/metric/metric_threshold_config.f3c59a33f414c9fa6e01152062380b3e.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/monitors/monitor_types/metric/metric_threshold_config.f3c59a33f414c9fa6e01152062380b3e.png?auto=format&fit=max&w=850&dpr=2 2x" alt="define the metric for threshold detection metric monitor" /%}

단계 필수 기본값 예시
메트릭 선택 예 없음 system.cpu.user
from 정의 아니요 Everywhere env:prod
메트릭 집계 지정 예 avg by sum by
Group by 아니요 Everything host
모니터 쿼리 집계 지정 아니요 average sum
평가 창 아니요 5 minutes 1 day

정의

옵션 설명
average 시리즈를 평균 내어 임계값과 대조되는 단일 값을 만든다. 모니터 쿼리에 avg() 함수를 추가해요.
max 생성된 시리즈의 단일 값 중 하나라도 임계값을 넘으면 알림이 트리거돼요. 모니터 쿼리에 max() 함수를 추가해요. 추가 임계값 동작은 참고 사항 섹션을 확인하세요.
min 쿼리의 평가 창에서 모든 포인트가 임계값을 넘으면 알림이 트리거돼요. 모니터 쿼리에 min() 함수를 추가해요. 추가 임계값 동작은 참고 사항 섹션을 확인하세요.
sum 시리즈의 모든 포인트의 합이 임계값을 넘으면 알림이 트리거돼요. 모니터 쿼리에 sum() 함수를 추가해요.
percentile(pXX) 쿼리의 평가 창에서 pXX%의 포인트가 임계값을 넘으면 알림이 트리거돼요. 이 옵션은 모니터 쿼리에 percentile 함수를 추가해요. distribution 메트릭 유형에서만 사용할 수 있어요.
Evaluation window 모니터가 평가하는 기간. 5 minutes, 15 minutes, 1 hour 같은 사전 설정 시간 창을 사용하거나, custom으로 1분에서 730시간(1개월) 사이의 값을 설정해요.

{% /tab %}

{% tab title="Change" %}

{% image source="https://docs.dd-static.net/images/monitors/monitor_types/metric/metric_change_alert_config.6537c55d4edcb6833e26ccf0acc0700c.png?auto=format&fit=max&w=850 1x, https://docs.dd-static.net/images/monitors/monitor_types/metric/metric_change_alert_config.6537c55d4edcb6833e26ccf0acc0700c.png?auto=format&fit=max&w=850&dpr=2 2x" alt="define the metric for change detection metric monitor" /%}

단계 필수 기본값 예시
메트릭 선택 예 없음 system.cpu.user
from 정의 아니요 Everywhere env:prod
메트릭 집계 지정 아니요 avg by sum by
Group by 아니요 Everything host
모니터 쿼리 집계 지정 아니요 average sum
변화 유형 선택 아니요 change % change
평가 창 아니요 5 minutes 1 day
비교 창 아니요 5 minutes 1 month

정의

옵션 설명
change 값의 절대 변화.
% change 이전 값과 비교한 값의 백분율 변화. 예를 들어 이전 값 2, 현재 값 4의 백분율 변화는 100%예요.
average 시리즈를 평균 내어 임계값과 대조되는 단일 값을 만든다. 모니터 쿼리에 avg() 함수를 추가해요.
max 생성된 시리즈의 단일 값 중 하나라도 임계값을 넘으면 알림이 트리거돼요. 모니터 쿼리에 max() 함수를 추가해요. 추가 임계값 동작은 참고 사항 섹션을 확인하세요.
min 쿼리의 평가 창에서 모든 포인트가 임계값을 넘으면 알림이 트리거돼요. 모니터 쿼리에 min() 함수를 추가해요. 추가 임계값 동작은 참고 사항 섹션을 확인하세요.
sum 시리즈의 모든 포인트의 합이 임계값을 넘으면 알림이 트리거돼요. 모니터 쿼리에 sum() 함수를 추가해요.
percentile(pXX) 쿼리의 평가 창에서 pXX%의 포인트가 임계값을 넘으면 알림이 트리거돼요. 이 옵션은 모니터 쿼리에 percentile 함수를 추가해요. distribution 메트릭 유형에서만 사용할 수 있어요.
Evaluation window 모니터가 평가하는 기간. 5 minutes, 15 minutes, 1 hour 같은 사전 설정 시간 창을 사용하거나, custom으로 1분에서 730시간(1개월) 사이의 값을 설정해요.

{% /tab %}

참고:

  • 백분위수 집계기가 있는 distribution 메트릭을 사용하면 일치하는 백분위수 임계값이 자동으로 지정돼요. 백분위수 집계기가 있는 메트릭은 알림 메시지에서 스냅샷 그래프를 생성하지 않아요.
  • max/min: max와 min에 대한 이 설명은 모니터가 메트릭이 임계값 위로 갈 때 알림을 보낸다고 가정해요. 임계값 아래로 갈 때 알림을 보내는 모니터의 경우 max와 min 동작이 반대로 돼요.
  • 모니터용 메트릭 정의는 그래프용 메트릭 정의와 유사해요. Advanced... 옵션 사용에 대한 자세한 내용은 Advanced graphing을 참고하세요.
  • as_count() 사용 시 다른 동작이 있어요. 자세한 내용은 as_count() in Monitor Evaluations를 참고하세요.
  • N/A 그룹은 모니터에 포함되지 않으므로 태그 키에는 값이 있어야 해요.

알림 조건 설정

메트릭이 다음 중 하나일 때 트리거되도록 설정하세요.

  • above
  • above or equal to
  • below
  • below or equal to
  • equal to
  • not equal to

값이 0과 1 사이면 선행 0이 필요해요. 예: 0.3.

고급 알림 조건

데이터 창

평가를 위해 전체 데이터 창을 요구하거나(Require) 요구하지 않을 수 있어요(Do not require).

이 설정은 알림 엔진이 모니터를 평가 후보로 간주하는 시점을 변경할 수 있게 해줘요.

Do not require (기본값): 모니터는 인식되는 즉시 평가돼요. 데이터 포인트가 드물 수 있다면 이 값을 사용하는 것을 고려하세요. 이 구성에서는 평가 시간 범위에 단일 데이터 포인트가 있어도 모니터가 평가해요.

Require: 모니터는 평가 창이 데이터로 채워진(filled) 것으로 간주될 때까지 평가되지 않아요. 전체 평가 시간 범위에 데이터가 있으면 알림을 받으려면 이 옵션을 사용하세요.

평가 시간 범위가 데이터로 채워졌는지 정의하려면 시간 범위를 더 작은 버킷으로 나눠요.

다음 로직이 버킷 크기를 결정해요:

  • 평가 시간 범위가 분 단위: 버킷 크기는 1분
  • 평가 시간 범위가 시간 단위: 버킷 크기는 10분
  • 평가 시간 범위가 일 단위: 버킷 크기는 1시간
  • 평가 시간 범위가 월 단위: 버킷 크기는 4시간

"전체 창(full window)"으로 간주되려면 모니터는 다음이 필요해요.

  1. 첫 번째 버킷에 데이터 포인트가 하나 이상 있어야 해요. 첫 번째 버킷은 시간순으로 창에서 가장 이른 버킷이에요.
  2. 데이터 포인트가 없는 버킷이 총 3개 이하이어야 해요.

조건이 충족되면 모니터가 평가돼요. 그렇지 않으면 평가가 취소되고 모니터 상태는 변경되지 않아요.

예를 들어 지난 2h 동안 평가하는 모니터는 10분짜리 12개 버킷으로 분할돼요. 첫 번째 버킷에 데이터가 있고 총 최대 3개의 버킷이 비어 있으면 모니터가 full로 간주돼요.

data B0 B1 B2 B3 B4 B5 B6 B7 B8 B9 B10 B11 전체 창?
case 1 1 1 1 1 1 1 1 1 1 1 1 1 예
case 2 x 1 1 1 1 1 1 1 1 1 1 1 아니요
case 3 1 1 x x x 1 1 1 1 1 1 1 예
case 4 1 x x x 1 1 1 1 x x 1 1 아니요

Evaluation Window에 대한 자세한 내용은 Monitor configuration 페이지를 참고하세요.

기타 옵션

고급 알림 옵션(no data, auto resolve)에 대한 지침은 Monitor configuration 페이지를 참고하세요.

알림

Configure notifications and automations 섹션에 대한 지침은 Notifications 및 Monitor configuration 페이지를 참고하세요.

더 알아보기 (Learn more)

추가로 도움이 되는 문서, 링크, 아티클: