> For the complete documentation index, see [llms.txt](https://cocktailcloud.gitbook.io/cocktail-cloud-online/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cocktailcloud.gitbook.io/cocktail-cloud-online/notification/receive-channel.md).

# 수신 채널

## 1. 수신 채널 생성 <a href="#id-8cbf8723-3261-4a6e-951d-3738b3b8fcb1" id="id-8cbf8723-3261-4a6e-951d-3738b3b8fcb1"></a>

경고/알림 - 수신채널 설정 -  생성 버튼을 클릭하고 생성할 채널의 유형을 클릭합니다.

<figure><img src="/files/3BrTGJWGnUIEyyn8nixl" alt=""><figcaption></figcaption></figure>

### 1. Email

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

수신 이메일 : 알람을 받을 이메일 주소

SMTP 수신 서버 주소 : 오픈되어있는 이메일 서버의 주소

SMTP 포트 : 오픈되어있는 이메일 서버의 포트

사용자 계정 : 접속 가능한 이메일 서버 계정

사용자 비밀번호 : 접속 가능한 이메일 서버 비밀번호

발신 이메일 :  이메일 보낼 메일 주소

{% hint style="info" %}
사용자 계정이 이메일 형식일 경우 발신 이메일은 사용자 계정 이메일 주소로 보내집니다.
{% endhint %}

<details>

<summary>ex) 알람 Response</summary>

![](/files/8CN8qOMdzKisZyrL4qZq)

</details>

### 1-1.  Gmail

#### IMAP 사용 활성화

1\) gmail에서 우측 상단의 톱니 바퀴를 누른 후 \[모든 설정 보기] 버튼 클릭

<figure><img src="/files/62RK57oJeJ2m4c9pduNy" alt=""><figcaption></figcaption></figure>

2\) 전달 및 POP/IMAP 탭 이동 후 ” IMAP 사용” 버튼 체크

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

#### SMTP 사용을 위한 인증

1\) \[계정]으로 이동

<div align="left"><figure><img src="/files/lGBnSNnYJZaaYXDAEYIP" alt="" width="375"><figcaption></figcaption></figure></div>

2\) \[보안] 메뉴 선택 후 \[2단계 인증] 메뉴 선택

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

3\) “2단계 인증 사용 설정” 클릭

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

#### App 비밀번호 설정

1\) 아래 링크로 이동 후 앱 이름 작성

{% embed url="<https://security.google.com/settings/security/apppasswords>" %}

<figure><img src="/files/1RuaGWtFtUojpvGB2zHD" alt=""><figcaption></figcaption></figure>

2\) 생성된 앱 비밀번호 복사

<figure><img src="/files/4RCGWbkM3d1L0uNXfhyn" alt=""><figcaption></figcaption></figure>

칵테일 수신 채널 정보 입력

1\) 아래 내용에 맞게 정보 작성

<figure><img src="/files/0TpstkSuIP2UNyzyWDo6" alt=""><figcaption></figcaption></figure>

채널 명: 칵테일에서 관리하는 수신 채널 명

수신 이메일 : 칵테일에서 관리하는 수신 이메일

SMTP 수신 서버 주소 :smtp.gmail.com

SMTP 포트 : 둘 중 하나를 입력 587(TLS) or 465(SSL) &#x20;

사용자 계정 : smtp 사용 설정한 gmail 주소

사용자 비밀번호 : 생성한 gmail 앱비밀번호

발신 이메일 :  이메일 받을 메일 주소

### 2. **General WebHook**

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

Webhook URL : 웹훅 URL

HTTP Header : 별도로 추가할 헤더값

<details>

<summary>ex) 알람 Response - metric</summary>

```json
{
   "alarmName":"모니터링 메모리 알람",
   "alarmType":"APPLICATION",
   "alarmLevel":"Warning",
   "clusterId":"demo-cluster",
   "issueTime":"2024-06-28T04:06:09.772174295Z",
   "sourceData":{
      "cluster_id":"demo-cluster",
      "namespace":"cocktail-system",
      "workload_type":"",
      "workload_name":"cocktail-monitoring-monitoring-db",
      "usage_cpu":5,
      "usage_mem":2620764160,
      "request_cpu":600,
      "request_mem":2252341248,
      "limit_cpu":1200,
      "limit_mem":4504682496,
      "pod_count":1
   }
}
```

</details>

<details>

<summary>ex) 알람 Response - event</summary>

```json
{
   "alarmName":"test-event",
   "alarmType":"EVENT",
   "alarmLevel":"Warning",
   "clusterId":"gpu-cluster",
   "issueTime":"2024-06-28T05:27:42.275824326Z",
   "sourceData":{
      "cluster_id":"gpu-cluster",
      "count":169,
      "event_id":"9e141d00-12ab-405c-98a7-c5aa8970e72b",
      "event_name":"metrics-server.17d8cc47a5de4526",
      "event_type":"Normal",
      "first_seen":"2024-06-14T06:51:05Z",
      "last_seen":"2024-06-28T05:27:42Z",
      "message":"artifact up-to-date with remote revision: 'sha256:46eceac836bc6e6b60fee9daf73f3a58113115be95c001af67d59fdb840866e3'",
      "namespace":"flux-system",
      "node":"",
      "reason":"ArtifactUpToDate",
      "source":"source-controller",
      "timestamp":"2024-06-28T05:27:42.275715944Z",
      "workload":"metrics-server",
      "workload_type":"HelmRepository",
      "workload_version":"source.toolkit.fluxcd.io/v1"
   }
}
```

</details>

<details>

<summary>ex) 알람 Response - monitoring rule</summary>

```json
{
   "alarmName":"PodCrashLooping 알람",
   "alarmType":"RULE",
   "alarmLevel":"Warning",
   "clusterId":"gpu-cluster",
   "issueTime":"2024-07-02T06:23:09.181996004Z",
   "sourceData":{
      "clusterid":"gpu-cluster",
      "alarm_id":"865ba1a10aafe273",
      "namespace":"kheo",
      "workload_type":"pod",
      "workload_name":"nginx-59987955f5-glv8k",
      "pod":"nginx-59987955f5-glv8k",
      "container":"nginx",
      "alarm_key":"Cocktail-Rule-0016",
      "alarm_name":"KubePodCrashLooping",
      "severity":"warning",
      "description":"{\"message_en\":\"Pod kheo/nginx-59987955f5-glv8k (nginx) is in waiting state (reason: \\\\\\\"CrashLoopBackOff\\\\\\\").\",\"message_ja\":\"ポッドkheo/nginx-59987955f5-glv8k（nginx）が10分間1.00回の割合で再起動されます。\",\"message_ko\":\"파드 kheo/nginx-59987955f5-glv8k (nginx)가 대기 상태입니다.(이유: \\\\\\\"CrashLoopBackOff\\\\\\\").\"}",
      "status":"firing",
      "startsat":"2024-07-02T06:22:33.609Z",
      "endsat":"2024-07-02T06:26:33.609Z",
      "process_status":0,
      "error_detail":"",
      "sends_at":"0001-01-01T00:00:00Z",
      "acked_at":"0001-01-01T00:00:00Z",
      "ack_chunk":"",
      "timestamp":"2024-07-02T06:23:00Z",
      "runbook_url":"https://runbooks.prometheus-operator.dev/runbooks/kubernetes/kubepodcrashlooping"
   }
}
```

</details>

### 3. Google Chat

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

Webhook URL : 웹훅 URL

{% embed url="<https://developers.google.com/workspace/chat/quickstart/webhooks?hl=ko#create_a_webhook>" %}

<details>

<summary>ex) 알람 Response</summary>

<img src="/files/mMYwE7PNpe2clnfBWKID" alt="" data-size="original">

</details>

### 4. Slack

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

Webhook URL : 웹훅 URL

Slack 등록 명 : 수신받을 slack 채널명

{% embed url="<https://api.slack.com/messaging/webhooks>" %}

<details>

<summary>ex) 알람 Response</summary>

![](/files/bZPIbd0j4cgEvnjZhqho)

</details>

## 2. 테스트

생성할 수신 채널의 상태를 확인하기 위해 올바른 정보를 입력하고 '테스트' 버튼을 클릭하여 확인합니다.

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

<figure><img src="/files/NigHkE2sJUet39jwp7uv" alt=""><figcaption><p>접속에 성공한 경우</p></figcaption></figure>

<figure><img src="/files/uXAbFxrZt5RKv1Qvf6Li" alt=""><figcaption><p>접속에 실패된 경우</p></figcaption></figure>

## 3. 알림 해제

등록되어 있는 알람에서 수신채널을 삭제하여 해당 수신 채널에 알람을 수신하지 않는 기능입니다.

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://cocktailcloud.gitbook.io/cocktail-cloud-online/notification/receive-channel.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.