> 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="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2F2jDlxHw1Zc8OfswFcXFT%2Fimage.png?alt=media&amp;token=4bb6d8ba-ae07-4448-b039-3e22d4398c61" alt=""><figcaption></figcaption></figure>

### 1. Email

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FK9J5LEedpc5z3Wdz2ShW%2Fimage.png?alt=media&amp;token=69d6d6e3-c85e-4195-b702-81dcdc7965fc" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

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

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

<details>

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

![](https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FYDQkGtCvJrGKGwa0HVBr%2Fimage.png?alt=media\&token=f1d84c9c-af45-4ae8-88d5-d4a30bf08017)

</details>

### 1-1.  Gmail

#### IMAP 사용 활성화

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

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2Frw3Qg6MY9CCQNADd97Q8%2Fimage.png?alt=media&amp;token=952279fe-9520-40a3-9244-aa90918e857c" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FvEl9VugKC76BzQw1JjHK%2Fimage.png?alt=media&amp;token=44d580d7-f093-4b89-88f6-d8b89393ead2" alt=""><figcaption></figcaption></figure>

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

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

<div align="left"><figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FI7AhSYKaMhdHGBFyfvbN%2Fimage.png?alt=media&amp;token=c5f338b7-6388-47fe-9dfa-2c056af9468a" alt="" width="375"><figcaption></figcaption></figure></div>

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

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FIYrrGbd1LDOEk2QYW4oG%2Fimage.png?alt=media&amp;token=2c373b74-750a-4b19-a6dd-062b83e081bc" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2Fch1Z3UIUJPFeCYgz9cJM%2Fimage.png?alt=media&amp;token=d8d3e63d-c2a1-4ed1-aa65-3c6d7280f95f" alt=""><figcaption></figcaption></figure>

#### App 비밀번호 설정

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

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

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FBOBfva3qPSTbePaAIvec%2Fimage.png?alt=media&amp;token=c292383f-75cb-437f-9d5c-82811ebc8a0a" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FXoeE4AicNEL1td4FNEqt%2Fimage.png?alt=media&amp;token=addb8264-b70c-4e07-a635-046399c244f4" alt=""><figcaption></figcaption></figure>

칵테일 수신 채널 정보 입력

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

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FtCBPWlntrwhXoTXdEIqw%2Fimage.png?alt=media&amp;token=aa9925c4-b217-4aca-89e6-56dad9026104" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

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

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

### 2. **General WebHook**

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FBA9ivknYOAhug9GRg9VO%2Fimage.png?alt=media&amp;token=a9fdea6d-ca9c-4ea7-829d-4747e4371e2b" 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="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FAQjuRGuDuVFm7VYmx1c5%2Fimage.png?alt=media&amp;token=dacff76e-bcc1-4d28-a653-f38fa3cb5e55" 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="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FrMzQUaCBciPUVE8XmguN%2Fimage.png?alt=media&amp;token=0b75d296-5696-46b7-a5f3-2724764e7668" alt="" data-size="original">

</details>

### 4. Slack

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FuU5KP4ADxEjua8RJyiQw%2Fimage.png?alt=media&amp;token=29d644e3-2789-4e0c-9a65-d32adf68dab7" alt=""><figcaption></figcaption></figure>

Webhook URL : 웹훅 URL

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

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

<details>

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

![](https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2Feczksc88NjQU0MCvpt7E%2Fimage.png?alt=media\&token=2cf48e73-3888-4a76-a8c5-e27c63891f75)

</details>

## 2. 테스트

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

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FkJSRyYf8dEYzEHveUVfw%2Fimage.png?alt=media&amp;token=f4776f9c-b8f6-4347-bf00-94934e61c710" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FYmbswMOFNTcJZrn6bTYv%2Fimage.png?alt=media&amp;token=46490b42-4f93-43d5-bda0-a41b2b615e2d" alt=""><figcaption><p>접속에 성공한 경우</p></figcaption></figure>

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2F2bfPTvY1sPbHFO9x7bIF%2Fimage.png?alt=media&amp;token=609d657a-7614-43be-95d6-6cf5926a1318" alt=""><figcaption><p>접속에 실패된 경우</p></figcaption></figure>

## 3. 알림 해제

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

<figure><img src="https://1668522666-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fvqp2nCQPDsjfLSru1kHs%2Fuploads%2FKoJb2bMFB2vBK8cULdLr%2Fimage.png?alt=media&amp;token=9ea975f2-cf5b-4f1c-98a1-132d254c0931" alt=""><figcaption></figcaption></figure>