> 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/administrator/monitoring/event.md).

# 이벤트

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

## 이벤트 목록

**관리자 이벤트 페이지**에서는 Cloud:iA에서 발생한 이벤트를 조회할 수 있습니다.

### 테이블 컬럼

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

### 이벤트 레벨

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

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

### 이벤트 검색

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

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

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

### CSV 다운로드

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

> 💡 참고
>
> * **조회 전용 화면**으로, 이벤트 데이터를 수정하거나 삭제할 수 없습니다.
> * 기본 조회 기간은 최근 7일로 제한되며, 그 이전의 데이터는 날짜 범위 확장 후 조회해야 합니다.
> * 날짜 범위 변경은 즉시 적용됩니다.
> * 조건에 일치하는 이벤트가 없는 경우 “리스트 데이터가 존재하지 않습니다.” 메시지가 표시됩니다.

> ⚠️ 주의: **이벤트 데이터는 보존 기간 정책(90일)에 따라 자동 삭제**될 수 있습니다. 필요한 경우 CSV 다운로드 기능으로 데이터를 미리 백업해두는 것을 권장합니다.