수신 채널

수신 채널은 생성한 알람을 실제 이용하는 서비스에 연결하여 칵테일화면에 접속하지 않아도 해당 채널에서 확인할 수 있습니다.

1. 수신 채널 생성

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

1. Email

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

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

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

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

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

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

사용자 계정이 이메일 형식일 경우 발신 이메일은 사용자 계정 이메일 주소로 보내집니다.

ex) 알람 Response

1-1. Gmail

IMAP 사용 활성화

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

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

SMTP 사용을 위한 인증

1) [계정]으로 이동

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

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

App 비밀번호 설정

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

https://security.google.com/settings/security/apppasswordssecurity.google.com

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

칵테일 수신 채널 정보 입력

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

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

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

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

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

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

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

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

2. General WebHook

Webhook URL : 웹훅 URL

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

ex) 알람 Response - metric

{
   "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
   }
}

ex) 알람 Response - event

{
   "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"
   }
}

ex) 알람 Response - monitoring rule

{
   "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"
   }
}