> 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-trigger.md).

# 이벤트 트리거

이벤트 트리거 페이지는 프로젝트에 속한 인스턴스의 자원 사용량을 지속적으로 모니터링하여 특정 조건이 충족될 때 프로젝트 멤버에게 알림을 보내는 자동 알림 규칙을 설정하는 화면입니다.\
인스턴스의 CPU·메모리 사용률을 실시간으로 감지하고, 이메일을 통해 즉각적인 알림을 받을 수 있습니다.

> 💡 **참고:** 관리자 영역의 이벤트 트리거와 달리, 프로젝트 이벤트 트리거는 **현재 프로젝트의 인스턴스 지표**만 조건으로 사용하며 알림 채널은 **이메일**만 지원합니다.

## 이벤트 트리거 목록

설정된 모든 트리거 규칙을 확인하고 관리할 수 있습니다.

### 테이블 컬럼

| 컬럼명     | 설명                          |
| ------- | --------------------------- |
| 이름      | 이벤트 트리거 이름 (사용자가 지정한 규칙 이름) |
| 활성화 여부  | 이벤트 트리거의 활성화 상태(활성화/비활성화)   |
| ID      | 트리거 식별자 (고유 번호)             |
| 연결 채널 수 | 연결된 알림 채널의 개수               |
| 연결 조건 수 | 설정된 트리거 조건의 개수              |
| 설명      | 트리거에 대한 설명 또는 용도            |
| 생성 일시   | 트리거가 생성된 시간                 |

이름을 클릭하면 해당 트리거의 상세 정보 페이지로 이동합니다.

### 주요 기능

* `검색`: 이름 기준 부분 일치 검색
* `생성`: 생성 버튼 클릭 → 신규 트리거 설정 화면 이동
* `편집`: 선택 후 편집 버튼 클릭 (1개만 선택 가능)
* `삭제`: 선택 후 삭제 버튼 클릭 (1개만 선택 가능)
* `활성화`: 선택 후 활성화 버튼 클릭 (1개만 선택 가능)
* `비활성화`: 선택 후 비활성화 버튼 클릭 (1개만 선택 가능)

***

## 이벤트 트리거 생성 및 편집

새 트리거 생성 시 **이름, 설명, 조건, 채널** 4가지를 순차적으로 설정합니다.\
(편집 화면에서는 이름/설명/활성화 여부만 수정 가능하며, 조건/채널 섹션은 표시되지 않습니다)

### 기본 정보

* **이름**: 이벤트 트리거의 이름을 입력합니다.
* **설명**: 이벤트 트리거의 설명을 입력합니다.

#### 입력 필드 유효성

| 필드     | 허용 값                  | 검증 규칙      | 비고     |
| ------ | --------------------- | ---------- | ------ |
| **이름** | 최대 20자(영문/숫자/`-`/`_`) | 공백/특수문자 불가 | **필수** |
| **설명** | 최대 200자               |            | **필수** |

> 💡 **참고:** 편집 화면은 이름/설명/활성화 여부만 수정 가능합니다. 조건/채널 변경은 상세 페이지에서 수행합니다.

### 환경설정

* **활성화 여부**: 이벤트 트리거의 활성화 여부를 토글로 지정합니다. (기본값: 활성화)

### 이벤트 트리거

이벤트 트리거 조건을 **1개 이상** 지정해야 합니다.

#### 이벤트 트리거 조건

* **인스턴스:**\
  조건을 평가할 대상 인스턴스를 현재 프로젝트의 인스턴스 중에서 선택합니다.\
  조건 리스트에는 `인스턴스 이름 (ID: {id})` 형식으로 표시됩니다.
* **조건 유형:**
  * `CPU 사용률`
  * `메모리 사용률`
* **비교 연산자:**
  * `>=`: 이상
  * `<=`: 이하
* **값:**\
  0\~100 사이의 정수 (%)
* **알림 주기:**\
  재알림 간격(분/시간). 알림 발생 후 설정된 알림 주기 동안 동일 조건 재발생 시 추가 알림을 무시합니다.

조건을 확인하면 조건 리스트에 추가됩니다.\
여러 조건은 **각각 독립적으로 평가**되며, 하나라도 충족되면 트리거가 발동됩니다.

> 💡 **참고:** 이벤트 트리거 조건은 각각 독립적으로 동작합니다.

#### 알림 채널

채널을 **1개 이상** 추가해야 합니다.

* **채널 타입:**
* `이메일`: 프로젝트 멤버 중에서 수신할 사용자를 선택, 중복 사용자 추가 불가 (채널 유형은 이메일로 고정)

> 💡 **참고**
>
> * 조건/채널이 0개면 트리거 생성이 불가합니다.
> * 조건/채널 변경은 상세 페이지에서 수행 가능합니다.
> * 이미 추가된 사용자는 선택지에서 제외됩니다.

***

## 이벤트 트리거 상세

트리거 클릭 시 상세 페이지에서 설정 내용을 확인합니다.

### 상단 요약

* **이름**: 이벤트 트리거 이름입니다.
* **활성화 여부**: 이벤트 트리거의 활성화 상태(활성화/비활성화)입니다.
* **ID**: 이벤트 트리거 고유의 ID입니다.
* **설명**: 이벤트 트리거의 설명입니다.
* **생성 일시**: 이벤트 트리거가 생성된 일시입니다.
* **연결 채널 수**: 이벤트 트리거가 연결된 채널의 개수입니다.
* **연결 조건 수**: 이벤트 트리거가 연결된 조건의 개수입니다.

### 하단 탭: 이벤트 트리거 조건

트리거에 설정된 모든 조건들이 표 형태로 나열됩니다. 각 조건의 대상 인스턴스, 유형, 연산자, 값, 알림 주기를 확인할 수 있습니다.

`편집` 버튼으로 조건 추가/삭제 가능합니다.(최소 1개 유지 필요).

### 하단 탭: 알림 채널

트리거에 등록된 모든 채널을 확인하고 편집할 수 있습니다. 동일 사용자(이메일)는 중복 추가 불가입니다.

`편집` 버튼으로 채널 추가/삭제 가능합니다.(최소 1개 유지 필요).

***

## 알림 확인

트리거 조건이 충족되면 다음 경로로 알림을 확인할 수 있습니다.

* **이메일**: 알림 채널에 등록된 사용자에게 알림 메일이 발송됩니다.
* **인앱 알림**: 웹 콘솔 상단의 알림함(종 아이콘)에 알림이 노출됩니다.
* **이벤트**: 발생한 알림은 `모니터링 > 이벤트` 페이지에서 이벤트로도 확인할 수 있습니다.