이상치 탐지

홈 > 프로젝트 선택 > 경고 알림 > 이벤트 설정 > 이상치 탐지 탭

이상치 탐지는 메트릭스 데이터가 평소와 다르게 오르내리는 패턴을 찾아 이벤트를 발생시키는 기능입니다. 정상 범위를 자동으로 학습하는 방식과 민감도를 직접 정하는 방식 중에서 골라 설정할 수 있습니다.

화면 구성

이상치 탐지 탭은 Automatic Baseline과 Adaptive Range 두 섹션으로 구성되며, 섹션마다 이상치를 판정하는 방식이 다릅니다.

Section	Description
Automatic Baseline	과거 데이터의 시간대·요일 패턴을 학습해 정상 범위를 자동으로 설정. 사용자는 대상과 발생 조건만 지정
Adaptive Range	지표별로 정한 민감도(민감·보통·둔감)를 기준으로 정상 범위를 조정. 사용자가 카테고리·필드·필터와 패턴 민감도를 지정

노트

Automatic Baseline은 현재 애플리케이션 모니터링(Java, Node.js, Python, PHP, .NET, Go)에서만 제공합니다.

이상치 탐지 이벤트는 상태 기반으로 동작합니다. 이상을 감지하면 발생 알림을 보내고, 정상으로 돌아오면 해소 알림을 보냅니다.

기본 옵션

• 검색: 이벤트 이름 또는 이벤트 수신 태그를 선택해 원하는 이벤트 검색

• 이벤트 추가: 새로운 이상치 탐지 이벤트 추가

• 접기: 섹션을 접거나 펼침

Automatic Baseline 목록

섹션 제목 오른쪽의 대상은 현재 설정한 대상 수와 프로젝트에서 설정할 수 있는 최대 대상 수를 표시합니다(예: 대상 2/20). 비활성화한 규칙도 대상 수에 포함됩니다. 대상 수가 최대에 이르면 쓰지 않는 규칙을 삭제하세요.

Item	Description
No.	목록 순번
활성화	규칙 동작 여부를 전환하는 토글. 꺼도 규칙은 삭제되지 않음
	규칙 수정
이벤트 이름	규칙 이름
범위	규칙을 적용하는 단위(프로젝트·에이전트·에이전트 종류)
레벨	발생 조건을 설정한 알림 레벨(위험·경고·정보)
대상	범위가 에이전트 또는 에이전트 종류일 때 선택한 대상. 프로젝트 범위는 -
무음	이벤트가 발생한 뒤 같은 이벤트를 다시 발생시키지 않는 시간
수신 태그	알림을 받을 수신 태그. 지정하지 않으면 전체 수신
	규칙 삭제

프로젝트 범위 규칙은 템플릿마다 한 행이 목록에 항상 표시됩니다. 규칙을 설정하지 않은 행의 토글을 켜면 기본 조건(위험 레벨, 3회 연속 발생)으로 규칙이 만들어집니다. 프로젝트 행의 규칙을 삭제하면 행은 남고 설정만 초기화됩니다.

Adaptive Range 목록

Item	Description
No.	목록 순번
활성화	규칙 동작 여부를 전환하는 토글. 끄면 조건을 검사하지 않음
	규칙 수정
이벤트 이름	규칙 이름
레벨	이벤트의 중요도(위험·경고·정보)
카테고리	이상치를 감지할 메트릭스 카테고리
필드	이상치를 감지할 지표(메트릭스 필드)
필터	이상치 탐지 대상 데이터의 범위를 제한하는 조건
상승/하락 패턴	상승 패턴과 하락 패턴의 민감도
	규칙 삭제

이벤트 설정

이상치 탐지 이벤트는 섹션별로 추가합니다. Automatic Baseline은 템플릿과 대상을 고르고 발생 조건만 정하면 됩니다. Adaptive Range는 카테고리·필드와 패턴 민감도를 직접 지정합니다.

Automatic Baseline 규칙 추가

1. Automatic Baseline 섹션 오른쪽 위의 [ 이벤트 추가 ] 버튼을 클릭하세요.

2. Automatic Baseline 창에서 이벤트 대상 선택, 기본 정보 및 수신 설정, 시뮬레이션을 차례로 설정하세요.

3. [ 저장 ] 버튼을 클릭하세요.

이벤트 대상 선택

1. 범위 드롭다운에서 에이전트 또는 에이전트 종류를 선택하세요.

2. 대상 드롭다운에서 이벤트를 적용할 대상을 선택하세요. 여러 개를 선택할 수 있습니다.

프로젝트 전체에 적용하는 규칙은 이벤트 추가 대신 목록의 프로젝트 행에서 설정합니다. 프로젝트 행의 아이콘을 클릭하세요.

기본 정보 및 수신 설정

1. 이벤트 활성화 토글로 규칙의 동작 여부를 정하세요.

2. 템플릿 드롭다운에서 탐지할 지표 템플릿을 선택하세요. 현재 에러율 템플릿(Error Rate Anomaly)을 제공합니다. 템플릿은 규칙을 만든 뒤에는 바꿀 수 없습니다.

3. 이벤트명과 메시지를 입력하세요. 메시지에 변수를 넣으면 이벤트 발생 시점의 실제 값으로 바뀝니다.

   노트

   사용 가능 변수

   • ${metricValuePer}: 에러율(%)
   • ${metricThresholdPer}: 기준선(%)
   • ${errorCount}: 에러 건수
   • ${txCount}: 요청 수
   • ${runLength}: 연속 발생 횟수

   템플릿마다 쓸 수 있는 변수는 메시지 입력란 옆의 사용 가능한 변수 툴팁에서 확인하세요.

4. 발생 횟수에서 레벨(위험·경고·정보)별 발생 조건을 설정하세요. 판정은 5분 단위로 하며, 다음 두 방식 중 하나를 고를 수 있습니다.

   • 연속을 선택하면 이상 판정이 n회 연속될 때 이벤트가 발생합니다. n은 1에서 288 사이로 입력합니다.
   • 최근을 선택하면 지정한 시간 동안 이상 판정이 n회 나올 때 이벤트가 발생합니다. 시간은 5분에서 24시간 사이에서 고르며, n × 5분보다 짧게 설정할 수 없습니다.

   레벨마다 조건을 하나씩, 최대 세 개 설정할 수 있고 하나 이상은 켜 두어야 합니다. 기본값은 위험 레벨 3회 연속(약 15분)입니다.

5. 무음 드롭다운에서 이벤트가 발생한 뒤 같은 이벤트를 다시 발생시키지 않을 시간을 선택하세요.

6. 수신 태그와 이벤트 동작 시간을 설정하세요. 설정 방법은 이벤트 수신 태그와 이벤트 동작 시간을 참고하세요.

시뮬레이션

조건을 설정한 뒤 [ 시뮬레이션 ] 버튼을 클릭하면, 과거 데이터에 조건을 적용했을 때의 알림 예상 건수를 확인할 수 있습니다. 차트에는 에러율, 정상 범위에서 임계치까지의 밴드, 이벤트 발생 구간을 함께 표시합니다. 조회 기간은 최대 30일입니다.

Adaptive Range 규칙 추가

1. Adaptive Range 섹션 오른쪽 위의 [ 이벤트 추가 ] 버튼을 클릭하세요.

2. 이벤트 기본 정보, 메트릭스, 이상치 탐지, 부가정보를 차례로 설정하세요.

이벤트 기본 정보

1. 이벤트 레벨(Critical, Warning, Info)을 선택하세요.

   • 이벤트의 중요도와 알림 레벨이 결정됩니다.

2. 이벤트 발생 시 전달받을 알림 메시지를 입력하세요.

   • 메시지에 변수를 사용하여 이벤트 발생 시점의 실제 값을 포함할 수 있습니다.
   노트

   사용 가능 변수

   • $pcode: 프로젝트 코드
   • $category: 카테고리
   • $field: 필드
   • $value: 발생값
   • $oname: 이벤트 대상

메트릭스

1. 카테고리를 선택하세요.

   • 이상치를 감지할 메트릭스 데이터의 기준이 되는 카테고리입니다.

2. 이벤트 발생 조건에 사용할 필드를 선택하세요. 다중 선택할 수 있습니다.

3. 이벤트 대상을 필터링할 이벤트 조건 대상인 필터를 선택하세요. 다중 선택할 수 있습니다.

이상치 탐지

1. 상승 패턴과 하락 패턴의 민감도를 선택하세요.

2. 각 패턴의 토글 버튼을 클릭해 켜거나 끌 수 있습니다.

   • 상승 패턴만 감지하고 싶은 경우: 상승 패턴 ON, 하락 패턴 OFF

   • 하락 패턴만 감지하고 싶은 경우: 하락 패턴 ON, 상승 패턴 OFF

부가 정보

이벤트 동작 시간

이벤트가 특정 시간대(근무/비근무/점검 시간 등)에 동작하도록 태그를 설정하세요. 태그를 설정하지 않으면 이벤트가 활성화된 상태에서 24시간 상시 동작합니다.

1. + 추가를 클릭하세요.

2. 이벤트 동작 시간에서 +새로운 태그 생성을 클릭하세요.

3. 이벤트 동작 시간 태그 생성에서 태그 이름, 요일, 시간, 색상을 선택하고 [ 적용 ] 버튼을 클릭하세요.

4. 생성한 태그는 태그 목록에서 확인할 수 있으며, 체크 박스를 선택하면 적용됩니다.

5. 수정 또는 삭제할 태그의 아이콘을 클릭해 이벤트 동작 시간 태그 수정에서 태그를 수정하거나 삭제할 수 있습니다.

주의

태그 삭제 시 해당 태그가 적용된 모든 사용자의 태그가 삭제됩니다. 단, 이벤트 규칙에서 사용 중인 태그는 삭제할 수 없습니다.

이벤트 수신 태그

이벤트 수신 태그를 설정하면, 해당 태그를 가진 프로젝트 멤버에게 알림을 전송합니다. 수신 태그를 설정하지 않으면 프로젝트 내 모든 사용자에게 알림이 전송됩니다.

1. + 태그 추가 또는 +를 클릭하세요.

2. 이벤트 수신 태그 창 아래의 + 새 태그 생성을 클릭하세요.

3. 태그 생성 창에서 태그 이름을 입력하고, 색상을 선택한 후, [ 태그 생성 ] 버튼을 클릭해 태그를 생성하세요.

4. 생성된 태그는 태그 목록의 아이콘을 클릭해 수정 또는 삭제하세요.

5. 이벤트 수신 태그 창의 태그 목록에서 원하는 태그를 선택하면 적용됩니다.

팁

이벤트 설정 시 이벤트 수신 태그를 선택하여 해당 태그를 가진 프로젝트 멤버와 3rd-party 플러그인에 알림을 전송할 수 있습니다. 경고 알림 > 이벤트 수신 설정에서 프로젝트 멤버와 3rd-party 플러그인에 각각 태그를 지정할 수 있습니다.

이벤트 수정

1. 경고 알림 > 이벤트 설정의 이상치 탐지 탭으로 이동하세요.

2. 수정할 규칙 행의 아이콘을 클릭하세요.

3. 설정 창에서 옵션을 수정하고 [ 저장 ] 버튼을 클릭하세요.

Automatic Baseline 규칙은 템플릿을 제외한 범위·대상·발생 조건 등을 수정할 수 있습니다.

이벤트 삭제

1. 경고 알림 > 이벤트 설정의 이상치 탐지 탭으로 이동하세요.

2. 삭제할 규칙 행의 아이콘을 클릭하세요.

3. 삭제 확인 창에서 [ 삭제 ] 버튼을 클릭하세요.