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

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

***

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

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

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

***

<figure><img src="/files/y0lGSdht2PioiRYON3zL" alt=""><figcaption></figcaption></figure>

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

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

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

***

<figure><img src="/files/IyYuITlys8URVJpnz1ff" alt=""><figcaption></figcaption></figure>

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

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

**추천 설정**

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

### 3. 알림 수단 - WebHook

***

<figure><img src="/files/HVERubMIUKxGGran3X8s" 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="/files/enV6DFmR62q4YhU3UkN4" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

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

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.apppaas.com/start/apppaas-guide/alarm.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.