> For the complete documentation index, see [llms.txt](https://ia-cloud.gitbook.io/cloudia-manual/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ia-cloud.gitbook.io/cloudia-manual/monitoring/event.md).

# 이벤트

**이벤트 페이지**는 사용자 자신에 의하여 프로젝트 내에서 발생하는 다양한 이벤트 로그를 시간순으로 보여주는 모니터링 화면입니다.\
여기서 **이벤트**란 시스템 동작(예: 인스턴스 생성/삭제)과 같은 중요한 사건을 기록한 것입니다.\
프로젝트에 속한 사용자는 이 페이지를 통해 사용자 자신이 프로젝트 내에서 일어난 작업이나 변화를 한눈에 파악하고, 필요한 경우 세부 내용을 확인할 수 있습니다.\
이벤트는 발생 시각과 레벨, 유형, 관련 프로젝트, 메시지 등의 정보를 포함하며 **읽기 전용**으로 제공됩니다.

## 이벤트 목록

**이벤트 페이지**에서는 프로젝트 내에서 사용자 자신에 의해 발생한 이벤트를 조회할 수 있습니다.

### 테이블 컬럼

| 컬럼명        | 설명                                       |
| ---------- | ---------------------------------------- |
| **이벤트 레벨** | INFO / WARN / ERROR / CRITICAL           |
| **이벤트명**   | 이벤트의 유형                                  |
| **사용자 이름** | 이벤트를 발생시킨 사용자 이름                         |
| **프로젝트**   | 이벤트가 발생한 프로젝트명                           |
| **메시지**    | 이벤트 상세 설명                                |
| **생성 일시**  | 이벤트 발생 시간 (로컬 시간 기준), 클릭 시 최신순/과거순 정렬 가능 |

### 이벤트 레벨

이벤트 레벨은 이벤트의 심각도를 나타내는 지표입니다.

| 이벤트 수준       | 설명                  |
| ------------ | ------------------- |
| **INFO**     | 일반 정보성 이벤트          |
| **WARN**     | 경고성 이벤트             |
| **ERROR**    | 오류 관련 이벤트           |
| **CRITICAL** | 시스템에 영향을 줄 수 있는 이벤트 |

### 이벤트 필터링

이벤트가 많을 경우 필터링 기능을 통해 원하는 데이터를 빠르게 조회할 수 있습니다. 필터링 조건은 아래와 같습니다.

| 필터 유형             | 설명                                                                                   |
| ----------------- | ------------------------------------------------------------------------------------ |
| **검색어**           | 키워드 입력으로 이벤트를 검색할 수 있음. “이벤트명” 또는 “사용자명” 기준 선택 가능. 콤마(`,`)로 구분하여 여러 항목을 동시에 검색할 수 있음 |
| **이벤트 레벨(Level)** | INFO / WARN / ERROR / CRITICAL 또는 “모든 이벤트 레벨” 중 선택하여 심각도별 필터링 가능                     |
| **날짜 범위**         | 캘린더 아이콘 클릭 후 시작일·종료일 지정 가능 (기본 최근 7일)                                                |

여러 조건을 동시에 설정할 수 있으며, `검색` 버튼을 눌러 필터를 적용하여 조회할 수 있습니다.

### 이벤트 CSV 다운로드

**CSV 다운로드 버튼**을 통해 현재 필터 조건으로 조회된 이벤트 목록을 CSV 파일로 저장할 수 있습니다.

> 💡 참고
>
> * **조회 전용 화면**으로, 이벤트 데이터를 수정하거나 삭제할 수 없습니다.
> * 기본 조회 기간은 최근 7일로 설정되며, 그 이전의 데이터는 날짜 범위 확장 후 조회해야 합니다.
> * 날짜 범위 변경은 즉시 적용됩니다.
> * 조건에 일치하는 이벤트가 없는 경우 “리스트 데이터가 존재하지 않습니다.” 메시지가 표시됩니다.
> * 인스턴스 실행 실패, 일정(스케줄) 실행 실패 같은 작업 실패 이벤트도 이 목록에 표시되며, 보통 `ERROR` 레벨로 기록됩니다. 레벨 필터를 `ERROR`로 지정하면 실패 이벤트를 빠르게 찾을 수 있습니다.

> ⚠️ 주의: **이벤트 데이터는 보존 기간 정책에 따라 자동 삭제**될 수 있습니다.