이벤트 설정
이벤트 설정을 통해 URL 상태 변화나 응답 이상 등 다양한 조건에 따라 경고 또는 알림을 발생시킬 수 있습니다.
사용에 따라 두 가지 설정 방법 중 하나를 선택해 이벤트를 설정할 수 있습니다.
- 메트릭스 이벤트
- 복합 메트릭스 이벤트
메트릭스 이벤트
-
Alert > Event configuration > Metrics 섹션 오른쪽에 Add Alert Policy 버튼을 클릭하세요.
-
Metrics event 화면에서 정보를 입력해 알림을 설정합니다.

기본 정보 입력
-
Event name(필수): 추가하려는 이벤트 이름을 입력하세요.
-
Activate events: 이벤트를 활성화 여부를 선택하세요.
-
Templates: 제공하는 템플릿을 선택하면 카테고리, 레벨, 메시지가 미리 정의된 내용으로 간편하게 설정됩니다. 직접 설정하고 싶다면 사용 안 함을 선택하세요.
- URL PRO 제공 템플릿 목록
- Status code error: URL 상태 코드가 200 이상인 경우 경고 알림을 보냅니다.
- Connection delay: URL 연결 시간이 5초 이상 소요되면 경고 알림을 보냅니다.
- Title change detection: 웹 페이지의 타이틀이 변경된 경우 경고 알림을 보냅니다.
- Page connection changed: URL 최종 연결 페이지가 변경된 경우 경고 알림을 보냅니다.
- Page connection impossible: 페이지에 접속할 수 없는 경우 경고 알림을 보냅니다.
- URL PRO 제공 템플릿 목록
-
Category(필수): 메트릭 데이터를 구분하는 단위로, 카테고리의 키 값으로 단위를 설정합니다.
-
Category 선택 목록에는
Name,
데이터 수집 간격,
Key 정보를 표시합니다. 이벤트 설정 시 해당 카테고리의 키 값을 사용합니다.
-
Category 선택 목록에 수집 간격이 표시되지 않는 경우 Enter it yourself를 선택한 후, 입력창에 카테고리 키를 입력합니다.
-
-
URL 카테고리 목록: [하단 카테고리 안내]
alert_count각 URL 또는 시스템 요소에 대해 발생한 알림 횟수를 집계한 데이터alert_event알림이 발생한 시점의 상세 데이터url_checkURL 체크 결과와 세부 상태를 시간 단위 데이터url_stat_all전체 URL 상태 통계url_stat_category카테고리별 URL 상태 통계url_stat_issue이슈별 URL 상태 통계url_statusURL 상태 기록 (알림 및 장애 판단 기준)
카테고리 목록은 최근 3시간 범위 내 프로젝트 에서 수집 중인 메트릭스 데이터를 조회해 표시합니다. 수집된 메트릭스 데이터가 없다면 목록에 표시하지 않습니다.
-
Level
-
이벤트 발생 시 경고 수준을 나타냅니다. Critical, Warning, Info 수준으로 나뉘어집니다. Critical, Warning 레벨 설정 시 'Additional notifications when the event state is resolved.' 선택 옵션이 활성화됩니다.
-
Additional notifications when the event state is resolved.
- 이벤트 발생 조건이 해제되면 해당 이벤트의 상태가 해소된 것으로 간주합니다.
- 이 경우 "RECOVERED@" 이벤트를 추가로 발생시켜 상태 해소를 알립니다.
-
-
Message
- 이벤트 발생 시 알림 메시지로 표현됩니다.
${Tag}또는${Field}입력으로 메시지에 변수를 적용할 수 있습니다. 변수에 입력할 키는 선택한 메트릭스 데이터 Category에 포함된 값이여야 합니다. - 우측
버튼을 클릭하면 이전에 입력한 메시지 기록을 확인할 수 있습니다.
- 이벤트 발생 시 알림 메시지로 표현됩니다.
-
Test alert
필수 항목인 Event name, Category, Level, Message 정보를 기준으로 알림을 발생시켜 메시지를 점검하는 기능입니다.
발생 조건 & 대상 설정
이벤트 발생 조건과 대상 필터링은 ‘선택 입력’ 또는 ‘직접 입력’ 모드 중 하나를 라디오 버튼으로 선택할 수 있습니다.
설정 내용을 저장하면 해당 값은 ‘직접 입력’ 모드로 관리됩니다.
저장 후 ‘선택 입력’ 모드로 다시 전환하면 기존 설정 값이 초기화될 수 있으므로 주의하세요.
-
Event rule

필드,
연산자 선택,
임계값을 입력해 이벤트 발생 조건을 설정합니다.
-
Filtering event targets

이벤트 대상,
연산자 선택,
필터링값을 입력해 대상을 필터링합니다. 입력값이 없을 경우 전체 에이전트를 대상으로 경고 알림을 보냅니다.
이벤트 수신 설정
-
Number of event: 선택한 시간 동안 Event rule에서 설정한 이벤트가 입력 횟수만큼 발생하면 경고 알림을 보냅니다.
Note- 선택 시간을 Disabled으로 설정하면 입력한 횟수만큼 연속 발생할 때 알림을 보냅니다.
- Additional notifications when the event state is resolved. 옵션을 활성화한 경우 선택 시간은 Disabled으로 선택할 것을 권장합니다.
- Category 옵션에서 선택한 항목의 수집 주기는 5초입니다.
-
Event pause: 과도한 경고 알림 발생을 방지할 수 있는 옵션입니다. 첫번째 경고 알림 이후 선택한 시간 동안 경고 알림을 보내지 않습니다. 또한 Event history 메뉴에 기록되지 않습니다.
-
Event operation time: 이벤트 동작 시간 태그를 설정하면 해당 태그를 가진 알림은 해당 시간대에만 이벤트가 동작합니다.
-
Event reception tag: 이벤트 설정 시, 수신 태그를 선택하면 해당 태그가 지정된 프로젝트 멤버와 3rd-party 플러그인에 알림이 전송됩니다.
- 알림을 받을 멤버별로 수신 태그를 지정할 수 있으며, 이 설정은 이벤트 수신 설정 메뉴에서 관리합니다.
알림 규칙 테스트

선택한 시간 동안 설정한 이벤트 조건을 실행해 몇 번의 경고 알림이 발생했는지 확인할 수 있습니다. RUN 버튼을 선택하면 오른쪽 상단에 알림 발생 건수 정보가 표시됩니다.Event rule에서 선택한 필드와 임계치를 차트상에 표시합니다.
- Testing event rules 기능은 최대 24시간 동안의 데이터를 기준으로 테스트할 수 있습니다.
복합 메트릭스 이벤트
Composite metrics 이벤트는 메트릭스 데이터에 여러 규칙을 적용하여 이벤트를 생성하고 경고 알림을 전송하는 기능입니다. 이 기능을 사용하려면 이벤트 설정 권한이 필요합니다.
-
Event configuration > Composite metrics 섹션 오른쪽에 Add Alert Policy를 클릭하세요.
-
Composite metrics 창이 열리면 +Creating as a chart를 클릭하세요.
-
이벤트 설정 창이 표시됩니다.
- 왼쪽: 알림 설정 영역
- 오른쪽: 이벤트 데이터 조회 영역
먼저 오른쪽 이벤트 데이터 조회 영역에서 이벤트 데이터를 확인한 뒤, 왼쪽 알림 설정 영역에서 이벤트 발생 조건을 지정합니다.

이벤트 데이터 조회
이벤트 데이터 조회 기능은 이벤트 발생 조건을 정의하기 전에 데이터 추이를 확인하고,
어떤 메트릭을 대상으로 어느 수준의 수치에서 알림을 발생시킬지 판단할 수 있도록 합니다.
Composite metrics 이벤트는 WhaTap 메트릭 데이터 질의 언어(MXQL)을 기반으로 조건을 생성합니다.
조건 입력 방식은 두 가지입니다.
-
Widget: UI 옵션을 통해 조건을 시각적으로 선택하면 MXQL 쿼리가 자동으로 생성
-
Text: MXQL 쿼리를 직접 작성하거나 편집
- 위젯
- 텍스트
위젯 방식을 사용하면 MXQL을 직접 작성하지 않고, 제공되는 옵션을 순서대로 선택하여 조회 조건을 설정할 수 있습니다.
-
Category: 서비스별 데이터 카테고리를 제공하고 있습니다. URL 모니터링의 데이터 카테고리 항목입니다. [하단 카테고리 안내]
alert_count각 URL 또는 시스템 요소에 대해 발생한 알림 횟수를 집계한 데이터alert_event알림이 발생한 시점의 상세 데이터url_checkURL 체크 결과와 세부 상태를 시간 단위 데이터url_stat_all전체 URL 상태 통계url_stat_category카테고리별 URL 상태 통계url_stat_issue이슈별 URL 상태 통계url_statusURL 상태 기록 (알림 및 장애 판단 기준)
-
Filter: 이벤트 대상을 지정합니다. 연산식, 필터링 대상, 필터링 값을 입력해 필터링 조건을 생성합니다.
-
Group by: 그룹화된 메트릭스 데이터를 선택합니다. 다중 선택할 수 있습니다.
-
Time unit: 그룹화된 데이터를 나눌 시간 기준을 설정합니다. (sec, Minutes, Hour 단위 지원)
-
Field: 이벤트 발행 조건에 사용할 필드를 선택합니다. 다중 선택할 수 있습니다.
MXQL을 평문 그대로 수정할 수 있는 편집창이 나타납니다.

설정을 완료하면 시계열 차트와 데이터가 표시되며, 선택한 필드명이 왼쪽 이벤트 발생 조건에 태그 형태로 추가됩니다. 차트로 데이터 추이를 확인한 뒤 이벤트 조건을 설정할 때 참고합니다.
알림
경고 알림 설정의 기본 정보를 입력합니다.
-
Activate events: 토글 버튼을 클릭해 이벤트를 활성활 여부를 선택할 수 있습니다.
-
Level: 위험(Critical), 경고(Warning), 정보 수준 중 하나의 레벨을 선택하세요.
Additional notifications when the event state is resolved.: 이벤트 항목 중 발생한 Additional notifications when the event state is resolved. 송신 여부를 선택할 수 있습니다. 토글 버튼을 선택해 기능을 켜거나 끌 수 있습니다.
-
Title: 경고 알림의 제목을 입력하세요.
-
Message: 이벤트 발생 시 출력하는 알림 메시지를 입력합니다.
${Tag}또는${Field}입력으로 메시지에 변수를 적용할 수 있습니다. 변수에 입력할 키는 선택한 메트릭스 데이터 Category에 포함된 값이여야 합니다. Metrics Search 메뉴에서 입력할 수 있는 태그 또는 필드키를 확인할 수 있습니다.
이벤트 발행 조건
경고 알림을 보낼 조건을 입력합니다.
-
Time Range: 이벤트 조건에 사용할 MXQL의 실시간 데이터 조회 범위를 설정합니다. 이벤트 데이터 조회에 포함된 필드만 사용할 수 있습니다.
데이터 조회 범위를 5분으로 선택하면 최근 5분동안 수집된 데이터를 조회해서 이벤트 발생 조건을 확인합니다. 최근 데이터에 대해서 이벤트를 설정할 때에는 짧게, 넓은 시간에 대해서 통계적으로 접근하고 싶을 때에는 길게 설정할 수 있습니다.
-
Condition: MXQL에 반영한 필드와 연산 규칙, 임계치를 입력합니다.
부가 정보
경고 알림 수신과 관련한 부가적인 옵션을 설 정합니다.
-
Interval: 선택한 시간 간격으로 알림 조건을 확인합니다.
-
Silent: 과도한 경고 알림 발생을 방지할 수 있는 옵션입니다. 첫번째 경고 알림 이후 선택한 시간 동안 경고 알림을 보내지 않습니다. 또한 Event history 메뉴에 기록되지 않습니다.
-
Event operation time: 이벤트 동작 시간 태그를 설정하면 해당 태그를 가진 알림은 해당 시간대에만 이벤트가 동작합니다.
-
Event reception tag: 이벤트 수신 태그를 선택하면 해당 태그를 가진 프로젝트 멤버와 3rd-party 플러그인에 알림을 전송할 수 있습니다. 이벤트 수신 태그를 선택하지 않으면 프로젝트 전체 멤버에게 경고 알림을 보냅니다.
NoteAlert > Notification setting 메뉴에서 프로젝트 멤버와 3rd-party 플러그인에 태그를 설정할 수 있습니다.
이벤트 규칙 테스트

선택한 시간 동안 설정한 이벤트 조건을 실행해 몇 번의 경고 알림이 발생했는지 확인할 수 있습니다. 실행 버튼을 선택하면 알림 발생 건수 정보를 알 수 있으며, 이벤트 발생 조건에서 선택한 필드와 임계치를 차트상에 표시합니다.
이벤트 설정에 포함된 대부분의 내용들이 MXQL을 사용해서 지정됩니다. MXQL이 적절하게 작성되었는지 시뮬레이션할 수 있는 기능을 제공합니다. 시뮬레이션 기능은 과거의 24시간 데이터를 조회해서 이벤트 판정을 한 다음 몇 건의 메트릭스가 조회되었고 그 중 몇 건에서 이벤트 판정이 성공했는지 알려줍니다.
메트릭스 이벤트 수정 및 삭제
-
Alert > Event configuration 메뉴로 이동한 다음 Metrics 탭을 선택하세요.
-
이벤트 목록에서 수정 또는 삭제하려는 항목의 가장 오른쪽에
버튼을 선택하세요.
-
메트릭스 또는 복합 메트릭스 이벤트 설정 창이 나타나면 각 옵션을 수정한 다음 Save 버튼을 선택하세요.
선택한 이벤트를 삭제하려면 이벤트 설정 창의 오른쪽 위에
Delete 버튼을 선택하세요.
발생 조건, 대상 선택 가이드
메트릭스 경고 알림의 이벤트 발생 조건과 이벤트 대상 선택은 동일한 문법을 사용합니다. 단, 이벤트 발생 조건은 필드(Field)의 Key를 변수로 사용하고, 이벤트 대상 선택은 태그(Tag)의 Key를 변수로 사용합니다.
기본 문법
-
문자열을 그냥 입력하면 변수, 작은 따옴표('') 또는 큰 따옴표("")로 감싸면 text로 인식합니다.
oid == "oid"1. oid : 변수
2. == : 함수
3. "oid" : text// oname가 ott-1235일 경우
// 정상적인 경우
onname = 'ott-1235' 또는 onname = "ott-1235"
// 비정상적인 경우, 알림이 동작하지 않습니다.
onname = ott-1235 -
숫자를 그냥 입력하면 number, 작은 따옴표('') 또는 큰 따옴표("")로 감싸면 text로 인식합니다.
oid == 1231. oid : 변수
2. == : 함수
3. 123 : number// oid가 123일 경우
// 정상적인 경우
oid = 123
// 비정상적인 경우, 알림이 동작하지 않습니다.
id == '123' 또는 oid == "123"
사용 가능한 연산자 목록
| 연산자 | 사용법 | 설명 |
|---|---|---|
== | operand1 == operand2 | operand1과 operand2의 값이 동일한지 확인합니다. |
!= | operand1 != operand2 | operand1과 operand2의 값이 다른지 확인합니다. |
> | operand1 > operand2 | operand1의 값이 operand2의 값보다 큰지 확인합니다. |
>= | operand1 >= operand2 | operand1의 값이 operand2의 값보다 큰거나 같은지 확인합니다. |
< | operand1 < operand2 | operand1의 값이 operand2의 값보다 작은지 확인합니다. |
<= | operand1 <= operand2 | operand1의 값이 operand2의 값보다 작거나 같은지 확인합니다. |
like | operand1 like operand2 | operand1에 operand2가 포함되어 있는 지를 패턴으로 검색합니다. |
&& | expression1 && expression2 | expression1과 expression2이 모두 true인지 확인합니다. |
and | expression1 and expression2 | expression1과 expression2이 모두 true인지 확인합니다.&&와 동일한 역할을 수행하는 연산자입니다. |
|| | expression1 || expression2 | expression1 또는 expression2이 true인지 확인합니다. |
or | expression1 or expression2 | expression1 또는 expression2이 true인지 확인합니다.||와 동일한 역할을 수행하는 연산자입니다. |
like 사용법
와일드카드(*)를 통해 포함 문자열을 편리하게 검색할 수 있습니다.
-
특정 키워드로 시작하는 문자열 검색
Key like "Value*" -
특정 키워드로 끝나는 문자열 검색
Key like "*Value" -
특정 키워드가 포함된 문자열 검색
Key like "*Value*" -
키워드 중간에 와일드카드(
*)를 사용할 수 없습니다.
// 지원하지 않는 문법
Key like "Va*lue" -
like연산자에서 와일드카드(*)를 생략하는 경우 equals(==)로 동작합니다.
// 아래의 두 문장은 완전히 같은 결과를 가집니다.
Key like "Value"
Key == "Value"
사용 가능한 함수 목록
| 함수 | 사용법 | 설명 |
|---|---|---|
| startsWith | startsWith(param1, param2) | param1을 Key로 하는 Value가 param2로 시작하면 true, 반대의 경우 false |
| endsWith | endsWith(param1, param2) | param1을 Key로 하는 Value가 param2로 끝나면 true, 반대의 경우 false |
| isNull | isNull(param1) | param1이 null이면 true, 반대의 경우 false |
| isNotNull | isNotNull(param1) | param1이 null이 아니면 true, 반대의 경우 false |
| isEmpty | isEmpty(param1) | param1이 null 또는 EmptyString("")이면 true, 반대의 경우 false |
| isNotEmpty | isNotEmpty(param1) | param1이 null도 아니고 EmptyString("")도 아니면 true, 반대의 경우 false |
startsWith
startsWith(Key, "Value")
endsWith
endsWith(Key, "Value")
isNull
isNull(Key)
isNotNull
isNotNull(Key)
isEmpty
isEmpty(Key)
isNotEmpty
isNotEmpty(Key)