메트릭스 경고 알림
홈 화면 > 프로젝트 선택 > 
사이트맵 > 경고 알림 > 이벤트 설정
메트릭스를 기반으로 한 이벤트 알림을 생성하고 관리하는 방법을 안내합니다. 메트릭스 이벤트는 기본 템플릿보다 구체적이고 복잡한 이벤트를 설정할 때 사용합니다. 모니터링 대상에서 발생하는 다양한 이벤트를 조건에 따라 정의하고, 이를 통해 효율적으로 알림을 받을 수 있도록 설정할 수 있는 기능을 제공합니다.
기본 화면 안내
이벤트 설정 메뉴에서 메트릭스 탭을 선택하세요. 사용자가 추가한 메트릭스 이벤트 목록을 확인하고, 메트릭스 이벤트를 추가하거나 수정, 삭제할 수 있습니다.
메트릭스 이벤트 목록의 주요 요소는 다음과 같습니다.
-
활성화: 각 이벤트의 활성화 여부를 제어하는 토글 버튼입니다. 원하는 이벤트의 알림을 켜거나 끌 수 있습니다.
-
수정: 이벤트 규칙을 수정할 수 있습니다. 규칙을 업데이트하여 더 정확한 알림을 설정할 수 있습니다.
-
이벤트 이름: 이벤트 이름입니다. 이벤트 이름을 통해 어떤 이벤트가 발생했는지 쉽게 구분할 수 있습니다. 이벤트가 발생하고 알림을 받으면 해당 메시지의 제목으로 표시됩니다.
-
규칙: 알림을 발생시키기 위한 이벤트 조건입니다. 각 색상은 Critical과 Warning 레벨을 의미합니다.
-
대상: 전체 또는 특정 모니터링 대상에서 발생하는 이벤트를 기준으로 알림을 수신할 수 있습니다.
-
발생 횟수: 설정한 시간 동안, 설정 횟수만큼 이벤트가 발생하면 알림을 수신합니다.
-
해소된 알림: Critical과 Warning 레벨의 이벤트가 정상 상태(RECOVERED)로 돌아올 때 알림 수신 여부를 나타냅니다.
-
이벤트 수신: 알림을 수신할 팀이나 사용자 그룹을 나타냅니다.
이벤트 추가하기
메트릭스 이벤트를 추가하려면 화면 오른쪽 위에 이벤트 추가 버튼을 선택하세요. 이벤트 추가 화면이 나타나면 사용자는 다음 단계에 따라 설정을 진행할 수 있습니다.
-
이벤트 조건 정의: 알림을 받기 위한 이벤트 조건을 설정합니다.
-
이벤트 대상 선택: 이벤트가 발생하는 모니터링 대상을 선택합니다.
-
기본 정보 및 수신 설정: 이벤트 이름 및 메시지, 수신 대상을 설정합니다.
메트릭스 검색하기
이벤트 설정 시, 메트릭스 정보를 쉽게 검색하고 활용할 수 있습니다.
카테고리 선택, 지표 설정, 이벤트 대상 선택 항목에서 메트릭스 검색기로 메트릭스를 검색하고 메트릭스 정보를 확인하세요. 선택한 메트릭스가 화면에 적용됩니다.
이벤트 조건 정의
알림을 받기 위한 이벤트 조건을 설정할 수 있습니다.
템플릿
쉽고 빠른 이벤트 설정을 위해 모니터링 플랫폼에 맞춘 이벤트 템플릿을 제공합니다. 원하는 템플릿을 선택하면 사전 정의된 이벤트 조건을 나머지 항목에 자동 입력합니다. 템플릿을 사용하지 않는다면 사용 안 함을 선택하세요.
-
템플릿을 선택한 후 사전 정의된 이벤트 조건은 사용자가 직접 수정할 수 있습니다.
-
모니터링 플랫폼에 따라 제공하는 템플릿은 다를 수 있습니다. 제공하는 템플릿 목록에 대한 자세한 내용은 다음 문서를 참조하세요.
카테고리 선택
메트릭스 데이터를 구분하는 단위입니다. 이벤트 조건 정의를 위한 필수 항목입니다.
카테고리 선택 목록에는 이름과 데이터 수집 간격(1시간, 5분 등), 키 정보를 표시합니다. 최근 3시간 범위 내 프로젝트에서 수집 중인 메트릭스 데이터를 조회해 목록에 표시합니다. 카테고리 선택 목록에 카테고리 이름이 표시되지 않는다면 직접 입력하기 옵션을 선택해 카테고리 키를 입력할 수 있습니다.
-
카테고리 항목을 선택해야 지표 설정을 진행할 수 있습니다.
-
카테고리 정보는 분석 > 메트릭스 조회 메뉴에서 확인할 수 있습니다.
지표 설정
알림 레벨을 선택하고, 알림을 발생시킬 이벤트의 임계치를 설정할 수 있습니다. 하나의 규칙에서 여러 레벨(Critical, Warning, Info)를 설정할 수 있습니다. 효과적인 모니터링을 위해 동일한 지표에 대해 단계별 임계치를 설정하는 것을 권장합니다.
발생 횟수
선택한 시간 동안 설정한 이벤트가 입력 횟수만큼 발생하면 알림을 보냅니다.
-
연속: 입력한 횟수만큼 이벤트가 연속 발생할 때 알림을 받을 수 있습니다.
-
최근: 선택한 시간동안 입력한 횟수만큼 이벤트가 연속 발생할 때 알림을 받을 수 있습니다.
Interval 값은 선택한 카테고리의 데이터 수집 간격을 의미합니다.
일시 중지
과도한 경고 알림 발생을 방지할 수 있는 옵션입니다. 첫번째 알림 발생 이후 선택한 시간 동안 경고 알림을 보내지 않습니다.
해소된 알림 기능을 활성화했다면 정상(RECOVERED) 상태 알림을 수신 후 선택한 시간 동안 알림을 보내지 않습니다.
해소된 알림
해소된 알림 옵션을 활성화하면 이벤트 기록 메뉴에서 진행 중인 이벤트로 표시됩니다. Critical 또는 Warning 레벨의 이벤트가 해소되면 정상(RECOVERED) 상태의 알림을 수신합니다. 토글 버튼을 선택해 기능을 켜거나 끌 수 있습니다.
-
이 옵션은 알림 레벨 수준을 Critical 또는 Warning을 선택했을 때 표시됩니다.
-
이벤트 기록 메뉴에 대한 자세한 내용은 다음 문서를 참조하세요.
시뮬레이션
지표 설정에서 설정한 이벤트 조건을 테스트할 수 있습니다. 시뮬레이션 버튼을 선택하세요.
-
조회한 시간 동안 몇 번의 알림이 발생했는지 오른쪽 상단에
발생 건수를 표시합니다. -
빨간색 점선은 지표 설정에서 설정한 결과입니다.
-
지표 설정에 대한 자세한 내용은 다음 문서를 참조하세요.
-
시뮬레이션 기능은 최대 24시간 동안의 데이터를 기준으로 테스트할 수 있습니다.
이벤트 대상 선택
이벤트가 발생하는 모니터링 대상을 선택하세요. 입력하지 않을 경우 프로젝트에 포함된 전체를 대상으로 이벤트를 감시하고 알림을 보냅니다. 이로 인해 많은 알림이 발생할 수 있습니다. 과도한 알림이 발생하지 않도록 특정 대상을 설정하세요.
이벤트 대상은 다음 태그(Tag)를 기준으로 특정할 수 있습니다. 태그(Tag)는 수집 대상을 구분할 수 있는 고유 정보를 포함하는 데이터입니다. 변경 이력이 적은 IP, Oname, Host 정보 등의 값을 활용할 수 있습니다.
-
선택 입력: 태그 이름과 연산자를 선택하고 값을 입력해 대상을 특정할 수 있습니다.
추가: 이벤트 대상을 추가할 수 있습니다.
&&(and) 또는||(or) 조건을 선택할 수 있습니다. -
직접 입력: 태그 이름과 연산자, 값을 직접 입력해 대상을 특정할 수 있습니다. 이 옵션을 선택하면 입력란 아래에 입력할 수 있는 태그 정보(태그 선택 입력)를 제공합니다.
다음 예시를 참조해 이벤트 대상을 설정하세요.
ex. endsWith(okindName, 'example_name') && container == 'prod.billing'
ex. ${4xxErrorType} == '401'
-
이벤트 조건 정의 섹션의 카테고리 선택에서 선택한 값에 따라 선택할 수 있는 태그는 다를 수 있습니다.
-
이벤트 대상을 변했다면 알림 발생 건수가 달라질 수 있습니다. 시뮬레이션 버튼을 다시 실행해 결과를 확인하세요.
-
이벤트 대상 선택 및 연산자 사용에 대한 자세한 내용은 다음 문서를 참고하세요
기본 정보 및 수신 설정
이벤트 이름 및 메시지, 알림 수신 대상을 설정하세요.
-
이벤트 활성화: 현재 이벤트를 활성화할 수 있습니다.
-
이벤트 이름: 알림 메시지의 제목으로 사용되며 식별하기 쉬운 이름으로 입력하세요.
-
메시지: 사용자에게 전달하는 알림 메시지의 내용을 입력하세요. 변수를 사용하여 동적 데이터를 포함할 수 있습니다.
-
${Tag}또는${Field}입력으로 메시지에 변수를 적용할 수 있습니다. 변수는 선택한 메트릭스 데이터 카테고리에 포함된 값이여야 합니다. 메트릭스 조회 메뉴에서 입력할 수 있는${Tag}또는${Field}변수를 확인할 수 있습니다. -
버튼을 클릭하면 이전에 입력한 메시지 기록을 확인할 수 있습니다.
팁메시지 입력 창에
${Tag}또는${Field}변수를 입력해 메시지를 작성할 수 있습니다.분석 > 메트릭스 조회 메뉴에서 카테고리를 선택한 다음 입력할 수 있는
${Tag}또는${Field}변수를 확인하세요. 현재 이벤트 템플릿의 카테고리 이름은 다음 문서의 카테고리 항목을 참조하세요.노트메시지로 입력할 수 있는
${Tag}또는${Field}변수는 다음 문서를 참고하세요. -
-
수신 테스트: 현재 이벤트로 발생하는 알림 수신 시 입력한 이벤트 이름과 메시지를 사전 점검할 수 있습니다. 필수 항목(지표 설정, 이벤트 이름, 메시지)을 모두 입력해야 테스트할 수 있습니다.
노트-
테스트 중에는 실제 메트릭스 값이나 변수에 대한 치환 기능이 작동하지 않습니다.
-
이벤트 수신 옵션에서 수신자 태그가 설정된 사용자에게만 테스트 알림을 보냅니다. 전체 수신을 선택했다면 모든 사용자에게 테스트 알림을 보냅니다.
-
이 기능을 이용하려면 필 수 항목(*)에 값을 입력하거나 선택하세요.
-
-
이벤트 수신: 현재 이벤트로 발생하는 알림을 수신할 멤버를 선택할 수 있습니다.
-
전체 수신: 프로젝트에 소속된 멤버 전원에게 알림을 보냅니다.
-
태그 선택 수신: 선택한 태그를 가진 프로젝트 멤버와 3rd-party 플러그인에 알림을 보냅니다. 수신 태그 항목이 표시되면 태그 추가 또는
버튼을 클릭해 태그 목록에서 원하는 태그를 선택하세요.
노트경고 알림 > 이벤트 수신 설정 메뉴에서 프로젝트 멤버와 3rd-party 플러그인에 태그를 설정할 수 있습니다. 자세한 내용은 다음 문서를 참조하세요.
-
이벤트 수정/삭제하기
-
경고 알림 > 이벤트 설정 메뉴로 이동한 다음 메트릭스 탭을 선택하세요.
-
이벤트 목록에서 수정 또는 삭제하려는 항목의 가장 왼쪽에
버튼을 선택하세요. -
메트릭스 이벤트 설정 창이 나타나면 각 옵션을 수정한 다음 저장 버튼을 선택하세요.
선택한 이벤트를 삭제하려면 이벤트 설정 창의 오른쪽 위에 삭제 버튼을 선택하세요.
JSON 형식으로 수정하기
메트릭스 이벤트 설정을 JSON 형식으로 수정할 수 있습니다.
-
화면 오른쪽 위에 JSON
버튼을 선택하세요. -
편집 창이 나타나면 JSON 형식에 맞춰 내용을 수정하세요.
-
수정을 완료하면 화면 오른쪽 위에 저장 버튼을 선택하세요.
수정한 내용이 JSON 형식에 맞지 않으면 화면 아래에 에러 메시지가 표시되며, 저장할 수 없습니다. 표시되는 에러 메시지는 형식에 따라 다를 수 있습니다.
JSON 데이터의 구조는 다음과 같습니다.
[
{
"eventMessage": "APDEX: ${apdex100} > 10 ",
"select": "",
"receiver": [],
"alertLabel": [
"project"
],
"rule": "apdex100 > 10",
"silentSec": 0,
"alertKey": [
"project"
],
"enabled": false,
"eventTitle": "APDEX",
"repeatDuration": 0,
"eventLevelText": "Critical",
"id": "z3f41ge464magg",
"category": "app_counter_project{m5}",
"repeatCount": 0,
"stateful": false
}
]
JSON 데이터의 필드는 이벤트 설정에서 다음 옵션 항목과 연결됩니다.
| JSON 필드 | 옵션 | 분류 |
|---|---|---|
eventMessage | 메시지 | 기본 정보 및 수신 설정 |
select | 대상 선택 > 직접 입력 | 이벤트 대상 선택 |
receiver | 이벤트 수신 > 수신 태그 옵션의 수신 태그 키값 목록 | 기본 정보 및 수신 설정 |
alertLabel | 알림 동작 시 내부적으로 사용하는 primary key 값 | - |
rule | 지표 설정 옵션의 이벤트 조건 | 이벤트 조건 정의 |
silentSec | 일시 중지 | 이벤트 조건 정의 |
alertKey | 알림 동작 시 내부적으로 사용하는 primary key 값 | - |
enabled | 이벤트 활성화 | 기본 정보 및 수신 설정 |
eventTitle | 이벤트 이름 | 기본 정보 및 수신 설정 |
repeatDuration | 발생 횟수 옵션에서 선택한 시간 | 이벤트 조건 정의 |
eventLevelText | 지표 설정 옵션의 이벤트 레벨 수준 | 이벤트 조건 정의 |
id | 해당 이벤트의 고유 식별자 값 | - |
category | 카테고리 선택 | 이벤트 조건 정의 |
repeatCount | 발생 횟수 옵션에서 선택한 횟수 | 이벤트 조건 정의 |
stateful | 해소된 알림 | 이벤트 조건 정의 |
메트릭스 이벤트 공유하기
메트릭스 이벤트 설정을 JSON 파일로 저장해 다른 사용자와 설정을 공유하거나 다른 사용자의 설정을 가져올 수 있습니다.
내보내기
-
화면 오른쪽 위에 JSON
버튼을 선택하세요. -
JSON 편집 창이 나타나면
내보내기 버튼을 선택하세요. -
JSON 파일이 다운로드되면 공유할 다른 사용자에게 전달하세요.
-
JSON 파일 이름은 event-rules-
YYYY-MM-DD.json 형식입니다. -
이벤트를 검색 후 내보내기 기능을 이용하면 검색한 목록만 JSON 파일로 다운받을 수 있습니다.
가져오기
-
화면 오른쪽 위에
버튼을 선택하세요. -
내보내기 기능을 통해 다운로드한 JSON 파일을 선택하세요.
-
JSON 편집 창이 나타나면 목록에 추가하기 또는 덮어쓰기 버튼을 선택하세요.
이 기능은 같은 종류의 제품 간에 이용할 것을 권장합니다. 다른 제품의 프로젝트로부터 이벤트 설정을 가져올 수는 있지만 정상 작동하지 않습니다.
이벤트 검색하기
이벤트 목록에서 이벤트 이름 또는 지표를 기준으로 검색할 수 있습니다. 검색 입력란에 문자열을 입력한 다음 
버튼을 선택하세요.
이벤트를 검색 후 내보내기 기능을 이용하면 검색한 목록만 JSON 파일로 다운받을 수 있습니다. 내보내기 기능에 대한 자세한 내용은 다음 문서를 참조하세요.
발생 조건, 대상 선택 가이드
메트릭스 경고 알림의 이벤트 발생 조건과 이벤트 대상 선택은 동일한 문법을 사용합니다. 단, 이벤트 발생 조건은 필드(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)
레벨 동작 가이드
-
우선순위 기반 이벤트 발생
여러 레벨의 조건을 동시에 충족할 경우, 가장 높은 우선순위의 이벤트만 발생합니다.
예시설정:
- Warning: CPU > 70%
- Critical: CPU > 90%
현재 상태: CPU 95%
→ 결과: Critical 이벤트만 발생 (Warning은 억제됨) -
레벨 상승
진행중인 이벤트에서 낮은 레벨 이벤트가 진행 중일 때 높은 레벨 조건을 충족하면, 두 레벨 모두 진행 중 상태가 됩니다.
예시설정:
- Warning: CPU > 70%
- Critical: CPU > 90%
시나리오:
1) CPU 80% → Warning 발생 (진행 중)
2) CPU 95% → Warning (진행 중), Critical (진행 중) -
레벨 하강
진행중인 이벤트에서 높은 레벨에서 낮은 레벨로 전환되면 높은 레벨은 해소되고 낮은 레벨이 유지됩니다.
예시설정:
- Warning: CPU > 70%
- Critical: CPU > 90%
시나리오:
1) CPU 97% → Critical 발생
2) CPU 85% → Critical 해소, Warning 유지
3) CPU 65% → Warning 해소 -
동작 흐름도
- Warning: CPU > 70%
- Critical: CPU > 90%
메트릭 값: 60% → 75% → 92% → 85% → 60%
상태: 정상 Warning Critical Warning 정상
(발생) (발생) (유지) (해소)
Warning
(유지)
진행 중 상태를 갖는 이벤트는 조건이 충족되는 동안 계속 활성화 상태를 유지하며, 조건이 해제될 때까지 지속됩니다.
조건 설정 가이드
지표명이 숫자로 시작하거나 특수문자가 포함된 경우 ${지표명} 형태로 작성해야 합니다.
- 괄호
(),[] - 연산자
+,-,*,/,% - 구분자
:,@,#,,,(공백) - 기타 특수문자
!,^,&,|,~, ```,=
${} 사용 예시:
${cpu(xos)} > 50
${mem[0]} >= 100
${cpu-usage} > 80
${namespace:cpu} > 70
${metric name} > 60
${4xx_error} > 10
${} 없이 사용 가능: 영문자, 언더스코어(_), 점(.)만 포함된 경우
cpu > 80
cpu_usage > 50
CPUUtilization.Average > 0.8
-
비교 연산자
숫자 비교크다: cpu > 80
크거나 같다: cpu >= 80
작다: memory < 1000
작거나 같다: memory <= 1000
같다: status == 200
같지 않다: error != 0문자열 비교status == 'OK'
region == "us-east-1" -
산술 연산자
- 기본 산술 연산
기본 산술 연산덧셈: cpu + 10 >= 90
뺄셈: memory - 100 >= 500
곱셈: cpu * 2 >= 100
나눗셈: disk / 1024 >= 100
나머지: value % 10 == 0- 괄호를 이용한 우선순위 제어
괄호를 이용한 우선순위 제어(cpu + memory) * 2 >= 200
(disk - used) / total >= 0.2
((cpu + memory) / 2) >= 50- 음수 표현
음수 표현cpu > -100 -
논리 연산자
- AND 연산 (&&)
cpu > 80 && memory > 1000
${cpu(xos)} > 50 && ${mem(xos)} > 60- OR 연산 (||)
cpu > 90 || memory > 90
disk < 10 || network > 1000- 복합 논리 연산
(cpu > 50 && memory > 50) || disk < 20
cpu > 80 && (memory > 1000 || disk > 500) -
패턴 매칭 연산자
- LIKE 연산자
oname like 'prod-*'
url like '*error*'
message like 'WARN%'- NOT LIKE 연산자
oname not like 'test-*'
url not like '*debug*' -
내장 함수
- Null 체크 함수
isNull(value) # null인지 확인
isNotNull(value) # null이 아닌지 확인
nvl(value, 0) # null이면 기본값 반환
isEmpty(str) # 빈 문자열인지 확인
isNotEmpty(str) # 빈 문자열이 아닌지 확인- 집계 함수
sum(cpu, memory, disk) # 합계
avg(cpu, memory) # 평균
max(cpu, memory, disk) # 최대값
min(cpu, memory, disk) # 최소값
count(value1, value2, value3) # 개수- 수학 함수
round(cpu, 2) # 반올림 (소수점 2자리)- 문자열 함수
length(str) # 문자열 길이
startsWith(str, 'prefix') # 접두사 확인
endsWith(str, 'suffix') # 접미사 확인
indexOf(str, 'search') # 문자열 위치
substring(str, 0, 10) # 부분 문자열
trim(str) # 공백 제거
replace(str, 'old', 'new') # 문자열 치환
hasStr(str, 'search') # 문자열 포함 여부-
조건 함수
if: 조건식이 참(
true)이면true값을 반환하고, 거짓(false)이면false값을 반환하는 조건 함수형식if(조건, true값, false값)예시if(value >= 90, 'High', 'Medium') == 'High'decode: 값과 조건을 비교하여 일치하는 조건의 결과를 반환, 없으면 기본값 반환
형식decode(값, 조건1, 결과1, 조건2, 결과2, ..., 조건N, 결과N, 기본값)예시decode(value, 1, 'Low', 2, 'Medium', 3, 'High', 'Unknown') == 'Unknown'in: 값이 지정한 후보값 중 하나와 일치하면
true, 아니면false형식in(값, 후보값1, 후보값2, ..., 후보값N)예시in(status, 200, 201, 204) == false
작성 시 주의사항
-
권장사항
- 간단한 변수명은 $ 없이 사용 (예: cpu, memory)
- 특수문자 포함 시 반드시 $ 사용
- 복잡한 연산은 괄호로 명확하게 구분
- 함수명은 정확히 입력 (대소문자 구분)
-
피해야 할 사항
- 불완전한 표현식 작성 (예: cpu >, memory &&)
- 괄호 미스매칭 (예: (cpu > 80, cpu > 80))
- 연속된 연산자 사용 (예: cpu >> 80, cpu >< 80)
템플릿
메트릭스 이벤트
경고 알림 > 이벤트 설정 > 메트릭스 섹션에서 이벤트 추가 버튼을 선택하세요. 템플릿에서 원하는 항목을 선택하세요.
-
WARNING_OLD_GENARATION_GC
힙 메모리(Heap Memory)의 Old Generation 영역에서 GC가 발생하면 경고 알림을 보냅니다.
-
TOO_SLOW_SQL
수행 중인 쿼리가 5초 이상으로 너무 느린 쿼리가 발생할 경우 경고 알림을 보냅니다.
-
TOO_MANY_ACTX
8초 초과 구간의 액티브 트랜잭션 수가 100개를 초과하면 경고 알림을 보냅니다.
-
APDEX
APDEX 수치가 0.7보다 작을 경우 경고 알림을 보냅니다.
복합 메트릭스 이벤트
-
Inactive agents has been found.
조건:
num_of_current_agents< 6프로젝트에 포함된 모든 에이전트 중 정상 상태의 에이전트 수가 6개 미만으로 떨어지는 이벤트가 발생하면 경고 알림을 보냅니다.
-
Very slow active transactions detected.
조건:
very_slow_tx_cnt_m5_avg> 10프로젝트에 포함된 특정
okind에 속한 에이전트에서 8초 이상 소요되는 트랜잭션의 수의 합이 10개 초과 발생하면 경고 알림을 보냅니다. -
TPS has changed by more than 30% compared to the previous week.
조건:
one_week_diff_abs>current_tps* 0.3프로젝트에 포함된 특정
okind에 속한 에이전트들의 TPS합이 7일 전과 비교했을 때 30% 초과 달라지면 경고 알림을 보냅니다.
여러 에이전트에서 수신된 데이터에 대해서 종합적 이벤트 판정해야할 때 다음의 복합 메트릭스 템플릿을 설정하세요.
- Inactive agents has been found.
- Very slow active transactions detected.
과거 데이터와 현재 데이터를 비교해서 이벤트를 판정해야할 때 다음의 복합 메트릭스 템플릿을 설정하세요.
- TPS has changed by more than 30% compared to the previous week.