임계값 탐지¶
현재 문서 위치
이 문서는 탐지 규칙 구성 프로세스의 두 번째 단계입니다. 구성을 완료한 후 기본 문서로 돌아가 3단계: 이벤트 알림 계속하기를 진행하세요.
데이터 범위: 메트릭 M, 로그 L, 트레이스 T, RUM 데이터 R, 객체 O 등 모든 데이터 유형을 지원합니다.
탐지 구성¶
탐지 빈도¶
탐지를 실행하는 시간 주기를 설정합니다.
-
사전 설정 옵션: 1분, 5분, 10분, 15분, 30분, 1시간
-
Crontab 모드: "Crontab 모드로 전환"을 클릭하면 사용자 지정 주기를 구성할 수 있으며, 초, 분, 시, 일, 월, 주 등의 주기를 기준으로 예약 작업 실행을 구성할 수 있습니다.
탐지 구간¶
각 탐지에서 쿼리할 데이터 시간 범위를 설정합니다(❗️ 탐지 구간은 탐지 빈도보다 크거나 같아야 하며, 실제 데이터 보고 주기와 일치해야 누락 탐지나 오탐을 방지할 수 있습니다).
- 사전 설정 옵션:
| 탐지 빈도 | 탐지 구간(드롭다운 선택 항목) |
|---|---|
| 30s | 1m/5m/15m/30m/1h/3h |
| 1m | 1m/5m/15m/30m/1h/3h |
| 5m | 5m/15m/30m/1h/3h |
| 15m | 15m/30m/1h/3h/6h |
| 30m | 30m/1h/3h/6h |
| 1h | 1h/3h/6h/12h/24h |
| 6h | 6h/12h/24h |
| 12h | 12h/24h |
| 24h | 24h |
- 사용자 지정 형식: 탐지 구간을 직접 입력합니다. 예: 20m(최근 20분), 2h(최근 2시간), 1d(최근 1일).
탐지 메트릭¶
DQL을 기반으로 탐지 데이터 소스와 집계 방식을 정의합니다.
고카디널리티 필드를 탐지 차원으로 선택하지 마세요. 잘못 구성하여 트리거 조건이 지나치게 완화되면 빈번한 알림이 발생할 수 있습니다. 현재 쿼리의 최대 반환 수는 10만 건의 레코드입니다.
구성 예시: 모니터의 탐지 메트릭을 구성할 때 trace_id를 by 그룹 필드로 선택했습니다.
이때 시스템은 다음과 같이 안내합니다:
현재 그룹 필드 trace_id는 고카디널리티 위험 필드입니다. 이러한 필드로 집계하면 대량의 그룹이 생성되어 알림 폭주를 유발하기 쉽고, 이로 인해 모니터가 시스템에 의해 자동 일시 중지될 수 있으므로 그룹 설정을 최적화하세요.
구성 요소¶
| 구성 항목 | 설명 |
|---|---|
| 워크스페이스 | 기본값은 현재 워크스페이스이며, 권한이 부여된 다른 워크스페이스로 전환할 수 있습니다 권한을 부여하면 현재 계정의 다른 워크스페이스에 있는 탐지 메트릭을 사용하여 모니터를 생성할 수 있습니다. 규칙 생성에 성공하면 워크스페이스 간 알림 구성을 구현할 수 있습니다. 유의할 점은 다른 워크스페이스를 선택하면 탐지 메트릭 드롭다운 목록에 해당 워크스페이스에서 사용 권한이 부여된 데이터 유형만 표시된다는 것입니다 |
| 데이터 소스 유형 | 메트릭, 로그, 트레이스, RUM 데이터 등 |
| 쿼리 방식 | 단순 쿼리, 표현식 쿼리, PromQL 쿼리, 데이터 소스 쿼리 |
| 필터 조건 | 태그로 탐지 객체 필터링 |
| 집계 방식 | avg, sum, max, min, count 등 |
| 함수 지원 | fx 버튼을 클릭하면 다음 함수를 선택할 수 있습니다:❗️변환 함수 derivative, difference, non_negative_derivative, non_negative_difference를 선택할 때는 interval을 추가해야 합니다. 예: [::5m] |
클릭하여 쿼리 방식 상세 설명, 함수 사용 추가 설명을 확인할 수 있습니다.
트리거 조건¶
트리거 조건과 심각도를 구성합니다. 쿼리 결과가 여러 값일 때 임의의 값이 트리거 조건을 충족하면 이벤트가 생성됩니다.
치명, 심각, 중요, 경고의 4단계 임계값과 정상 복구 조건을 구성할 수 있습니다.
| 등급 | 구성 | 설명 |
|---|---|---|
| 치명 | Result >= [值]일 때 |
최고 등급 알림으로 즉시 처리해야 합니다 |
| 심각 | Result >= [值]일 때 |
높은 등급 알림으로 우선 처리해야 합니다 |
| 중요 | Result >= [值]일 때 |
중간 등급 알림으로 주의가 필요합니다 |
| 경고 | Result >= [值]일 때 |
낮은 등급 알림으로 유의해야 합니다 |
| 정상 | [N]회 탐지 동안 이벤트가 생성되지 않음 |
탐지 메트릭이 "치명", "심각", "중요", "경고" 이상 이벤트를 트리거한 후 연속 N회 탐지가 모두 정상이면 "정상" 이벤트가 생성됩니다. 이상 이벤트가 정상으로 복구되었는지 판단하는 데 사용되며, 구성을 권장합니다 |
자세한 내용은 이벤트 레벨 설명을 참고하세요.
고급 옵션¶
연속 트리거 판단¶
활성화하면 트리거 조건을 지속적으로 충족할 때만 이벤트가 생성되어 순간 변동에 의한 오탐을 방지합니다(❗️ 최대 구성 상한은 10회).
대량 알림 보호¶
시스템에서 기본적으로 활성화됩니다.
단일 탐지에서 생성된 알림 수가 사전 설정된 임계값을 초과하면 시스템은 자동으로 상태별 요약 정책으로 전환합니다: 더 이상 알림 객체를 개별 처리하지 않고, 이벤트 상태에 따라 소량의 요약 알림을 생성하여 전송합니다.
이렇게 하면 알림의 적시성을 보장하면서 알림 노이즈를 크게 줄이고, 과도한 알림 처리로 인한 타임아웃 위험을 방지할 수 있습니다.
이 스위치가 활성화되면 이후 모니터가 이상을 탐지한 후 생성되는 이러한 이벤트 상세에는 이력 기록과 연관 이벤트가 표시되지 않습니다.
복구 조건¶
복구 조건과 심각도를 구성합니다. 쿼리 결과가 여러 값일 때 임의의 값이 트리거 조건을 충족하면 복구 이벤트가 생성됩니다.
등급별로 독립적인 복구 임계값을 설정하여 단계적 복구를 구현합니다. 예: 심각 알림은 값이 70 미만으로 떨어져야 복구되고, 중요 알림은 80 미만이면 복구됩니다.
알림 복구 로직¶
"복구 조건"을 활성화하면 시스템은 Fault ID(인시던트 ID)를 고유 식별자로 사용하여 알림의 전체 수명 주기(Issue 생성 등의 작업 포함)를 관리합니다.
단계별 복구 기능을 동시에 활성화하면:
-
플랫폼은 각 알림 레벨(예:
critical,warning)에 대해 별도의 복구 규칙(즉, 복구 임계값)을 구성합니다 -
각 레벨의 알림 상태와 복구 상태는 독립적으로 계산됩니다
-
기존 Fault ID로 식별되는 알림 수명 주기에는 영향을 주지 않습니다
따라서 모니터가 처음 알림을 트리거할 때(즉, 새로운 알림 수명 주기를 시작할 때) 시스템은 동시에 두 개의 알림 메시지를 생성합니다. 두 메시지가 동일해 보이는 이유는 다음과 같습니다:
-
첫 번째 알림 소스: 전체 탐지(
check)로, 전체 인시던트 수명 주기의 시작을 나타냅니다(원본 규칙 기반). -
두 번째 알림 소스: 단계별 탐지(
critical/error/warning/…)로, 활성화된 단계별 복구 기능이 시작되었음을 나타내며, 구체적인 알림 레벨과 이후 복구 상태(예:critical_ok)를 표시하는 데 사용됩니다.
위에서 df_monitor_checker_sub 필드는 두 가지 알림을 구분하는 핵심 기준입니다:
-
check: 전체 탐지 결과를 나타냅니다. -
기타 값(예:
critical,error,warning등): 단계별 탐지 규칙의 결과에 해당합니다.
따라서 알림이 처음 트리거될 때 두 개의 레코드가 나타나며, 내용은 유사하지만 소스와 용도가 다릅니다.
df_monitor_checker_sub |
T+0 | T+1 | T+2 | T+3 |
|---|---|---|---|---|
check |
check |
error |
warning |
ok |
critical |
critical |
critical_ok |
||
error |
error |
error_ok |
||
warning |
warning |
warning_ok |
데이터 공백¶
탐지 메트릭이 탐지 구간 내에서 쿼리 결과가 비어 있을 때의 처리 정책:
| 옵션 | 설명 |
|---|---|
| 이벤트를 트리거하지 않음(기본값) | 데이터가 없을 때 알림을 생성하지 않으며, 데이터 누락이 허용되는 시나리오에 적합합니다 |
| 쿼리 결과를 0으로 간주 | 빈 데이터를 0 값으로 간주하여 임계값을 판정합니다 |
| 데이터 공백 이벤트 트리거 | 동일 객체에서 회차별 공백마다 데이터 공백 이벤트를 한 번 생성하며, 복구 후 다시 공백이 발생하면 새로 생성할 수 있습니다. |
| 데이터 공백 이벤트 지속 트리거 | 동일 객체가 공백 조건을 지속적으로 충족하면 데이터가 복구될 때까지 탐지 빈도에 따라 공백 이벤트를 생성합니다. 구성 방법은 데이터 공백을 참고하세요. |
| 치명 이벤트 트리거 | 데이터가 없을 때 치명 등급 이벤트를 트리거합니다 |
| 심각 이벤트 트리거 | 데이터가 없을 때 심각 등급 이벤트를 트리거합니다 |
| 중요 이벤트 트리거 | 데이터가 없을 때 중요 등급 이벤트를 트리거합니다 |
| 경고 이벤트 트리거 | 데이터가 없을 때 경고 등급 이벤트를 트리거합니다 |
| 복구 이벤트 트리거 | 데이터가 없을 때 복구 이벤트를 트리거합니다 |
트리거 조건, 데이터 공백, 정보 생성을 동시에 구성한 경우 다음 우선순위에 따라 트리거를 판단합니다: 데이터 공백 > 트리거 조건 > 정보 이벤트 생성.
즉, 먼저 공백 여부를 판단하고, 다음으로 임계값 트리거 여부를 판단하며, 마지막으로 정보 이벤트 생성 여부를 판단합니다.
정보 생성¶
이 옵션을 활성화하면 정보 생성 조건을 구성해야 합니다. 탐지 결과가 "치명", "심각", "중요", "경고" 중 어느 임계값도 트리거하지 않았고 정보 생성 조건을 충족할 때만 시스템이 "정보" 이벤트를 기록합니다.
정상 상태 변화나 낮은 우선순위의 정보를 기록해야 하는 시나리오에 적합합니다.
후속 구성¶
위 탐지 구성을 완료한 후 다음을 계속 구성하세요:

