# 알림/알람 기능 사용하기

### **1. AppPaaS 알림/알람 기능 소개**

***

서버 운영 중에는 서비스 중지, 리소스 과다 사용 등의 이유로 서비스 제공에 차질이 생길 수 있습니다. \
이러한 상황에서 빠르게 대응할 수 있도록 **AppPaaS 알림/알람 기능**을 제공합니다.

AppPaaS의 알림/알람 기능을 활용하면 AppPaaS에 로그인하지 않고도 \
**이메일** 또는 **WebHook**을 통해 알림을 받을 수 있습니다.

### **2. 알림 그룹과 알림 유형**

***

<figure><img src="https://1281168261-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F69bJtwnfn269Dqzr8gks%2Fuploads%2F4Y0nR13kkCEZ5UDTmRqX%2Fimage.png?alt=media&#x26;token=800b876f-7b6e-4ad5-b01f-d33deb062161" alt=""><figcaption></figcaption></figure>

AppPaaS의 알림/알람 기능을 사용하려면 먼저 **알림 그룹**을 생성해야 합니다. \
로인 후 우측 상단의 프로필 이미지를 선택 내 정보 관리로 접근 하시면 알림 그룹 관리 메뉴가 있습니다.\
\
알림 그룹 생성 시 아래 정보를 입력해야 합니다:

* **알림 그룹명**: 알림 그룹의 이름.
* **알림 수단**: 이메일 또는 WebHook 중 선택.
* **알림 그룹**: 알림을 받을 대상 지정.

### 3. 알림 수단 - 이메일

***

<figure><img src="https://1281168261-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F69bJtwnfn269Dqzr8gks%2Fuploads%2Fiy2JC2Bgj9isNiGAmY1h%2Fimage.png?alt=media&#x26;token=56dab6d7-1a66-4859-9b5b-a2e7fa3b6acd" alt=""><figcaption></figcaption></figure>

이메일을 사용하면 알림 대상이 **소유자** 또는 **개별**에 따라 설정해야 하는 정보가 달라집니다.

* **소유자**: 로그인한 회원 본인을 의미합니다.
* **개별**: 로그인한 회원 이외의 다른 사람들을 알림 대상으로 지정합니다.

**추천 설정**

* 알림을 본인만 받고 싶다면 **소유자**를 선택.
* 여러 사람에게 알리고 싶다면 **개별**을 선택.

### 3. 알림 수단 - WebHook

***

<figure><img src="https://1281168261-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F69bJtwnfn269Dqzr8gks%2Fuploads%2F66PSvL67u3KUojMQUXNt%2Fimage.png?alt=media&#x26;token=e6b471ff-5b40-4c8d-a106-daf58cbd02bf" alt=""><figcaption></figcaption></figure>

WebHook을 사용하기 위해서는 AppPaaS에서 전송하는 WebHook 메시지를 \
수신받기 위한 사전 작업이 필요합니다. 아래 과정을 따라 설정하세요.

{% stepper %}
{% step %}
**WebHook 봇 생성**

검색 엔진에서 "Slack incoming WebHook 만들기"와 같은 키워드를 검색하여 \
WebHook 봇을 만듭니다.
{% endstep %}

{% step %}
**AppPaaS WebHook 설정**

**EndPoint 설정**\
WebHook이 요청을 전송할 URL 입력 (예: 알림을 받고 싶은 API 서버의 URL).

**Header 설정**\
기본값은 `Content-Type: application/json`이며, 필요 시 추가 헤더를 설정합니다.

**Body 설정**\
POST 요청에 포함될 JSON 본문 데이터를 설정하며, 템플릿 변수를 사용할 수 있습니다.

```json
{
    "text": "안녕하세요 {{userName}}님, 운영 중이신 {{serviceName}}의 상태를 알려드립니다. 상태: {{status}}"
}
```

{% endstep %}

{% step %}
**WebHook 테스트**

설정 완료 후, **WebHooks 테스트** 버튼을 클릭하여 메시지가 정상적으로 전송되는지 확인하세요.
{% endstep %}
{% endstepper %}

### 4. 알림 유형

***

<figure><img src="https://1281168261-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F69bJtwnfn269Dqzr8gks%2Fuploads%2F6myV0uXvARtG9MQwuMmS%2Fimage.png?alt=media&#x26;token=bad3f3c4-ddeb-436e-903b-9d208a48ad44" alt=""><figcaption></figcaption></figure>

알림 그룹 생성 후, **서비스 알림** 메뉴에서 아래 알림 유형을 선택하여 사용할 수 있습니다.

#### **일반 알림 설정**

* **서비스 중지**: 서비스가 중지된 경우 알림 발송.
* **서비스 시작**: 서비스가 시작된 경우 알림 발송.
* **서비스 재배포**: 서비스가 재배포된 경우 알림 발송.

#### **임계치 알림 설정**

임계치 알림 설정은 vCPU와 Memory 각각 사용률에 따라 알림을 발송하는 기능으로\
기본 설정은 50%로 사용자의 관심 지표에 따라 10% 단위로 설정 가능합니다.

설정한 임계치가 1분 이상 유지 되는 경우 최대 5회까지 알림이 발송됩니다.

이 가이드를 참고하여 AppPaaS의 알림/알람 기능을 효과적으로 활용해보시길 바랍니다.