콘텐츠로 이동

감지 규칙


시스템에는 다양한 감지 규칙이 내장되어 있어 각종 데이터의 모니터링 요구 사항을 정확히 충족하고 오탐 및 미탐을 효과적으로 방지할 수 있습니다.

구성 프로세스

모니터를 생성하려면 다음 순서에 따라 구성을 완료해야 합니다:

  1. 규칙 유형 선택: 감지 구성의 데이터 범위와 알고리즘 로직을 결정합니다.
  2. 감지 구성: 유형에 따라 서로 다른 구성 항목이 적용됩니다.
  3. 이벤트 알림: 이벤트 제목, 내용, 연결 정보 및 데이터 단절 이벤트 내용을 정의합니다.
  4. 알림 구성: 알림 정책과 음소거 주기를 설정합니다.
  5. 연결: 대시보드 연결을 구성합니다.
  6. 권한: 작업 권한을 설정합니다.

‘감지 구성’은 규칙 유형에 따라 달라지지만, 이벤트 알림, 알림 구성, 연결 및 권한은 모든 규칙 유형에서 구성 논리가 동일합니다.

규칙 유형

모니터링 목표에 따라 적합한 감지 로직을 선택할 수 있습니다:

규칙 이름
데이터 범위
기본 설명
임계값 감지 전체 설정한 임계값을 기반으로 메트릭 데이터의 이상을 감지합니다
급변 감지 메트릭(M) 과거 데이터를 기반으로 메트릭의 갑작스러운 이상 징후를 감지하며, 주로 비즈니스 데이터, 시간 창이 짧은 시나리오에 적합합니다
구간 감지 메트릭(M) 동적 임계값 범위를 기반으로 메트릭의 이상 데이터 포인트를 감지하며, 주로 추세가 안정적인 시계열에 적합합니다
구간 감지 V2 메트릭(M)
트레이스(T)
RUM 데이터(R)
동적 임계값 범위를 기반으로 메트릭의 이상 데이터 포인트를 감지하며, 주로 추세가 안정적인 시계열에 적합합니다
이상치 감지 메트릭(M) 특정 그룹 내 감지 객체의 메트릭/통계 데이터에 이상치 편차가 있는지 감지합니다
로그 감지 로그(L) 로그 데이터를 기반으로 비즈니스 애플리케이션의 이상을 감지합니다
프로세스 이상 감지 프로세스 객체(O::host_processes) 정기적으로 프로세스 데이터를 감지하여 프로세스 이상 상황을 파악합니다
인프라 생존 감지 V2 객체(O) 인프라 객체 데이터를 기반으로 생존 조건을 설정하고 인프라의 안정성을 모니터링합니다
애플리케이션 성능 지표 감지 트레이스(T) 애플리케이션 성능 모니터링(APM) 데이터를 기반으로 임계값 규칙을 설정하여 이상 상황을 감지합니다
RUM 지표 감지 RUM 데이터(R) 실제 사용자 모니터링(RUM) 데이터를 기반으로 임계값 규칙을 설정하여 이상 상황을 감지합니다
복합 감지 전체 여러 모니터의 결과를 표현식으로 조합하여 하나의 모니터로 만들고, 조합된 결과를 기반으로 알림을 생성합니다
신서틱 테스트 이상 탐지 신서틱 데이터(D::类型) 신서틱 모니터링 데이터를 기반으로 임계값 규칙을 설정하여 이상 상황을 감지합니다
네트워크 데이터 감지 네트워크(N) 네트워크 데이터를 기반으로 임계값 규칙을 설정하여 네트워크 성능의 안정성을 감지합니다
외부 이벤트 감지 기타 지정된 URL 주소를 통해 타사 시스템에서 생성된 이상 이벤트 또는 기록을 POST 요청 방식으로 HTTP 서버에 전송한 후 이벤트 데이터를 생성합니다
인프라 변경 감지 객체(O) 인프라 수명 주기 추적을 기반으로 각종 변경 행위를 모니터링하고 구성 드리프트, 비인가 작업 등의 이상 상태를 정확히 식별합니다
프로그래밍 가능 감지 전체 스크립트로 감지 규칙을 작성하며, 규칙이 다양하고 복잡한 모니터링 시나리오에 주로 적합합니다

규칙 유형을 선택하면 ‘감지 구성’ 모듈의 선택 가능한 파라미터가 그에 따라 변경됩니다. 이벤트 알림 및 후속 구성은 모든 유형에서 동일하게 유지됩니다.

감지 구성

감지 규칙 유형에 따라 해당 감지 빈도, 감지 구간 및 감지 지표를 각각 구성할 수 있습니다.

규칙 유형에 따라 감지 구성의 차이가 크므로 해당 유형의 상세 구성 문서를 참고하세요.

데이터 단절

데이터 단절은 식별된 감지 객체에 대해 지속적으로 데이터가 조회되지 않는 상태를 의미합니다. 데이터 단절 처리 작업을 제공하는 모니터는 감지 구성 > 데이터 단절에서 작업을 선택하고 단절 지속 시간을 입력한 후 저장하여 이후 감지에 사용할 수 있습니다.

데이터 단절 이벤트를 생성해야 할 때 다음 두 가지 방식을 선택할 수 있습니다:

처리 작업 이벤트 생성 방식
데이터 단절 이벤트 트리거 동일한 객체에서 단절이 발생한 각 라운드마다 한 번씩 이벤트를 생성하며, 복구된 후 다시 단절되면 새로 생성할 수 있습니다. 각 단절 라운드마다 이상을 한 번 기록하는 시나리오에 적합합니다.
데이터 단절 이벤트 지속 트리거 동일한 객체가 단절 조건을 지속적으로 충족하면 데이터가 복구될 때까지 감지 빈도에 따라 이벤트를 생성합니다. 아직 복구되지 않은 단절 객체를 지속적으로 추적하는 시나리오에 적합합니다.

단절 지속 시간은 트리거 시작 조건을 결정하고, 감지 빈도는 이후 감지 및 지속 이벤트 생성 주기를 결정합니다. 예를 들어 단절 지속 시간을 10분, 감지 빈도를 5분으로 설정하면 10분 단절 조건을 충족한 후, 이후 감지할 때마다 여전히 조건을 충족하면 이벤트를 한 번씩 생성합니다. 각 감지 객체는 개별적으로 판단되며, 복구된 후 다시 단절되면 새로운 라운드의 처리가 시작됩니다.

지속 방식은 연속 트리거 판단 활성화와 독립적입니다. 후자는 임계값 조건을 연속으로 충족해야 하는 횟수를 계속 제어합니다. 새로 생성할 때 기본값은 이벤트 트리거 안 함이며, 기존 모니터는 저장된 작업에 따라 계속 실행됩니다.

이벤트가 생성된 후 실제 알림은 연결된 알림 정책 및 음소거 구성에 따라 결정됩니다. 반복 알림을 통해 반복 알림 간격을 제어할 수 있으며, 음소거 기간에도 이벤트는 계속 기록되고 음소거 규칙에 따라 해당 알림이 억제됩니다.

데이터 대기 창

데이터 대기 창은 모든 모니터 유형에 적용됩니다. 예약된 실행 시간에 도달하면 모니터는 지정된 시간 동안 먼저 대기한 후 감지 판단을 수행하여 데이터 지연으로 인한 오탐 가능성을 줄입니다.

  • 기본값은 대기 안 함입니다.
  • 선택 가능한 대기 시간은 1분, 2분, 3분, 5분, 10분, 15분, 30분입니다.
  • 대기 시간은 인접한 두 예약 실행 시간의 간격보다 작아야 합니다. 그렇지 않으면 모니터를 저장할 수 없으며 “데이터 대기 창은 모니터 실행 간격보다 작아야 합니다”라는 메시지가 표시됩니다. Crontab 모드도 인접한 두 예약 실행 시간을 기준으로 동일하게 검증합니다.

예를 들어 모니터가 10:00에 실행되도록 예약되어 있고 데이터 대기 창이 5분으로 설정된 경우, 작업은 약 10:05에 실행되기 시작합니다. 대기는 실행 시간만 지연시킬 뿐 조회 시간 범위를 변경하지 않습니다. 감지 구간이 최근 1시간인 경우에도 여전히 09:00 ~ 10:00 데이터를 조회합니다.

자세한 실행 로직은 모니터 내부 원리를 참고하세요.

스트리밍 집계 가속

스트리밍 집계는 모니터 조회 속도를 높이는 데 사용됩니다. 활성화하면 시스템이 조회 전략을 자동으로 선택하며, 조건을 충족할 때 스트리밍 집계를 사용합니다. 비활성화하면 감지는 원래 조회 경로를 사용합니다. 클라우드 통합 메트릭에 과거 데이터 보충(백필)이 있는 경우 가속을 비활성화하는 것이 좋습니다.

일반 모니터, AI 지능형 모니터 또는 AI 모니터를 생성하거나 편집할 때 감지 구성 마지막에서 가속 방식을 선택할 수 있으며, 저장 후 이후 감지에 사용됩니다.

구성 방식 적용 규칙
워크스페이스 구성 따르기(기본값) 관리 > 워크스페이스 설정 > 모니터 스트리밍 집계 가속의 현재 설정을 사용합니다. 워크스페이스 구성을 변경하고 저장하면 기존 모니터는 이후 감지에서 자동으로 이를 따르며, 개별적으로 다시 저장할 필요가 없습니다.
개별 구성 현재 모니터에 대해 독립적으로 활성화하거나 비활성화하며, 워크스페이스 구성보다 우선합니다. 예를 들어 워크스페이스에서 비활성화한 경우에도 개별적으로 활성화한 모니터는 자동 전략에 따라 계속 조회됩니다.

워크스페이스 구성을 따르는 모니터를 다른 워크스페이스로 가져오면 대상 워크스페이스의 현재 설정을 사용합니다.

가속을 비활성화하면 조회 시간이 증가할 수 있습니다. 이 설정은 감지 조회 경로만 제어하며, 과거 데이터가 이후 업데이트될 때 알림 값과 사후 재조회 결과 사이에 여전히 차이가 있을 수 있습니다.

이벤트 알림

모니터가 트리거될 때 생성되는 이벤트 제목, 내용, 알림 멤버 및 연결 처리를 정의합니다.

이벤트 제목

알림 트리거 조건의 이벤트 이름을 정의합니다. 미리 설정된 템플릿 변수를 사용할 수 있습니다.

주의

최신 버전에서는 이벤트 제목을 입력한 후 모니터 이름이 동기적으로 생성됩니다. 기존 모니터에서는 모니터 이름과 이벤트 제목이 일치하지 않는 경우가 있을 수 있으므로 최신 버전으로 동기화하는 것이 좋습니다.

이벤트 내용

이벤트 알림 내용을 작성합니다. 트리거 조건을 충족하면 시스템이 해당 내용을 외부로 전송합니다. 일반적으로 다음 정보를 포함합니다:

  • Markdown 형식의 본문
  • 연결 링크 및 템플릿 변수를 삽입할 수 있습니다.
  • 고급 구성을 기반으로 관련 로그 또는 오류 정보를 추가합니다.
  • 이벤트 내용을 전송할 대상 알림 멤버입니다.

이벤트 내용은 구문 검사 및 템플릿 미리보기를 지원하므로 저장 전에 변수 및 조건 분기의 렌더링 결과를 확인할 수 있습니다.

+ 링크를 클릭하면 시스템이 현재 감지 지표를 기반으로 이동 링크를 자동 생성합니다. 링크 주소에는 현재 도메인, 워크스페이스 ID, 감지 시간 범위({{df_check_range_start}} ~ {{df_check_range_end}}) 및 동적 필터 조건이 포함됩니다.

링크 유형 설명 구성 요구 사항
사용자 지정 링크 임의의 URL을 지원하며 템플릿 변수를 사용할 수 있습니다 전체 링크 주소를 수동으로 입력해야 합니다
관련 로그 보기 로그 탐색기로 이동합니다 자동 생성되며, 삽입 후 필터 조건과 시간 범위를 조정할 수 있습니다
관련 트레이스 보기 트레이스 탐색기로 이동합니다 자동 생성되며, 현재 trace_id 또는 서비스 이름을 자동으로 연결합니다
관련 프로파일 보기 프로파일 탐색기로 이동합니다 자동 생성되며, 서비스 이름과 시간 범위를 자동으로 채웁니다
관련 컨테이너 보기 컨테이너 객체 상세로 이동합니다 자동 생성되며, 컨테이너 이름과 호스트 태그를 자동으로 일치시킵니다
관련 Pod 보기 Pod 객체 상세로 이동합니다 자동 생성되며, Pod 이름과 네임스페이스를 자동으로 채웁니다
관련 프로세스 보기 프로세스 객체 상세로 이동합니다 자동 생성되며, 호스트와 프로세스 이름을 자동으로 일치시킵니다
관련 Session 보기 RUM 세션 리플레이로 이동합니다 자동 생성되며, Session ID를 자동으로 채웁니다
관련 View 보기 RUM View 탐색기로 이동합니다 자동 생성되며, 뷰 경로를 자동으로 채웁니다
관련 Error 보기 RUM Error 탐색기로 이동합니다 자동 생성되며, 오류 유형과 시간 범위를 자동으로 채웁니다
관련 Resource 보기 RUM Resource 탐색기로 이동합니다 자동 생성되며, 리소스 경로를 자동으로 채웁니다
관련 신서틱 모니터링 보기 신서틱 테스트 상세로 이동합니다 자동 생성되며, 신서틱 테스트 이름을 자동으로 연결합니다
관련 대시보드 보기 지정된 대시보드로 이동합니다 대시보드 ID 및 이름을 수동으로 보완해야 하며, 뷰 변수와 시간 범위를 조정할 수 있습니다

링크 형식 예시:

로그 탐색기: [관련 로그 보기](<{{STUDIO_CONSOLE_BASE_URL}}/logIndi/log/all?time={{df_check_range_start}},{{df_check_range_end}}&w={{df_workspace_uuid}}>)

트레이스 탐색기: [관련 트레이스 보기](<{{STUDIO_CONSOLE_BASE_URL}}/tracing/link/all?time={{df_check_range_start}},{{df_check_range_end}}&w={{df_workspace_uuid}}>)

템플릿 변수

+ 변수를 클릭하여 미리 설정된 템플릿 변수를 삽입합니다. 변수는 이벤트 트리거 시 실제 값으로 동적으로 대체됩니다:

변수 설명
{{df_dimension}} 감지 차원 객체
{{df_monitor_checker_name}} 현재 모니터 이름
{{df_monitor_name}} 소속 알림 정책 이름
{{Result}} 감지 결과 값
{{df_status}} 이벤트 상태 (error/warning/ok)
{{df_event_id}} 이벤트 고유 식별자

지원되는 전체 템플릿 변수를 확인하려면 클릭하세요.

고급 구성

‘고급 구성’을 통해 DQL로 이벤트에 관련 데이터 컨텍스트를 포함할 수 있습니다.

1. 관련 로그 추가

클릭하면 다음 템플릿이 자동 생성됩니다:

{% set dql_data = DQL("L::RE(`.*`):(`message`) { `index` = 'default' } LIMIT 1") %}
{{ dql_data.message | limit_lines(10) }}

구성 포인트:

  • {index= 'default' }를 실제 인덱스 이름으로 교체해야 합니다

  • RE(``.*``)는 정규식 일치를 지원합니다. 예: RE(``error\|exception``)

  • limit_lines(10)은 출력 줄 수를 제한하여 알림이 너무 길어지지 않도록 합니다

2. 관련 오류 스택 추가

클릭하면 다음 템플릿이 자동 생성됩니다:

{% set dql_data = DQL("T::re(`.*`):(`error_message`,`error_stack`){ (`source` NOT IN ['service_map', 'tracing_stat', 'service_list_1m', 'service_list_1d', 'service_list_1h', 'profile']) AND (`error_stack` = exists()) } LIMIT 1") %}
{{ dql_data.error_message | limit_lines(10) }}
{{ dql_data.error_stack | limit_lines(10) }}

구성 포인트:

  • source NOT IN [...]는 통계 유형 집계 데이터를 제외하고 원본 트레이스만 유지합니다

  • (error_stack= exists())는 스택 정보가 포함된 오류가 반환되도록 보장합니다

알림 멤버(@)

클릭하여 워크스페이스 멤버를 선택합니다.

적용 논리:

  1. 인시던트 연결이 활성화된 경우에만 @ 멤버 구성이 적용되며, 지정된 멤버에게 여기의 이벤트 내용을 전송합니다.
  2. 이 구성은 알림 구성의 알림 대상과 서로 독립적이며, 알림 범위에 영향을 주지 않습니다.
사용자 지정 알림 내용

기본적으로 시스템은 이벤트 내용을 알림 내용으로 사용합니다. 실제로 외부로 전송되는 알림을 사용자 지정해야 하는 경우, 여기에서 스위치를 활성화하고 알림 정보를 입력할 수 있습니다.

  • 독립 편집기가 펼쳐지며, 외부로 전송할 알림 내용을 별도로 정의할 수 있습니다.
  • 원본 이벤트 내용은 플랫폼 내에 그대로 유지되어 이벤트 상세 표시에 사용됩니다.
  • 독립 편집기에서도 Markdown, 템플릿 변수, 연결 링크 및 고급 구성을 지원합니다.

데이터 단절 이벤트

즉, 데이터 단절(데이터 보고 없음) 시의 알림 내용을 사용자 지정합니다. 해당 유형 이벤트가 최종적으로 외부에 전송될 때의 제목, 내용 등의 정보를 함께 구성할 수 있습니다.

사용자 지정 구성이 없으면 시스템은 공식 기본 템플릿을 사용하여 단절 알림을 전송합니다.

사용자 지정 데이터 단절 이벤트 내용도 구문 검사 및 템플릿 미리보기를 지원하며, 미리보기에는 현재 입력한 데이터 단절 제목과 내용이 사용됩니다.

인시던트 연결

연결을 활성화하면 해당 모니터에서 이상 이벤트가 발생할 때 인시던트가 동기적으로 생성됩니다.

구성 항목
  1. 자동 생성된 인시던트에 태그를 추가하여 인시던트 센터에서 분류 및 필터링할 수 있도록 합니다.
  2. 이벤트 등급과 인시던트 등급의 매핑 관계를 구성하며, 여러 규칙을 추가할 수 있습니다.

    • 치명적/심각/중요/경고/데이터 단절 등급 이벤트가 발생할 때 새 인시던트 등급 P0/P1/P2/P3/... 을 동기적으로 생성합니다.

여기에서 생성된 인시던트는 인시던트 센터에서 확인할 수 있습니다(❗️이 유형의 인시던트에는 태그 필터 조건이 포함됩니다).

연동 메커니즘
  1. 이벤트가 트리거되면 인시던트 센터에 인시던트 기록이 자동 생성되며, 인시던트 설명에 이벤트 내용이 자동으로 동기화됩니다.
  2. 이벤트 내용의 @ 멤버 목록에 따라 인시던트 추가 알림을 전송합니다.
  3. 인시던트 센터에서 인시던트 상세를 확인할 수 있으며, 시스템이 해당 인시던트와 관련된 전체 트레이스 데이터(성능 지표, 오류 로그, 호출 트레이스, 인프라 토폴로지 등)를 자동으로 연결하여 표시합니다.

알림 구성

모니터가 트리거 조건을 충족하면 즉시 지정된 알림 대상에게 알림 메시지를 전송합니다.

알림 정책

이미 생성된 알림 정책을 선택하며, 다중 선택을 지원합니다. 정책 이름을 클릭하면 상세를 펼쳐 볼 수 있고, 알림 정책 편집을 클릭하면 구성을 수정할 수 있습니다:

구성 항목 설명
알림 구성 해당 정책에 바인딩된 알림 대상 그룹(예: 전체 등)을 표시합니다
반복 알림 동일한 이벤트에 대해 지정된 시간(예: 10분) 내에 중복 알림을 전송하지 않습니다
알림 집계 집계 방식(예: AI 집계)입니다
집계 주기 지정된 시간(예: 5분) 내의 신규 이벤트를 하나의 알림으로 집계하여 전송하며, 주기가 지난 후의 신규 이벤트는 새로운 알림으로 집계됩니다

연결

이미 생성된 대시보드를 선택하여 모니터와 대시보드의 연결 관계를 설정함으로써 빠르게 이동하고 모니터링 데이터를 시각적으로 확인할 수 있습니다.

권한

모니터의 작업 권한을 설정하여 서로 다른 사용자가 자신의 역할과 권한 수준에 맞는 작업을 수행하도록 보장합니다. 현재 워크스페이스의 Owner는 여기의 작업 권한 구성에 영향을 받지 않습니다.

  • 이 구성을 활성화하지 않음: ‘모니터 구성 관리’의 기본 권한을 따릅니다.
  • 이 구성을 활성화하고 사용자 지정 권한 대상을 선택함: 생성자와 권한이 부여된 대상만 해당 모니터에 설정된 규칙을 활성화/비활성화, 편집, 삭제할 수 있습니다.
  • 이 구성을 활성화했지만 사용자 지정 권한 대상을 선택하지 않음: 생성자만 해당 모니터의 활성화/비활성화, 편집, 삭제 권한을 가집니다.

또한 워크스페이스 Owner는 통합 권한 구성 관리를 통해 관리자, 역할 또는 멤버에게 모니터 작업 권한을 일괄 부여할 수 있습니다. 권한이 부여된 대상은 사용자 지정 작업 권한이 활성화된 모든 모니터를 운영할 수 있으며, 각 모니터의 사용자 지정 권한 대상에 일일이 추가할 필요가 없습니다.

즉시 감지 트리거

규칙 구성을 완료한 후 즉시 감지 트리거를 클릭하면 테스트를 한 번 수동으로 실행하여 현재 규칙 구성의 전체적인 효과를 검증할 수 있습니다. 테스트 실행은 실제 알림을 생성하지 않습니다.

알림 캐시 보호 메커니즘

구성을 완료하면 모니터 실행 중 다음 보호 정책이 적용됩니다. 시스템은 다음 메커니즘을 통해 고카디널리티 집계로 인해 과도한 감지 객체가 생성되어 시스템 부하가 발생하는 것을 방지합니다:

단계 트리거 조건 시스템 동작
임계값 사전 경고 감지 객체 수가 시스템 제한의 80%(80,000개)에 도달 시스템 알림 트리거(하루 최대 1회), 조회 조건 및 그룹 설정 확인 권장
한도 초과 보호 감지 객체 수가 시스템 상한 100,000개에 도달 모니터를 자동으로 일시 중지하고 알림 전송, 일시 중지 기간에는 실행 중지

알림 캐시 상한은 100,000건이며, 사전 경고 비율은 80%입니다.

일시 중지 복구 메커니즘

모니터가 알림 캐시 한도 초과로 시스템에 의해 일시 중지된 후, 다음 작업 중 하나를 수행하면 자동으로 복구됩니다:

  • 조회 조건을 수정하고 모니터를 다시 저장

  • 모니터를 바로 다시 저장

시스템이 알림 캐시 표시를 자동으로 정리하고 모니터를 정상적으로 실행하도록 복구하므로 추가 작업이 필요하지 않습니다.

추가 읽기

모니터 규칙이 성공적으로 생성된 후 다음 항목이 필요할 수 있습니다:

문서 평가

이 페이지가 도움이 되었나요?