이벤트 기록 및 모니터링

홈 > 프로젝트 선택 > 경고 알림 > 이벤트 기록

이벤트 기록은 프로젝트에서 발생한 여러 이벤트를 조회하고 상세 정보를 분석할 수 있습니다. Elasticsearch DSL 쿼리를 지원하며, 원하는 조건에 맞는 이벤트를 정확하고 빠르게 찾을 수 있습니다.

이벤트 기록 조회하기

검색 결과에서 이벤트 제목을 클릭하면 해당 이벤트가 발생한 시간대의 상세 데이터를 분석할 수 있는 화면으로 이동합니다. 이를 통해 이벤트 발생 전후 상황을 종합적으로 파악할 수 있습니다.

경고 알림 > 이벤트 기록으로 이동하세요.
이벤트 기록 화면의 시간 선택에서 이벤트 기록을 조회할 기간을 설정하세요.
필터 입력 창에 쿼리을 입력하고 [ 돋보기 ] 버튼을 클릭하세요.
- 쿼리를 입력하지 않으면 전체 이벤트가 조회됩니다.

컬럼 설정

원하는 컬럼을 표시하거나 숨길 수 있습니다.

이벤트 기록 화면의 왼쪽 위 [ 컬럼 설정 ] 버튼을 클릭하세요.

컬럼 설정 창에서 표시하거나 숨길 컬럼을 선택하세요.

표시 항목에서 컬럼의 순서를 변경할 수 있습니다.
컬럼명 검색창에 원하는 컬럼 항목을 검색할 수 있습니다.

초안

수정 (SERVICE-3347) 에이전트 그룹·노드 설명의 "종류", "서버"를 용어집의 에이전트 식별자 표현으로 맞췄습니다. 컬럼명 "에이전트 명"은 현재 화면 문구라 그대로 두고, 화면이 "에이전트 이름"으로 바뀌면 함께 고칩니다.

컬럼 항목	설명
이벤트 이름	이벤트의 제목
메시지	이벤트의 메시지 또는 스냅샷 정보
이벤트 상태	진행 중, 해소, 처리 중 등. 자세한 내용은 이벤트 상태를 참조하세요
에이전트 명	이벤트가 발생한 대상 에이전트의 이름(Oname) - 특정 에이전트에 대해 발생한 이벤트가 아닌 경우 빈칸으로 표시됨
에이전트 그룹	이벤트가 발생한 대상 에이전트의 에이전트 그룹(OkindName) - 특정 에이전트에 대해 발생한 이벤트가 아닌 경우 빈칸으로 표시됨
에이전트 노드	이벤트가 발생한 대상 에이전트의 에이전트 노드(OnodeName) - 특정 에이전트에 대해 발생한 이벤트가 아닌 경우 빈칸으로 표시됨
이벤트 발생 시각	이벤트가 발생한 시간
이벤트 해소 시각	이벤트가 해소된 시간 상태가 없는 이벤트의 경우 `-`로 표시됨

설정을 완료한 후, [ 확인 ] 버튼을 클릭해 컬럼 설정을 반영합니다.

CSV 다운로드

조회 결과를 CSV 파일 형식으로 다운로드할 수 있습니다.

경고 알림 > 이벤트 기록에서 [ CSV ] 버튼을 클릭하세요.
현재 필터 조건에 맞는 이벤트 목록이 CSV 파일로 저장됩니다.

이벤트 상태

이벤트 상태는 여섯 가지입니다.

상태	설명
진행 중	조건이 아직 정상으로 돌아오지 않은 이벤트
해소	조건이 정상으로 돌아와 닫힌 이벤트
처리 중	처리 내역을 등록한 이벤트
취소	사용자가 이벤트 규칙을 꺼서 되돌린 이벤트
차단	짧은 시간에 알림이 몰려 서버가 자동으로 막은 이벤트
정비 계획	정비 계획 기간에 발생한 이벤트

해소라는 개념이 없는 1회성 이벤트도 있습니다. 서버 재시작이나 특정 로그 1건처럼 정상으로 돌아올 상태가 없는 이벤트이며, 이벤트 기록에서는 별도 라벨 없이 나타납니다.

처리 내역

이벤트에 조치 기록을 남길 수 있습니다. 단순 메모가 아니라 그 이벤트의 알림을 멈추는 동작입니다.

처리 내역을 등록하면 다음이 함께 일어납니다.

작성 시각과 작성자 이메일, 메시지를 이벤트에 기록합니다.
그 이벤트의 알림 발송을 중단합니다.
진행 중이던 상태 기반 이벤트는 상태가 처리 중으로 바뀝니다. 1회성 이벤트는 상태가 바뀌지 않고 알림만 멈춥니다.
진행 중 집계에서 빠집니다. 그 결과 서버와 데이터베이스 인스턴스의 상태 색이 정상으로 돌아갑니다.

문제를 아직 해결하지 않았더라도 상태 색은 바뀝니다. 조치를 시작했다는 사실을 기록하고 중복 알림을 멈추기 위해서입니다.

노트

대량 알림으로 차단된 이벤트와 상태가 정비 계획인 이벤트에는 처리 내역을 등록할 수 없습니다.

메시지는 255바이트 미만으로 입력할 수 있습니다. 같은 이벤트에 여러 번 등록할 수 있고, 등록할 때마다 건수가 올라가며 목록에 누적됩니다.

진행 중인 이벤트만 보기

현재 진행 중인 상태의 이벤트만 조회할 수 있습니다.

경고 알림 > 이벤트 기록에서 [ 진행 중인 이벤트만 보기 ] 버튼을 클릭하세요.
필터 쿼리에 다음 조건이 자동으로 추가되어 검색됩니다.
```
Stateful: true and Status : "ON"
```

AI 분석

이벤트 목록의 이벤트 이름 컬럼에 있는 버튼을 클릭하면 해당 이벤트를 WhaTap AI가 분석합니다. 이벤트가 어떤 상황에서 발생했는지, 반복되는 패턴인지, 함께 살펴볼 지표나 알림이 있는지를 화면을 옮겨 다니지 않고 확인할 수 있습니다.

경고 알림 > 이벤트 기록으로 이동하세요.
분석할 이벤트 행의 이벤트 이름 옆에 있는 버튼을 클릭하세요.

화면 오른쪽 WhaTap AI 채팅창에 분석 결과가 표시됩니다. 분석 결과 끝에는 이어서 확인할 만한 내용을 제안합니다. 채팅창에 그대로 질문해 분석을 계속할 수 있습니다.

표 | 분석 결과 구성

항목	설명
이벤트 내용	발생, 해소 시각, 대상 에이전트, 발생 당시 값, 이벤트 레벨
반복 패턴	같은 이벤트의 최근 발생 횟수와 대상, 임곗값과의 차이, 평균 지속 시간
관련 지표	해당 구간 주요 지표의 평균, 최대, 최소
함께 보이는 알림	같은 시간대에 발생한 다른 이벤트
제안	임곗값 조정, 추가 확인이 필요한 화면 등 조치 방향

노트

분석 결과의 구성 항목은 이벤트 종류와 제품에 따라 다를 수 있습니다. 예를 들어 APM 프로젝트에서는 느린 트랜잭션 분석이 함께 표시됩니다. AI 분석의 공통 동작과 분석에 사용하는 데이터 범위는 다음 문서를 참고하세요.

이벤트 검색

정확한 검색: 원하는 조건을 정확히 지정하여 필요한 이벤트만 조회
복합 조건: 여러 필드를 동시에 검색하여 복잡한 조건도 한 번에 처리
유연한 패턴: 와일드카드, 부분 검색 등 다양한 검색 방식 지원
빠른 성능: 인덱싱된 데이터를 활용한 고속 검색

검색 가능한 필드

필드와 값에 대해 대소문자를 구분하지 않습니다.

필드명 태그: 필드가 지원되는 이벤트 타입
필드 타입: 필드의 데이터의 타입
- : Number
- : String
- : Boolean
- : Date

이벤트 정보 필드

필드명	타입	설명	예시 값
Title	String	이벤트 제목	"Database Connection Error"
OffTitle	String	이벤트 해소 제목	"RECOVERED: Database Connection Error"
Message	String	이벤트 메시지	"Connection timeout occurred"
OffMessage	String	이벤트 해소 메시지	"RECOVERED: Connection timeout occurred"
Level	String	현재 이벤트 레벨	`Critical`, `Warning`, `Info`
OriginLevel	String	원본 이벤트 레벨	`Critical`, `Warning`, `Info`
Status	String	이벤트 상태	`ON`, `OFF`, `CANCEL`, `ACKNOWLEDGE`, `MAINTENANCE`, `DISABLED`
ActCount	Number	처리내역 개수	2
MetricName	String	지표 이름	"memory"
MetricValue	String	지표 값	"85.5"
OffValue	String	해소 값	"72.8"
MetricThreshold	String	임계치	"80"
alertType	String	이벤트 종류	"BASIC", "METRICS", "TRANSACTION" 등
alertId	String	이벤트 규칙의 고유식별자	"zf3uojer0fv4v7"

이벤트 타입별 지원 필드

노트

특정 이벤트 타입에서만 지원되는 필드입니다. 해당 이벤트 타입이 아닌 경우 값이 없을 수 있습니다.

필드명	타입	이벤트 종류	설명	예시 값
eventRule	String	기본, 메트릭스	이벤트 발생 규칙	"memory ≥ 80"
field	String	실시간 로그	로그 검색 키	"content"
keyword	String	실시간 로그	로그 검색 값	"Error"
logCategory	String	실시간 로그	로그 카테고리	"AppLog"
logContent	String	실시간 로그	로그 내용	"00:00000:00009:2025/04/06 23:03:52.55 server Error: 1601, Severity: 17, State: 3\n00:00000:00009:2025/04/06 23:03:52.55 server There are not enough 'user connections' available to start a new process."

대상 필드

초안

수정 (SERVICE-3347) Okind·OkindName·Onode·OnodeName 설명을 "종류", "서버"에서 에이전트 그룹·에이전트 노드로 바꿨습니다.

필드명	타입	설명	예시 값
Oid	Number	에이전트 고유식별자	-98765432
Oname	String	에이전트 이름	"web-server-01"
Okind	Number	에이전트 그룹 ID	867318026
OkindName	String	에이전트 그룹	"web-server"
Onode	Number	에이전트 노드 ID	334634079
OnodeName	String	에이전트 노드	"production-node-1"

이벤트 고유값 필드

필드명	타입	설명	예시 값
Id	Number	이벤트의 고유식별자	5768121
UUID	String	이벤트 고유식별자	"550e8400-e29b-41d4-a716"

상태/플래그 필드

필드명	타입	설명	예시 값
Stateful	Boolean	상태 기반 이벤트 여부	true, false
Disabled	Boolean	종료된 이벤트 여부	true, false
Escalation	Boolean	에스컬레이션 여부	true, false
SystemEvent	Boolean	시스템 이벤트 여부	true, false

검색 유형별 문법

노트

검색 기본 문법은 WhaTap log search query 문법 문서를 참고하세요.

1. 키워드 검색

Database Connection 문자열이 포함된 이벤트
title: "Database Connection"

2. 여러 값 검색

여러 옵션 중 하나라도 포함되는 이벤트를 조회합니다.

title: Database Connection

현재 이벤트 레벨이 Info이거나 Warning인 이벤트
level: info warning

3. 패턴 검색

와일드카드를 사용하여 패턴을 검색할 수 있습니다.

이름 패턴으로 특정 에이전트에서 발생된 이벤트 찾기
oname: web-*-prod 

제목이 Connection으로 끝나는 이벤트 찾기
title: *Connection

4. 복합 조건 검색

여러 조건을 조합하여 정확히 검색할 수 있습니다.

Critical 레벨이면서 제목에 Database가 포함된 이벤트
level: critical and title: Database

특정 에이전트의 Warning 또는 Critical 이벤트
oname: web-server-01 and level: Warning Critical

5. OR 조건 검색

여러 조건 중 하나라도 만족하는 이벤트를 조회합니다.

제목 또는 메시지에 특정 키워드가 포함된 이벤트
title: Connection or message: Connection

6. 제외 조건

특정 조건을 제외해 검색할 수 있습니다.

Info 레벨을 제외한 모든 이벤트
not level: info

이벤트 기록 조회하기​

컬럼 설정​

CSV 다운로드​

이벤트 상태​

처리 내역​

진행 중인 이벤트만 보기​

AI 분석​

이벤트 검색​

검색 가능한 필드​

이벤트 정보 필드​

이벤트 타입별 지원 필드​

대상 필드​

이벤트 고유값 필드​

상태/플래그 필드​

검색 유형별 문법​

1. 키워드 검색​

2. 여러 값 검색​

3. 패턴 검색​

4. 복합 조건 검색​

5. OR 조건 검색​

6. 제외 조건​