# Alert Settings

Alert는 사용자가 Stream이나 System에서 발생할 수 있는 이상 및 관심 패턴을 사전 정의하고, 해당 이상이 감지되면 사용자에게 알림을 보내는 모듈입니다.

## Alert 설정하기

<figure><img src="https://2184736704-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ6NWzeQyKbSWkDFSGwGx%2Fuploads%2F6kmthMFXC4kySWsYItyx%2Falert_alert.JPG?alt=media&#x26;token=1cb8d874-f4b0-4d25-9e39-4d78ac8beb5d" alt=""><figcaption></figcaption></figure>

Alert Settings 페이지에서 사용자는설정된 Alert의 세부 정보를 검토하고 수정 할 수 있습니다.

* `Url`: Alert을 받을 HTTP Server를 의미하며, HTTP와 HTTPS를 모두 사용할 수 있습니다.
* `Secret Key`: HMAC-SHA1로 암호화할 때 사용하는 Secret Key입니다. 자세한 내용은 [여기 (Alert Security)](https://airensoft.gitbook.io/ovenmediaengine/alert#security)를 눌러 참고하십시오.
* `Timeout`: 요청 후 응답을 기다리는 시간이며, 밀리 초 (`ms`)를 사용합니다.

## Rules 설정하기

<figure><img src="https://2184736704-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ6NWzeQyKbSWkDFSGwGx%2Fuploads%2FLas4MAHOE80OSZHuKI57%2Falert_rules.JPG?alt=media&#x26;token=04d7d7b4-398c-489a-aa23-7fb13cc718bd" alt=""><figcaption></figcaption></figure>

Alert Settings 페이지에서 사용자는 Stream이나 System에서 발생할 수 있는 이상 및 관심 패턴을 Rules를 통해 사전 정의 할 수 있습니다.

### Ingres Rule

<table><thead><tr><th width="195">규칙</th><th>설명</th></tr></thead><tbody><tr><td><code>StreamStatus</code></td><td>Ingress Stream의 생성, 실패, 준비 및 삭제 상태를 감지합니다.</td></tr><tr><td><code>Min Bitrate</code></td><td>Ingress Stream의 Bitrate가 설정된 값보다 낮은 경우를 감지합니다.</td></tr><tr><td><code>Max Bitrate</code></td><td>Ingress Stream의 Bitrate가 설정된 값보다 높은 경우를 감지합니다.</td></tr><tr><td><code>Min Framerate</code></td><td>Ingress Stream의 Framerate가 설정된 값보다 낮은 경우를 감지합니다.</td></tr><tr><td><code>Max Framerate</code></td><td>Ingress Stream의 Framerate가 설정된 값보다 높은 경우를 감지합니다.</td></tr><tr><td><code>Min Width</code></td><td>Ingress Stream의 화면 너비가 설정된 값보다 작은 경우를 감지합니다.</td></tr><tr><td><code>Max Width</code></td><td>Ingress Stream의 화면 너비가 설정된 값보다 큰 경우를 감지합니다.</td></tr><tr><td><code>Min Height</code></td><td>Ingress Stream의 화면 높이가 설정된 값보다 작은 경우를 감지합니다.</td></tr><tr><td><code>Max Height</code></td><td>Ingress Stream의 화면 높이가 설정된 값보다 큰 경우를 감지합니다.</td></tr><tr><td><code>Min Samplerate</code></td><td>Ingress Stream의 Samplerate가 설정된 값보다 낮은 경우를 감지합니다.</td></tr><tr><td><code>Max Samplerate</code></td><td>Ingress Stream의 Samplerate가 설정된 값보다 높은 경우를 감지합니다.</td></tr><tr><td><code>Long KeyFrame Interval</code></td><td>Ingress Stream의 Key Frame 간격이 너무 긴 경우 (4초 초과)를 감지합니다.</td></tr><tr><td><code>Has B Frame</code></td><td>Ingress Stream에 B-Frame이 있는 경우를 감지합니다.</td></tr></tbody></table>

### Egress Rule

<table><thead><tr><th width="195">규칙</th><th>설명</th></tr></thead><tbody><tr><td><code>StreamStatus</code></td><td>Egress Stream의 생성, 준비, 삭제 상태를 감지합니다.</td></tr><tr><td><code>LLHLSReady</code></td><td>Low-Latency HLS 재생이 가능한 시점을 감지합니다.</td></tr><tr><td><code>HLSReady</code></td><td>HLS 재생이 가능한 시점을 감지합니다.</td></tr></tbody></table>

## Rules 동적 로드 | 0.18.3.1+

Rules 동적 로드 기능을 이용하면 OvenMediaEngine을 재시작하지 않고도 관심 패턴을 실시간으로 변경하고 적용할 수 있습니다.

Alert Settings 페이지에서 `Use Rule File` 옵션을 활성화합니다. `Use Rule File` 활성화 시, Rules를 별도로 관리할 파일을 설정하는 UI가 표시됩니다.

<figure><img src="https://2184736704-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ6NWzeQyKbSWkDFSGwGx%2Fuploads%2FPNRxkKdGSASl7ZTIPkPi%2Falert_use_rules_file.JPG?alt=media&#x26;token=bbe0d4d9-babc-4988-bf45-1297133b2694" alt=""><figcaption></figcaption></figure>

* `Rules File`:  생성할 Rules 관리 파일의 경로를 입력합니다. 상대 경로로 지정할 경우, OvenMediaEngine 설정 디렉토리를 기준으로 경로가 설정됩니다.
* `Import Existing Rules File` : 기존 Rules 관리 파일을 불러옵니다.

우측 상단의 `Update Configuration` 버튼을 눌러 Rules 설정을 OvenMediaEngine에 적용할 수 있습니다.

<figure><img src="https://2184736704-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FZ6NWzeQyKbSWkDFSGwGx%2Fuploads%2FaE26WgQebSqXFwPcNIkB%2Frules_save.JPG?alt=media&#x26;token=32e677fc-7021-4631-be30-8c687a0b1d12" alt=""><figcaption></figcaption></figure>

설정을 적용하기 전에 팝업 창에서 파일의 변경점을 미리 확인할 수 있으며, 확인 버튼을 누르면 OvenMediaEngine을 재시작하지 않아도 새로운 설정이 즉시 적용됩니다.

{% hint style="info" %}
세부 가이드: <https://docs.ovenmediaengine.com/alert>
{% endhint %}