Alert Webhook

Overview

AWS Personal Health Dashboard (PHD) 이벤트를 CloudOps 로 보내려면 EventBridge Rule 로 Health 이벤트를 감지하고, API Destination 을 통해 CloudOps webhook endpoint 로 직접 전달합니다.

필요 정보:

CloudOps webhook URL — CloudOps 콘솔에서 AWS PHD webhook source 를 등록할 때 발급되는 엔드포인트. 먼저 CloudOps 에 AWS PHD 연동하기 단계로 이 값을 확보하세요.
EventBridge Rule, Connection, API Destination 을 생성할 수 있는 AWS 콘솔 권한.

설정은 아래 순서로 진행합니다.

EventBridge Connection 생성
EventBridge API Destination 생성
EventBridge Rule 생성 (Health 이벤트 → API Destination)
연동 테스트

ℹ️

AWS Health 이벤트는 사용자가 직접 발생시킬 수 없으며, AWS 인프라에서 서비스 이슈·예정된 유지보수·계정 알림이 발생할 때 자동으로 생성됩니다. 설정 완료 후 실제 이벤트가 발생하면 CloudOps 로 전달됩니다.

1. EventBridge Connection 생성

API Destination 이 외부 endpoint 를 호출할 때 사용할 인증 정보를 정의합니다.

EventBridge 서비스 이동

AWS 콘솔 에 로그인 한 뒤, 검색창에 EventBridge 를 입력하여 Amazon EventBridge 로 이동합니다.

Connection 생성

좌측 메뉴에서 [Integration > Connections] 를 클릭한 뒤, [Create connection] 을 클릭합니다.

Connection name: 식별 가능한 이름 입력 (예: cloudops-webhook-connection)
Destination type: Other
Authorization type: API Key
API key name: Content-Type
Value: application/json

[Create] 를 클릭합니다.

ℹ️

CloudOps webhook URL 은 URL 자체에 토큰이 포함되어 있으므로 별도의 인증 헤더가 필요하지 않습니다. API Key 에 Content-Type: application/json 을 설정하여 JSON 형식으로 전달되도록 합니다.

2. EventBridge API Destination 생성

CloudOps webhook URL 을 EventBridge 가 직접 호출할 수 있는 대상으로 등록합니다.

API Destination 생성

좌측 메뉴에서 [Integration > API destinations] 를 클릭한 뒤, [Create API destination] 을 클릭합니다.

Name: 식별 가능한 이름 입력 (예: cloudops-phd-destination)
API destination endpoint: CloudOps 에서 발급받은 Webhook URL 을 붙여넣습니다.
HTTP method: POST
Connection type: Use an existing connection
Connection: 위에서 생성한 Connection (예: cloudops-webhook-connection) 선택

[Create] 를 클릭합니다.

3. EventBridge Rule 생성

AWS Health 이벤트가 발생하면 자동으로 API Destination 으로 전달되도록 EventBridge Rule 을 설정합니다.

Rule 생성

좌측 메뉴에서 [Buses > Rules] 를 클릭한 뒤, [Create rule] 을 클릭합니다.

규칙 정보 입력

Name: 식별 가능한 이름 입력 (예: cloudops-health-rule)
Event bus: default 선택
Rule type: Rule with an event pattern 선택

[Next] 를 클릭합니다.

이벤트 패턴 설정

Event source 에서 AWS events or EventBridge partner events 를 선택합니다.

Event pattern 섹션에서 Custom pattern (JSON editor) 을 선택하여 직접 입력합니다:

{
  "source": ["aws.health"]
}

ℹ️

특정 서비스의 Health 이벤트만 수신하려면 detail.service 필터를 추가하세요:

{
  "source": ["aws.health"],
  "detail": {
    "service": ["EC2", "RDS"]
  }
}

[Next] 를 클릭합니다.

대상(Target) 설정

Target type: EventBridge API destination 선택
API destination: 위에서 생성한 API Destination (예: cloudops-phd-destination) 선택

[Next] → [Next] → [Create rule] 을 클릭하여 완료합니다.

4. 연동 테스트

테스트 방법

AWS Health 이벤트는 직접 발생시킬 수 없습니다. 설정이 올바르게 완료되었는지 확인하려면:

EventBridge Rule 상태 확인: EventBridge 콘솔에서 생성한 Rule 의 Status 가 Enabled 인지 확인합니다.
API Destination 상태 확인: API Destinations 목록에서 Status 가 Active 인지 확인합니다.
Connection 상태 확인: Connections 목록에서 Status 가 Authorized 인지 확인합니다.

모든 상태가 정상이면 실제 AWS Health 이벤트 발생 시 CloudOps 로 자동 전달됩니다.

CloudOps 측 확인

실제 Health 이벤트가 발생하면 CloudOps 콘솔에서 등록한 webhook source 의 Requests (24h) 카운트가 증가하는지 확인합니다.

Health 이벤트 유형

CloudOps 는 AWS Health 이벤트를 아래와 같이 분류합니다:

AWS eventTypeCategory	CloudOps Severity	CloudOps Event Type
`issue`	ERROR	ALERT
`scheduledChange`	WARNING	ALERT
`accountNotification`	INFO	ALERT

statusCode 가 closed 로 변경되면 CloudOps 는 해당 이벤트를 RECOVERY 로 처리합니다.