메트릭스 경고 알림

홈 화면 > 프로젝트 선택 > 사이트맵 > 경고 알림 > 이벤트 설정

메트릭스를 기반으로 한 이벤트 알림을 생성하고 관리하는 방법을 안내합니다. 메트릭스 이벤트는 기본 템플릿보다 구체적이고 복잡한 이벤트를 설정할 때 사용합니다. 모니터링 대상에서 발생하는 다양한 이벤트를 조건에 따라 정의하고, 이를 통해 효율적으로 알림을 받을 수 있도록 설정할 수 있는 기능을 제공합니다.

노트

메트릭스에 대한 자세한 내용은 다음 문서를 참조하세요.
알림 설정 권한이 있는 멤버만 이용할 수 있습니다. 멤버 권한에 대한 자세한 설명은 다음 문서를 참조하세요.

기본 화면 안내

이벤트 설정 메뉴에서 메트릭스 탭을 선택하세요. 사용자가 추가한 메트릭스 이벤트 목록을 확인하고, 메트릭스 이벤트를 추가하거나 수정, 삭제할 수 있습니다.

Event configuration

메트릭스 이벤트 목록의 주요 요소는 다음과 같습니다.

활성화: 각 이벤트의 활성화 여부를 제어하는 토글 버튼입니다. 원하는 이벤트의 알림을 켜거나 끌 수 있습니다.
수정: 이벤트 규칙을 수정할 수 있습니다. 규칙을 업데이트하여 더 정확한 알림을 설정할 수 있습니다.
이벤트 이름: 이벤트 이름입니다. 이벤트 이름을 통해 어떤 이벤트가 발생했는지 쉽게 구분할 수 있습니다. 이벤트가 발생하고 알림을 받으면 해당 메시지의 제목으로 표시됩니다.
규칙: 알림을 발생시키기 위한 이벤트 조건입니다. 각 색상은 Critical과 Warning 레벨을 의미합니다.
대상: 전체 또는 특정 모니터링 대상에서 발생하는 이벤트를 기준으로 알림을 수신할 수 있습니다.
발생 횟수: 설정한 시간 동안, 설정 횟수만큼 이벤트가 발생하면 알림을 수신합니다.
해소된 알림: Critical과 Warning 레벨의 이벤트가 정상 상태(RECOVERED)로 돌아올 때 알림 수신 여부를 나타냅니다.
이벤트 수신: 알림을 수신할 팀이나 사용자 그룹을 나타냅니다.

노트

알림 메시지 설정 기능에 대한 자세한 내용은 다음 문서를 참조하세요.
메트릭스 이벤트를 JSON 파일로 수정하거나 공유할 수 있습니다. 자세한 내용은 다음 문서를 참조하세요.
JSON 파일을 통해 전체 이벤트 설정을 공유할 수 있는 JSON 일괄 수정 및 JSON 일괄 다운로드 기능에 대한 자세한 내용은 다음 문서를 참조하세요.

이벤트 추가하기

메트릭스 이벤트를 추가하려면 화면 오른쪽 위에 이벤트 추가 버튼을 선택하세요. 이벤트 추가 화면이 나타나면 사용자는 다음 단계에 따라 설정을 진행할 수 있습니다.

이벤트 조건 정의: 알림을 받기 위한 이벤트 조건을 설정합니다.
이벤트 대상 선택: 이벤트가 발생하는 모니터링 대상을 선택합니다.
기본 정보 및 수신 설정: 이벤트 이름 및 메시지, 수신 대상을 설정합니다.

메트릭스 검색하기

이벤트 설정 시, 메트릭스 정보를 쉽게 검색하고 활용할 수 있습니다.

카테고리 선택, 지표 설정, 이벤트 대상 선택 항목에서 메트릭스 검색기로 메트릭스를 검색하고 메트릭스 정보를 확인하세요. 선택한 메트릭스가 화면에 적용됩니다.

이벤트 조건 정의

알림을 받기 위한 이벤트 조건을 설정할 수 있습니다.

템플릿

쉽고 빠른 이벤트 설정을 위해 모니터링 플랫폼에 맞춘 이벤트 템플릿을 제공합니다. 원하는 템플릿을 선택하면 사전 정의된 이벤트 조건을 나머지 항목에 자동 입력합니다. 템플릿을 사용하지 않는다면 사용 안 함을 선택하세요.

노트

템플릿을 선택한 후 사전 정의된 이벤트 조건은 사용자가 직접 수정할 수 있습니다.
모니터링 플랫폼에 따라 제공하는 템플릿은 다를 수 있습니다. 제공하는 템플릿 목록에 대한 자세한 내용은 다음 문서를 참조하세요.

카테고리 선택

메트릭스 데이터를 구분하는 단위입니다. 이벤트 조건 정의를 위한 필수 항목입니다.

Select Category

카테고리 선택 목록에는 이름과 데이터 수집 간격(1시간, 5분 등), 키 정보를 표시합니다. 최근 3시간 범위 내 프로젝트에서 수집 중인 메트릭스 데이터를 조회해 목록에 표시합니다. 카테고리 선택 목록에 카테고리 이름이 표시되지 않는다면 직접 입력하기 옵션을 선택해 카테고리 키를 입력할 수 있습니다.

노트

카테고리 항목을 선택해야 지표 설정을 진행할 수 있습니다.
카테고리 정보는 분석 > 메트릭스 조회 메뉴에서 확인할 수 있습니다.

지표 설정

알림 레벨을 선택하고, 알림을 발생시킬 이벤트의 임계치를 설정할 수 있습니다. 하나의 규칙에서 여러 레벨(Critical, Warning, Info)를 설정할 수 있습니다. 효과적인 모니터링을 위해 동일한 지표에 대해 단계별 임계치를 설정하는 것을 권장합니다.

Indicator settings

알림 레벨 수준은 위험(Critical)과 경고(Warning), 정상(Info) 수준으로 구분합니다. 설정된 레벨은 우선순위에 따라 동작합니다.

팁
레벨 동작 방식에 대한 자세한 내용은 레벨 동작 가이드를 참고하세요.
선택한 카테고리에 포함된 지표를 선택한 뒤, 조건을 입력해 모니터링 기준을 설정하세요. 산술 연산, 비교 연산, 논리 연산 등을 조합해 원하는 조건식을 구성할 수 있습니다.

팁
조건식 작성 방식 및 사용 가능한 연산자는 조건 설정 가이드를 참고하세요.

발생 횟수

선택한 시간 동안 설정한 이벤트가 입력 횟수만큼 발생하면 알림을 보냅니다.

Count of event

연속: 입력한 횟수만큼 이벤트가 연속 발생할 때 알림을 받을 수 있습니다.
최근: 선택한 시간동안 입력한 횟수만큼 이벤트가 연속 발생할 때 알림을 받을 수 있습니다.

노트

Interval 값은 선택한 카테고리의 데이터 수집 간격을 의미합니다.

일시 중지

과도한 경고 알림 발생을 방지할 수 있는 옵션입니다. 첫번째 알림 발생 이후 선택한 시간 동안 경고 알림을 보내지 않습니다.

Pause alert

노트

해소된 알림 기능을 활성화했다면 정상(RECOVERED) 상태 알림을 수신 후 선택한 시간 동안 알림을 보내지 않습니다.

해소된 알림

해소된 알림 옵션을 활성화하면 이벤트 기록 메뉴에서 진행 중인 이벤트로 표시됩니다. Critical 또는 Warning 레벨의 이벤트가 해소되면 정상(RECOVERED) 상태의 알림을 수신합니다. 토글 버튼을 선택해 기능을 켜거나 끌 수 있습니다.

Resolved notification

노트

이 옵션은 알림 레벨 수준을 Critical 또는 Warning을 선택했을 때 표시됩니다.
이벤트 기록 메뉴에 대한 자세한 내용은 다음 문서를 참조하세요.

시뮬레이션

지표 설정에서 설정한 이벤트 조건을 테스트할 수 있습니다. 시뮬레이션 버튼을 선택하세요.

Simulation

조회한 시간 동안 몇 번의 알림이 발생했는지 오른쪽 상단에 발생 건수를 표시합니다.
빨간색 점선은 지표 설정에서 설정한 결과입니다.

노트

지표 설정에 대한 자세한 내용은 다음 문서를 참조하세요.
시뮬레이션 기능은 최대 24시간 동안의 데이터를 기준으로 테스트할 수 있습니다.

이벤트 대상 선택

이벤트가 발생하는 모니터링 대상을 선택하세요. 입력하지 않을 경우 프로젝트에 포함된 전체를 대상으로 이벤트를 감시하고 알림을 보냅니다. 이로 인해 많은 알림이 발생할 수 있습니다. 과도한 알림이 발생하지 않도록 특정 대상을 설정하세요.

Select target

이벤트 대상은 다음 태그(Tag)를 기준으로 특정할 수 있습니다. 태그(Tag)는 수집 대상을 구분할 수 있는 고유 정보를 포함하는 데이터입니다. 변경 이력이 적은 IP, Oname, Host 정보 등의 값을 활용할 수 있습니다.

선택 입력: 태그 이름과 연산자를 선택하고 값을 입력해 대상을 특정할 수 있습니다.

추가: 이벤트 대상을 추가할 수 있습니다. &&(and) 또는 ||(or) 조건을 선택할 수 있습니다.
직접 입력: 태그 이름과 연산자, 값을 직접 입력해 대상을 특정할 수 있습니다. 이 옵션을 선택하면 입력란 아래에 입력할 수 있는 태그 정보(태그 선택 입력)를 제공합니다.

팁

다음 예시를 참조해 이벤트 대상을 설정하세요.

ex. endsWith(okindName, 'example_name') && container == 'prod.billing'
ex. ${4xxErrorType} == '401'

노트

이벤트 조건 정의 섹션의 카테고리 선택에서 선택한 값에 따라 선택할 수 있는 태그는 다를 수 있습니다.
이벤트 대상을 변했다면 알림 발생 건수가 달라질 수 있습니다. 시뮬레이션 버튼을 다시 실행해 결과를 확인하세요.
이벤트 대상 선택 및 연산자 사용에 대한 자세한 내용은 다음 문서를 참고하세요

기본 정보 및 수신 설정

이벤트 이름 및 메시지, 알림 수신 대상을 설정하세요.

Basic information

이벤트 활성화: 현재 이벤트를 활성화할 수 있습니다.
이벤트 이름: 알림 메시지의 제목으로 사용되며 식별하기 쉬운 이름으로 입력하세요.
메시지: 사용자에게 전달하는 알림 메시지의 내용을 입력하세요. 변수를 사용하여 동적 데이터를 포함할 수 있습니다.
- ${Tag} 또는 ${Field} 입력으로 메시지에 변수를 적용할 수 있습니다. 변수는 선택한 메트릭스 데이터 카테고리에 포함된 값이여야 합니다. 메트릭스 조회 메뉴에서 입력할 수 있는 ${Tag} 또는 ${Field} 변수를 확인할 수 있습니다.
- 버튼을 클릭하면 이전에 입력한 메시지 기록을 확인할 수 있습니다.
팁
메시지 입력 창에 ${Tag} 또는 ${Field} 변수를 입력해 메시지를 작성할 수 있습니다.
분석 > 메트릭스 조회 메뉴에서 카테고리를 선택한 다음 입력할 수 있는 ${Tag} 또는 ${Field} 변수를 확인하세요. 현재 이벤트 템플릿의 카테고리 이름은 다음 문서의 카테고리 항목을 참조하세요.

노트
메시지로 입력할 수 있는 ${Tag} 또는 ${Field} 변수는 다음 문서를 참고하세요.
수신 테스트: 현재 이벤트로 발생하는 알림 수신 시 입력한 이벤트 이름과 메시지를 사전 점검할 수 있습니다. 필수 항목(지표 설정, 이벤트 이름, 메시지)을 모두 입력해야 테스트할 수 있습니다.
노트
- 테스트 중에는 실제 메트릭스 값이나 변수에 대한 치환 기능이 작동하지 않습니다.
- 이벤트 수신 옵션에서 수신자 태그가 설정된 사용자에게만 테스트 알림을 보냅니다. 전체 수신을 선택했다면 모든 사용자에게 테스트 알림을 보냅니다.
- 이 기능을 이용하려면 필수 항목(*)에 값을 입력하거나 선택하세요.
이벤트 수신: 현재 이벤트로 발생하는 알림을 수신할 멤버를 선택할 수 있습니다.
- 전체 수신: 프로젝트에 소속된 멤버 전원에게 알림을 보냅니다.
- 태그 선택 수신: 선택한 태그를 가진 프로젝트 멤버와 3rd-party 플러그인에 알림을 보냅니다. 수신 태그 항목이 표시되면 태그 추가 또는 버튼을 클릭해 태그 목록에서 원하는 태그를 선택하세요.
노트
경고 알림 > 이벤트 수신 설정 메뉴에서 프로젝트 멤버와 3rd-party 플러그인에 태그를 설정할 수 있습니다. 자세한 내용은 다음 문서를 참조하세요.

이벤트 수정/삭제하기

경고 알림 > 이벤트 설정 메뉴로 이동한 다음 메트릭스 탭을 선택하세요.
이벤트 목록에서 수정 또는 삭제하려는 항목의 가장 왼쪽에 버튼을 선택하세요.
메트릭스 이벤트 설정 창이 나타나면 각 옵션을 수정한 다음 저장 버튼을 선택하세요.

선택한 이벤트를 삭제하려면 이벤트 설정 창의 오른쪽 위에 삭제 버튼을 선택하세요.

JSON 형식으로 수정하기

메트릭스 이벤트 설정을 JSON 형식으로 수정할 수 있습니다.

화면 오른쪽 위에 JSON 버튼을 선택하세요.
편집 창이 나타나면 JSON 형식에 맞춰 내용을 수정하세요.
수정을 완료하면 화면 오른쪽 위에 저장 버튼을 선택하세요.

노트

수정한 내용이 JSON 형식에 맞지 않으면 화면 아래에 에러 메시지가 표시되며, 저장할 수 없습니다. 표시되는 에러 메시지는 형식에 따라 다를 수 있습니다.

JSON error

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"
oid : 변수
== : 함수
"oid" : text

// oname가 ott-1235일 경우

// 정상적인 경우
onname = 'ott-1235' 또는 onname = "ott-1235"

// 비정상적인 경우, 알림이 동작하지 않습니다.
onname = ott-1235

숫자를 그냥 입력하면 number, 작은 따옴표('') 또는 큰 따옴표("")로 감싸면 text로 인식합니다.

oid == 123
oid : 변수
== : 함수
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)

템플릿

사용자가 손쉽게 경고 알림을 설정할 수 있도록 메트릭스 이벤트에 대한 템플릿을 제공합니다.

메트릭스 이벤트 템플릿

경고 알림 > 이벤트 설정 > 메트릭스 탭에서 메트릭스 섹션의 + 이벤트 추가 버튼을 선택하세요. 템플릿 옵션에서 원하는 항목을 선택하세요. 다음은 선택할 수 있는 템플릿 목록입니다.

노트

선택한 템플릿의 이벤트 발생 조건은 사용자가 직접 수정할 수 있습니다.

CPU 사용률 _Warning
조건: cpu(xos) > 70

개별 인스턴스에서 CPU 사용률이 70%를 초과하면 Warning(경고) 수준의 알림을 보냅니다.
메모리 사용량 _Warning
조건: mem(xos) > 70

개별 인스턴스에서 메모리 사용량이 70%를 초과하면 Warning(경고) 수준의 알림을 보냅니다.

Active Session_Warning

조건: active_sessions > 30

개별 인스턴스에서 활성화 중인 세션 수가 30개를 초과하면 Warning(경고) 수준의 알림을 보냅니다.
Lock Wait_Warning

조건: lock_wait_sessions > 3

개별 인스턴스에서 대기 중인 세션 수가 3개를 초과하면 Warning(경고) 수준의 알림을 보냅니다.
Long Query_Warning

조건: long_running_sessions > 3

개별 인스턴스에서 장시간 수행 중인 세션 수가 3개를 초과하면 Warning(경고) 수준의 알림을 보냅니다.

Connection 사용률 _Warning
조건: (total_sessions / max_connections * 100) > 90

개별 인스턴스에서 장시간 실행 중인 쿼리 수가 80%를 초과하면 Warning(경고) 수준의 알림을 보냅니다.
Memory Block Hit율 _Warning
조건: blks_hit_ratio <= 80

개별 인스턴스에서 Memory Block Hit율이 80% 이하인 경우 Warning(경고) 수준의 알림을 보냅니다.
Replication 지연 시간 _Warning
조건: replication_delay >= 10

개별 인스턴스에서 replication 데이터베이스에 반영되는 지연 시간이 10초 이상이면 Warning(경고) 수준의 알림을 보냅니다.

복합 메트릭스 이벤트 템플릿

경고 알림 > 이벤트 설정 > 메트릭스 탭에서 복합 메트릭스 섹션의 + 이벤트 추가 버튼을 선택하세요. 템플릿 옵션에서 원하는 항목을 선택하세요. 다음은 선택할 수 있는 템플릿 목록입니다.

Replication Broken

개별 에이전트의 Replcation 상태가 Broken 또는 Fallover 상태이면 Critical(위험) 수준의 알림을 보냅니다.
장시간 Commit하지 않은 세션
60초 이상 커밋하지 않은 세션이 2개를 초과하면 Warning(경고) 수준의 알림을 보냅니다.

기본 화면 안내​

이벤트 추가하기​

메트릭스 검색하기​

이벤트 조건 정의​

템플릿​

카테고리 선택​

지표 설정​

발생 횟수​

일시 중지​

해소된 알림​

시뮬레이션​

이벤트 대상 선택​

기본 정보 및 수신 설정​

이벤트 수정/삭제하기​

JSON 형식으로 수정하기​

메트릭스 이벤트 공유하기​

내보내기​

가져오기​

이벤트 검색하기​

발생 조건, 대상 선택 가이드​

기본 문법​

사용 가능한 연산자 목록​

like 사용법​

사용 가능한 함수 목록​

startsWith​

endsWith​

isNull​

isNotNull​

isEmpty​

isNotEmpty​

레벨 동작 가이드​

조건 설정 가이드​