aws/cloudwatch-알림-설정

cloudwatch-알림-설정은(는) 무엇을 하나요?

SNS 주제 및 구독을 사용하여 CloudWatch 알람에 대한 알림 채널을 설정합니다. 알람 알림을 구성할 때 항상 이 스킬을 사용하세요. 암호화된 SNS 주제를 생성하고, CloudWatch 액세스를 위한 주제 정책을 구성하며, 이메일/SMS/웹훅 구독을 설정하고, 적절한 보안 제어로 알람을 알림 작업에 연결합니다.

개요

이 스킬은 다음 단계를 안내합니다:

1. SNS 주제 생성 – 서버 측 암호화(SSE)가 활성화된 새 SNS 주제를 생성합니다.
2. 주제 정책 구성 – CloudWatch 서비스가 해당 주제에 알림을 게시할 수 있도록 하는 리소스 기반 정책을 연결합니다.
3. 구독 설정 – 대상 엔드포인트(이메일 주소, SMS 전화번호, HTTP/HTTPS URL)에 따라 SNS 구독을 생성합니다.
4. 알람 작업 구성 – CloudWatch 알람의 AlarmActions 또는 OKActions 속성을 SNS 주제 ARN으로 설정합니다.

사용 방법

사전 요구 사항

• AWS CLI가 설치 및 구성되어 있어야 합니다.
• 대상 리전의 CloudWatch 알람에 대한 기존 CloudWatch 알람이 있어야 합니다.
• 이메일 구독을 확인할 수 있는 유효한 이메일 주소 또는 SMS 구독을 위한 전화번호여야 합니다.

예제 (AWS CLI)

1. SNS 주제 생성:

   aws sns create-topic --name MyAlarmTopic --attributes '{"KmsMasterKeyId":"alias/aws/sns"}'
   

2. 주제 정책 연결 (CloudWatch 액세스 허용):

   {
     "Version": "2012-10-17",
     "Statement": [{
       "Effect": "Allow",
       "Principal": {
         "Service": "cloudwatch.amazonaws.com"
       },
       "Action": "sns:Publish",
       "Resource": "arn:aws:sns:us-east-1:123456789012:MyAlarmTopic"
     }]
   }
   

   aws sns set-topic-attributes --topic-arn arn:aws:sns:us-east-1:123456789012:MyAlarmTopic --attribute-name Policy --attribute-value file://policy.json
   

3. 이메일 구독 생성:

   aws sns subscribe --topic-arn arn:aws:sns:us-east-1:123456789012:MyAlarmTopic --protocol email --notification-endpoint [email protected]
   

4. CloudWatch 알람에 SNS 주제 연결:

   aws cloudwatch put-metric-alarm --alarm-name MyHighCPUAlarm --alarm-actions arn:aws:sns:us-east-1:123456789012:MyAlarmTopic
   

지원 플랫폼

• AWS CLI – 위의 예제 참조.
• AWS CDK (TypeScript) – Topic 및 Alarm 구성을 사용합니다.
• Terraform – aws_sns_topic, aws_sns_topic_policy, aws_sns_topic_subscription, aws_cloudwatch_metric_alarm 리소스를 사용합니다.

중요 참고 사항

• 암호화: 항상 KmsMasterKeyId를 지정하여 SNS 주제 암호화를 활성화하세요. 기본 AWS 관리형 키(alias/aws/sns)를 사용하거나 사용자 지정 KMS 키를 지정할 수 있습니다.
• 구독 확인: 이메일 구독은 확인이 필요합니다. 구독자는 확인 이메일의 링크를 클릭해야 알림을 받을 수 있습니다.
• 비용: SNS 주제, 구독 및 게시 작업에는 AWS 표준 요금이 부과됩니다.
• IAM 권한: CloudWatch가 SNS 주제에 게시할 수 있도록 하려면 cloudwatch:PutMetricAlarm 및 sns:Publish 권한이 필요합니다.

문제 해결

• 이메일 알림이 수신되지 않으면 SNS 주제 정책이 CloudWatch 서비스에 sns:Publish 권한을 부여하는지 확인하세요.
• 구독이 "PendingConfirmation" 상태인 경우 구독자가 확인 링크를 클릭했는지 확인하세요.
• CloudWatch 알람이 InsufficientData 상태로 유지되면 지표 네임스페이스와 차원이 올바른지 확인하세요.