[Ep.13] [Argo CD 운영 #8] Argo CD에서 애플리케이션 상태 모니터링 및 알림(Notification) 설정

🔹 Argo CD에서 애플리케이션 상태 모니터링이 중요한 이유

Argo CD는 GitOps 기반의 배포 자동화 도구로, 지속적으로 애플리케이션 상태를 모니터링하고 배포 상태를 추적할 수 있습니다.
운영 환경에서 Kubernetes 애플리케이션의 정상적인 동작을 보장하기 위해서는 실시간 모니터링과 알림(Notification) 설정이 필수입니다.

 

✅ Argo CD 상태 모니터링 및 알림 설정의 주요 목적

✔ 애플리케이션 동기화 상태(Sync Status) 및 헬스 상태(Health Status) 모니터링
✔ 배포 실패 또는 OutOfSync 상태 발생 시 즉시 감지
✔ Slack, 이메일, 웹훅(Webhook) 등의 알림 시스템과 연동
✔ 문제 발생 시 신속한 대응 및 롤백 수행 가능

---

🔹 Argo CD의 애플리케이션 상태 모니터링 방식

Argo CD는 애플리케이션의 **두 가지 주요 상태(Sync Status & Health Status)**를 모니터링합니다.

✅ 1. 동기화 상태(Sync Status)

Git 저장소와 Kubernetes 클러스터 간의 동기화 상태를 나타냅니다.

Sync 상태	설명
Synced	애플리케이션이 Git 상태와 동일
OutOfSync	애플리케이션이 Git 상태와 불일치
Unknown	애플리케이션 상태를 확인할 수 없음

✅ 2. 헬스 상태(Health Status)

Kubernetes 리소스의 정상 동작 여부를 나타냅니다.

Health 상태	설명
Healthy	모든 리소스가 정상적으로 동작
Degraded	일부 리소스가 정상적으로 실행되지 않음
Progressing	애플리케이션이 업데이트 중
Suspended	배포가 중지된 상태
Missing	선언된 리소스가 클러스터에서 발견되지 않음

 

✅ CLI를 사용한 애플리케이션 상태 확인:

argocd app get example-app

 

✅ 출력 예시:

Name:               example-app
Project:            default
Sync Status:        OutOfSync
Health Status:      Degraded

---

🔹 Argo CD 알림(Notification) 시스템 설정

Argo CD는 다양한 알림(Notification) 채널을 지원하며, 이를 통해 배포 상태 변경을 실시간으로 감지할 수 있습니다.
지원되는 주요 알림 채널은 다음과 같습니다.

 

✅ 지원되는 알림(Notification) 채널
✔ Slack → 배포 상태 변경을 실시간으로 알림
✔ Email → 중요한 알림을 이메일로 전송
✔ Webhook → 특정 URL로 HTTP 요청을 전송하여 외부 시스템과 연동
✔ Microsoft Teams → MS Teams 채널에서 알림 수신
✔ Telegram → 텔레그램 봇을 이용한 알림 전송

---

🔹 Argo CD Notifications 설치 및 설정

✅ 1. Argo CD Notifications 설치

Argo CD에서 알림 기능을 활성화하려면 argocd-notifications를 추가로 설치해야 합니다.

helm repo add argo https://argoproj.github.io/argo-helm
helm repo update
helm install argocd-notifications argo/argocd-notifications -n argocd

 

설치 후, 알림이 정상적으로 동작하는지 확인합니다.

kubectl get pods -n argocd | grep notifications

 

✅ 출력 예시:

argocd-notifications-controller-xyz   1/1   Running   0   1m

---

✅ 2. Slack 알림 설정

Slack과 연동하여 배포 상태를 알림받을 수 있습니다.
먼저 Slack Webhook URL을 생성한 후, Argo CD 설정 파일에 추가합니다.

apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-notifications-cm
  namespace: argocd
data:
  service.slack: |
    token: xoxb-XXXXXXXXX
    webhook: https://hooks.slack.com/services/XXXX/XXXX/XXXX

 

설정 적용 후, 알림을 테스트합니다.

argocd-notifications template notify-test

 

✅ Slack 알림 예시:

[ArgoCD] example-app: Application is OutOfSync

---

✅ 3. Email 알림 설정

이메일을 통한 알림을 설정하려면 SMTP 서버 정보를 추가해야 합니다.

apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-notifications-cm
  namespace: argocd
data:
  service.email: |
    smtpServer: smtp.example.com
    smtpPort: 587
    username: user@example.com
    password: password123
    from: argocd@example.com

 

설정 적용 후, 테스트 이메일을 보낼 수 있습니다.

argocd-notifications template notify-test --email user@example.com

---

✅ 4. Webhook 알림 설정

외부 시스템과 연동하여 이벤트를 처리하려면 Webhook을 사용할 수 있습니다.

apiVersion: v1
kind: ConfigMap
metadata:
  name: argocd-notifications-cm
  namespace: argocd
data:
  service.webhook: |
    url: http://example.com/webhook

 

테스트 Webhook 호출:

argocd-notifications template notify-test --webhook example-webhook

 

✅ Webhook 요청 예시 (JSON 형식):

{
  "application": "example-app",
  "status": "OutOfSync",
  "message": "Application is OutOfSync"
}

---

🔹 Argo CD 알림 설정 CLI 명령어 정리

명령어	설명
argocd-notifications template notify-test	알림 테스트 실행
argocd app get <APP>	애플리케이션 상태 확인
argocd-notifications template notify-test --email <EMAIL>	이메일 알림 테스트
argocd-notifications template notify-test --slack <CHANNEL>	Slack 알림 테스트
argocd-notifications template notify-test --webhook <URL>	Webhook 알림 테스트

---

🔹 결론: 이번 글에서 배운 핵심 내용 정리

🟢 Argo CD는 Sync 상태 및 Health 상태를 지속적으로 모니터링하여 배포 상태를 관리
🟢 애플리케이션이 OutOfSync 또는 Degraded 상태가 되면 즉시 감지 가능
🟢 Slack, Email, Webhook 등 다양한 알림 채널을 설정하여 배포 문제를 신속히 대응 가능
🟢 Argo CD Notifications를 활용하여 배포 이벤트를 자동으로 감지하고 알림을 전송 가능