

# 용량 예약 사용률 저하 모니터링
<a name="cr-eventbridge"></a>

다음을 사용하여 용량 예약 사용률 저하를 모니터링할 수 있습니다.

**Topics**
+ [Amazon EventBridge 이벤트](#cr-underutilization-events)
+ [이메일 및 AWS Health 대시보드 알림](#monitor-cr-utilization)

## Amazon EventBridge 이벤트
<a name="cr-underutilization-events"></a>

계정의 용량 예약의 사용량이 일정 기간 동안 20% 미만이면 AWS Health가 Amazon EventBridge로 이벤트를 전송합니다. EventBridge에서는 이러한 이벤트에 대한 응답으로 프로그래밍 작업을 트리거하는 규칙을 설정할 수 있습니다. 예를 들어 7일 동안 사용률이 20% 미만인 용량 예약을 자동으로 취소하는 규칙을 생성할 수 있습니다.

EventBridge의 이벤트는 JSON 객체로 표현됩니다. 이 이벤트에 고유한 필드는 JSON 객체의 "세부 정보" 섹션에 포함되어 있습니다. "이벤트" 필드에는 이벤트 이름이 포함됩니다. "결과" 필드에는 이벤트를 트리거한 작업의 완료 상태가 포함됩니다. 자세한 내용은 *Amazon EventBridge 사용 설명서*의 [Amazon EventBridge 이벤트 패턴](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html)을 참조하세요.

자세한 내용은 [Amazon EventBridge 사용 설명서](https://docs.aws.amazon.com/eventbridge/latest/userguide/)를 참조하세요.

이 기능은 AWS GovCloud (US)에서 지원되지 않습니다.

### 이벤트
<a name="cr-eventbridge-events"></a>

용량 예약의 용량 사용량이 20% 미만이면 AWS Health가 다음 이벤트를 전송합니다.
+ `AWS_EC2_ODCR_UNDERUTILIZATION_NOTIFICATION`

  다음은 새로 생성된 용량 예약의 용량 사용량이 24시간 동안 20% 미만일 경우 생성되는 이벤트의 예입니다.

  ```
  {
      "version": "0",
      "id": "b3e00086-f271-12a1-a36c-55e8ddaa130a",
      "detail-type": "AWS Health Event",
      "source": "aws.health",
      "account": "123456789012",
      "time": "2023-03-10T12:03:38Z",
      "region": "ap-south-1",
      "resources": [
          "cr-01234567890abcdef"
      ],
      "detail": {
          "eventArn": "arn:aws:health:ap-south-1::event/EC2/AWS_EC2_ODCR_UNDERUTILIZATION_NOTIFICATION/AWS_EC2_ODCR_UNDERUTILIZATION_NOTIFICATION_cr-01234567890abcdef-6211-4d50-9286-0c9fbc243f04",
          "service": "EC2",
          "eventTypeCode": "AWS_EC2_ODCR_UNDERUTILIZATION_NOTIFICATION",
          "eventTypeCategory": "accountNotification",
          "startTime": "Fri, 10 Mar 2023 12:03:38 GMT",
          "endTime": "Fri, 10 Mar 2023 12:03:38 GMT",
          "eventDescription": [
              {
                  "language": "en_US",
                  "latestDescription": "{{A description of the event will be provided here}}"
              }
          ],
          "affectedEntities": [
              {
                  "entityValue": "cr-01234567890abcdef"
              }
          ]
      }
      }
  ```
+ `AWS_EC2_ODCR_UNDERUTILIZATION_NOTIFICATION_SUMMARY`

  다음은 새로 생성된 용량 예약 중 하나 이상의 용량 사용량이 7일 동안 20% 미만일 경우 생성되는 이벤트의 예입니다.

  ```
  { 
      "version": "0", "id":"7439d42b-3c7f-ad50-6a88-25e2a70977e2", 
      "detail-type": "AWS Health Event", 
      "source": "aws.health", 
      "account": "123456789012", 
      "time": "2023-03-07T06:06:01Z", 
      "region": "us-east-1", 
      "resources": [ 
          "cr-01234567890abcdef | us-east-1b | t3.medium | Linux/UNIX | 0.0%", 
          "cr-09876543210fedcba | us-east-1a | t3.medium | Linux/UNIX | 0.0%" 
      ], 
      "detail": { 
          "eventArn": "arn:aws:health:us-east-1::event/EC2/AWS_EC2_ODCR_UNDERUTILIZATION_NOTIFICATION_SUMMARY/AWS_EC2_ODCR_UNDERUTILIZATION_NOTIFICATION_SUMMARY_726c1732-d6f6-4037-b9b8-bec3c2d3ba65", 
          "service": "EC2", 
          "eventTypeCode": "AWS_EC2_ODCR_UNDERUTILIZATION_NOTIFICATION_SUMMARY", 
          "eventTypeCategory": "accountNotification", 
          "startTime": "Tue, 7 Mar 2023 06:06:01 GMT", 
          "endTime": "Tue, 7 Mar 2023 06:06:01 GMT", 
          "eventDescription": [
              { 
                  "language": "en_US", 
                  "latestDescription": "{{A description of the event will be provided here}}" 
              }
          ], 
          "affectedEntities": [
              { 
                  "entityValue": "cr-01234567890abcdef | us-east-1b | t3.medium | Linux/UNIX | 0.0%" 
              }, 
              { 
                  "entityValue": "cr-09876543210fedcba | us-east-1a | t3.medium | Linux/UNIX | 0.0%" 
              }
          ]
      }
  }
  ```

### EventBridge 규칙 생성
<a name="cr-eventbridge-use"></a>

용량 예약 사용률이 20% 미만으로 떨어질 경우 이메일 알림을 받으려면 Amazon SNS 주제를 생성한 다음 `AWS_EC2_ODCR_UNDERUTILIZATION_NOTIFICATION` 이벤트에 대한 EventBridge 규칙을 생성합니다.

**Amazon SNS 주제를 생성하려면**

1. [https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home)에서 Amazon SNS 콘솔을 엽니다.

1. 탐색 창에서 **토픽**을 선택한 다음, **토픽 생성**을 선택합니다.

1. **유형**에서 **표준**을 선택합니다.

1. **이름**에 새 주제의 이름을 입력합니다.

1. **주제 생성**을 선택합니다.

1. **구독 생성**을 선택합니다.

1. **프로토콜**에서 **이메일**을 선택한 다음 **엔드포인트**에 알림을 받는 데 사용할 이메일 주소를 입력합니다.

1. **구독 생성**을 선택합니다.

1. 위에 입력한 이메일 주소로 `AWS Notification - Subscription Confirmation`(이)라는 제목의 이메일 메시지를 받게 됩니다. 지시에 따라 구독을 확인합니다.

**EventBridge 규칙을 만들려면**

1. [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/)에서 Amazon EventBridge 콘솔을 엽니다.

1. 탐색 창에서 **규칙(Rules)**을 선택한 후 **규칙 생성(Create rule)**을 선택합니다.

1. **이름**에 새 규칙의 이름을 입력합니다.

1. **규칙 유형(Rule type)**에서 **이벤트 패턴이 있는 규칙(Rule with an event pattern)**을 생성합니다.

1. **다음**을 선택합니다.

1. **이벤트 패턴**에서 다음을 수행합니다.

   1. **이벤트 소스**에서 **AWS 서비스**를 선택합니다.

   1. **AWS 서비스**에서 **AWS Health**를 선택합니다.

   1. **이벤트 유형**에서 **EC2 ODCR 사용률 부족 알림**을 선택합니다.

1. **다음**을 선택합니다.

1. **대상 1**에서 다음을 수행합니다.

   1. **대상 유형**에서 **AWS서비스**를 선택합니다.

   1. **대상 선택**에서 **SNS 주제**를 선택합니다.

   1. **주제**에서 앞서 생성한 주제를 선택합니다.

1. **다음**을 선택한 후 **다음**을 다시 한번 선택합니다.

1. **규칙 생성**을 선택합니다.

## 이메일 및 AWS Health 대시보드 알림
<a name="monitor-cr-utilization"></a>

계정에서 용량 예약의 용량 사용률이 20% 미만으로 떨어지면 AWS Health가 다음 이메일과 Health Dashboard 알림을 보냅니다.
+ 새로 생성된 각 용량 예약 중 지난 24시간 동안 사용률이 20% 미만인 각 용량 예약에 대한 개별 알림.
+ 지난 7일 동안 사용률이 20% 미만인 모든 용량 예약에 대한 요약 알림.

이메일 알림과 Health Dashboard 알림은 용량 예약을 소유한 AWS 계정에 연결된 이메일 주소로 전송됩니다. 이 알림에는 다음 정보가 포함됩니다.
+ 용량 예약의 ID입니다.
+ 용량 예약의 가용 영역.
+ 용량 예약의 평균 사용률.
+ 용량 예약의 인스턴스 유형 및 플랫폼(운영 체제).

또한 계정에서 용량 예약의 용량 사용률이 24시간과 7일 동안 20% 미만이면 AWS Health가 EventBridge로 이벤트를 전송합니다. EventBridge를 사용하면, 이메일 알림을 전송하거나 AWS Lambda 함수를 트리거하는 등의 자동 작업을 이러한 이벤트에 대한 응답으로 설정하는 규칙을 만들 수 있습니다. 자세한 내용은 [용량 예약 사용률 저하 모니터링](#cr-eventbridge) 섹션을 참조하세요.