exemONE 알람 설정
개요
Settings > Alert > User Alert는 사용자가 직접 룰 조건을 설정하여 임계치 기반 알람을 구성하는 화면이며, Settings > Alert > System Alert는 시스템이 자동으로 감지하는 고정 알람(연결 끊김, 상태 이상 등)을 관리하는 화면입니다.
1. Settings > Alert > User Alert
기본 뷰 화면 설명
설정 위치: Settings > Alert > User Alert
| 순번 | 항목 | 설명 |
|---|---|---|
| 1 | Alert Group | Alert Group 목록을 보여줍니다. |
| 2 | Rule List | Rule 목록을 보여줍니다. |
상세 기능 설명
1-1. Alert 유형 (User Alert)
User Alert은 아래 세 가지 유형으로 구성됩니다.
| 유형 | 설명 |
|---|---|
| Metric | 사용자가 정의한 메트릭 기반 알람. 임계치(Warning/Critical)를 초과하면 알람 발생 |
| Event | 사용자가 정의한 이벤트 기반 알람. Syslog, SNMP Trap, Logging 유형 지원 |
| Table | Table 유형 데이터에서 특정 컬럼을 대상으로 알람 발생 |
1-2. Table 타입 알람 등록 방법
설정 위치: Settings > Alert > User Alert > Create Rule
| 단계 | 내용 |
|---|---|
| 1 | Type = Table 선택. Check Interval은 1분 이상, Check Hold Time은 10분 이상 설정 필요 |
| 2 | Stat Name > Stat Setting에서 모니터링할 지표 선택 |
| 3 | Target > Target Setting에서 모니터링 대상 서버 선택 |
| 4 | Column Name 선택 후 임계치(Boolean 또는 정수) 설정 |
| 5 | Additional Alert Condition: Filter Columns(AND/OR 조건), Display Columns 설정 |
Table 알람 지원 지표 목록
| 지표명 | 비고 |
|---|---|
| MySQL Parameter Change Log | mysql parameter 수집주기 1시간 설정 필요 |
| MySQL Tablespace | - |
| Oracle Parameter Change Log | - |
| Oracle Tablespace | - |
| Postgresql Parameter Change Log | - |
| pg_default Tablespace Size | - |
| pg_global Tablespace Size | - |
| infra_filesystem_stat | - |
주의: Parameter Change Log 알람의 경우, Check Interval 1시간, Check Hold Time 0초 설정 필요
1-3. Alert 파라미터 (User Alert Metric)
| 파라미터 | 설명 |
|---|---|
$alert$trigger_time$ | 알람 발생 시각 |
$alert$rule_name$ | 사용자 정의 룰 이름 |
$alert$targets$ | 알람 발생 대상 |
$alert$alert_name$ | 알람 지표 이름 |
$alert$level$ | 알람 레벨 (WARNING / CRITICAL) |
$alert$value$ | 알람 값 (측정된 수치) |
1-4. Alert 파라미터 (User Alert Event)
이벤트 유형에 따라 $alert$alert_name$과 $alert$value$ 형식이 달라집니다.
| 이벤트 유형 | alert_name 형식 | value 형식 |
|---|---|---|
| Syslog | Facility : [값], Severity : [값] | 세팅 시 입력한 Message Text 값 |
| SNMP Trap | Generic Trap Type : [값], Specific Trap Code : [값], Enterprise OID : [값] | 세팅 시 입력한 Message Text 값 |
| Logging | Path_name : [값], Log Type : [값], Path : [값] | Filter : [값], Parser : [값] |
2. Settings > Alert > System Alert
기본 뷰 화면 설명
설정 위치: Settings > Alert > System Alert
System Alert은 사용자가 직접 등록하지 않아도 자동으로 발생하는 고정 알람입니다.
2-1. System Alert 발생 스펙
| 대분류 | 알람 조건 | 판단 근거 |
|---|---|---|
| Infrastructure | Disconnect | 에이전트와 수집서버의 연결 종료 |
| Infrastructure | Unknown | - |
| Network Device | Icmp check | ICMP 응답하지 않는 경우 |
| Network Device | Up/Down | 네트워크 인터페이스의 연결 해제된 경우 |
| Kubernetes | Warning Event | 수집된 이벤트 데이터의 Involved Object가 해당 노드이고 Type이 Warning인 경우 |
| Kubernetes | Not Ready | 수집된 해당 노드 데이터의 conditions에 Ready가 없을 경우 |
| Kubernetes | Not Schedulable | 수집된 해당 노드 데이터의 conditions에 SchedulingDisabled 혹은 Unschedulable이 포함된 경우 |
| Application | Disconnect | 에이전트와 수집서버의 연결 종료 |
| Application | Out of Memory | Application의 Out of Memory 이벤트 발생 |
| Application | Unknown | - |
| Database | DB Disconnected | 타겟 DB의 연결 확인 |
| Database | Agent Disconnected | Agent ↔ Receiver 연결 확인 |
| Database | Lazy Query Execution | 타겟 DB에 대한 수집 쿼리 지연 |
| Cloud | Cloud Disconnected | 대상 연결 확인 |
| Cloud | API Timeout Call | cloud metric 수집 api 응답 지연 |
| Cloud | Agent Disconnected | Agent ↔ Receiver 연결 확인 |
2-2. Alert 파라미터 (System Alert)
| 파라미터 | 설명 |
|---|---|
$alert$trigger_time$ | 알람 발생 시각 |
$alert$rule_name$ | 고정 알람 룰 이름 (시스템 정의 룰명) |
$alert$target$ | 알람 발생 대상 |
$alert$alert_name$ | 시스템 알람 유형 (disconnected, Unknown 등) |
$alert$level$ | 알람 레벨 |
$alert$value$ | 해당 없음 (값 없음) |
3. 부가 기능 - Notification 설정
User Alert 및 System Alert 모두 공통 UI로 Notification 수신 설정이 가능합니다.
3-1. Group Notification Setting
설정 위치: Settings > Alert > System Alert (또는 User Alert) > Group 편집 화면
| 순번 | 항목 | 설명 |
|---|---|---|
| 1 | Alert Level Edit | 알람 레벨을 수정합니다. 설정하지 않으면 기본값(Normal / Warning / Critical)으로 적용됩니다. |
| 2 | Receive Resolved Alert | Critical로 발생한 알람이 정상 상태로 해결된 경우 Normal 알람을 수신합니다. |
| 3 | Notification Channel | 알림 받을 채널을 선택합니다. |
해당 Group 내의 모든 타겟에 Notification이 적용됩니다. 단, 타겟에 Isolated Sending이 활성화된 경우, Group의 Notification이 적용되지 않습니다.
3-2. Custom Notification Setting
설정 위치: Settings > Alert > System Alert (또는 User Alert) > 타겟 리스트 > Custom Notification 편집 화면
| 순번 | 항목 | 설명 |
|---|---|---|
| 1 | Isolated Sending | 개별 알림 활성화 여부를 선택합니다. |
| 2 | Alert Level Edit | 알람 레벨을 수정합니다. 설정하지 않으면 기본값(Normal / Warning / Critical)으로 적용됩니다. |
| 3 | Receive Resolved Alert | Critical로 발생한 알람이 정상 상태로 해결된 경우 Normal 알람을 수신합니다. |
| 4 | Notification Channel | 알림 받을 채널을 선택합니다. |
Isolated Sending이 활성화된 경우에만 Custom Notification 설정이 적용됩니다. Isolated Sending이 비활성화된 경우, Group Notification이 적용됩니다.
3-3. Notification Channel 종류 및 옵션
지원되는 Notification Channel은 다음과 같습니다.
Email (SMTP/NCP)
| 순번 | 항목 | 설명 |
|---|---|---|
| 1 | Server Type | 알림 발송 서버 선택 (SMTP / NCP) |
| 2 | Server Name | 서버 이름 입력 |
| 3 | User Group | 알림 수신 그룹 선택 |
| 4 | User ID | 사용자 ID 선택 |
| 5 | Title | 제목 입력 (최대 100바이트) |
| 6 | Message | 메시지 입력 (최대 1,000바이트) |
| 7 | Parameter | 파라미터 안내 ($alert$trigger_time$, $alert$rule_name$, $alert$targets$, $alert$alert_name$, $alert$level$, $alert$value$) |
| 8 | Sample Form | 발송 결과 예시 |
Slack
| 순번 | 항목 | 설명 |
|---|---|---|
| 1 | Slack | 수신 받을 슬랙 채널 선택 |
| 2 | Title | 제목 입력 (최대 100바이트) |
| 3 | Message | 메시지 입력 (최대 1,000바이트) |
| 4 | Parameter | 파라미터 안내 |
| 5 | Sample Form | 발송 결과 예시 |
Telegram
| 순번 | 항목 | 설명 |
|---|---|---|
| 1 | Telegram | 수신 받을 텔레그램 계정 선택 |
| 2 | Title | 제목 입력 (최대 100바이트) |
| 3 | Message | 메시지 입력 (최대 1,000바이트) |
| 4 | Parameter | 파라미터 안내 |
| 5 | Sample Form | 발송 결과 예시 |
Messaging (SMS-DB/NCP)
| 순번 | 항목 | 설명 |
|---|---|---|
| 1 | Server Type | 알림 발송 서버 선택 (SMS-DB / NCP) |
| 2 | Server Name | 서버 이름 입력 |
| 3 | User Group | 알림 수신 그룹 선택 |
| 4 | User ID | 사용자 ID 선택 |
| 5 | Write Content | 내용 입력 (최대 90바이트) |
| 6 | Notification Insert Query Check | SMS-DB 설정 쿼리 확인. 쿼리 수정은 환경설정 > 알림 관리 > SMS-DB에서 가능 |
| 7 | Sample Form | 발송 결과 예시 |
Webhook
| 순번 | 항목 | 설명 |
|---|---|---|
| 1 | Webhook | 수신 받을 웹훅 주소 선택 |
| 2 | Title | 제목 입력 (최대 100바이트) |
| 3 | Message | 메시지 입력 (최대 1,000바이트) |
| 4 | Parameter | 파라미터 안내 |
| 5 | Sample Form | 발송 결과 예시 |
On-Site
| 순번 | 항목 | 설명 |
|---|---|---|
| 1 | User Group | 알림 수신 그룹 선택 |
| 2 | User ID | 사용자 ID 선택 |
| 3 | Title | 제목 입력 (최대 100바이트) |
| 4 | Message | 메시지 입력 (최대 1,000바이트) |
| 5 | Parameter | 파라미터 안내 |
| 6 | Sample Form | 발송 결과 예시 |
KakaoTalk (NCP)
| 순번 | 항목 | 설명 |
|---|---|---|
| 1 | Server Type | 알림 발송 서버 선택 (NCP) |
| 2 | Server Name | 서버 이름 입력 |
| 3 | User Group | 알림 수신 그룹 선택 |
| 4 | User ID | 사용자 ID 선택 |
| 5 | Title | 제목 입력 (최대 100바이트) |
| 6 | Message | 메시지 입력 (최대 200바이트) |
| 7 | Parameter | 파라미터 안내 |
| 8 | Sample Form | 발송 결과 예시 |
4. 주의사항 / 참고
| 항목 | 내용 |
|---|---|
| 파라미터 형식 | 모든 파라미터는 $alert$파라미터명$ 형식 사용 |
| 대소문자 | 파라미터명은 소문자 사용 |
| System Alert value | System Alert의 경우 value 값 없음 |
| Isolated Sending | 활성화된 경우에만 Custom Notification이 적용되며, 비활성화 시 Group Notification이 적용됨 |
| Table 알람 Check Hold Time | 최근 10분 데이터 기준으로 알람 발생하므로 Check Hold Time 10분 이상 설정 필요 |
| Parameter Change Log 알람 | Check Interval 1시간, Check Hold Time 0초 설정 필수 |
| SMS-DB 쿼리 수정 | 환경설정 > 알림 관리 > SMS-DB에서만 가능 |