

# キャパシティ予約の低使用率をモニタリングする
<a name="cr-eventbridge"></a>

以下を使用して、キャパシティ予約の低使用率をモニタリングできます。

**Topics**
+ [Amazon EventBridge イベント](#cr-underutilization-events)
+ [E メールと AWS Health ダッシュボードの通知](#monitor-cr-utilization)

## Amazon EventBridge イベント
<a name="cr-underutilization-events"></a>

アカウントのキャパシティ予約の使用率が特定の期間に 20% を下回ると、AWS Health は Amazon EventBridge にイベントを送信します。EventBridge を使用することで、このようなイベントに対応するプログラム的なアクションをトリガーするルールを設定できます。例えば、7 日間の利用率が 20% を下回った場合に、キャパシティ予約を自動的にキャンセルするルールを作成できます。

EventBridge でのイベントは、JSON オブジェクトとして表されます。イベント固有のフィールドは、JSON オブジェクトの「detail (詳細)」セクションに表示されます。「event」 フィールドにはイベント名が入ります。「result」 フィールドには、イベントをトリガーしたアクションの完了したステータスが入ります。詳細については、「*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) ではサポートされていません。

### Events
<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`

  次の例は、1 つまたは複数のキャパシティ予約の 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% を下回ったときに E メール通知を受け取るには、Amazon SNS トピックを作成してから、`AWS_EC2_ODCR_UNDERUTILIZATION_NOTIFICATION` イベントの EventBridge ルールを作成します。

**Amazon SNS トピックを作成するには**

1. Amazon SNS コンソールの [https://console.aws.amazon.com/sns/v3/home](https://console.aws.amazon.com/sns/v3/home) を開いてください。

1. ナビゲーションペインで、[**Topics (トピック)**]、[**Create topic (トピックの作成)**] の順に選択してください。

1. [**Type (タイプ)**] で、[**Standard (標準)**] を選択してください。

1. **[名前]** に新しいトピックの名前を入力してください。

1. **[トピックの作成]** を選択してください。

1. [**Create subscription**] を選択してください。

1. **[プロトコル]** で **[E メール]** を選択し、次に **[エンドポイント]** に通知を受信する E メールアドレスを入力してください。

1. [**Create subscription**] を選択してください。

1. 上記で入力した E メールアドレスには、「`AWS Notification - Subscription Confirmation`」という件名の E メールメッセージが届きます。指示に沿って操作し、登録を確認します。

**EventBridge ルールを作成するには**

1. Amazon EventBridge コンソールの [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/) を開いてください。

1. ナビゲーションペインで、[**Rules** (ルール)] を選択し、[**Create rule** (ルールの作成)] を選択してください。

1. **[名前]** に新しいルールの名前を入力してください。

1. **[ルールタイプ]** で、**[イベントパターンを持つルール]** を選択してください。

1. [**Next**] を選択してください。

1. **[イベントパターン]** では、次のいずれかを実行します。

   1. **[イベントソース]** で、**[AWS のサービス]** を選択してください。

   1. **[AWS のサービス]** で、**[AWS Health]** を選択してください。

   1. **[イベントタイプ]** で、**[EC2 ODCR 低使用率通知]** を選択してください。

1. [**Next**] を選択してください。

1. **[ターゲット 1]** で、以下を実行します。

   1. **[ターゲットタイプ]** で、**[AWS のサービス]** を選択してください。

   1. **[Select a target]** (ターゲットの選択) には、**[SNS topic]** (SNS トピック) を選択してください。

   1. **[トピック]** で、以前に作成したトピックを選択してください。

1. **[次へ]** を選択し、もう一度 **[次へ]** を選択してください。

1. [**Create rule**] を選択してください。

## E メールと AWS Health ダッシュボードの通知
<a name="monitor-cr-utilization"></a>

アカウントのキャパシティ予約のキャパシティ使用率が 20% を下回ると、AWS Health は次の E メールと Health Dashboard 通知を送信します。
+ 新しく作成されたキャパシティ予約のうち、直近の 24 時間の使用率が 20% を下回ったものについての個別通知です。
+ 直近の 7 日間の使用率が 20% を下回ったすべてのキャパシティ予約の概要通知です。

E メール通知および Health Dashboard 通知は、キャパシティ予約を所有する AWS アカウントに関連付けられている E メールアドレスに送信されます。通知には、次の情報が含まれます。
+ キャパシティ予約の ID。
+ キャパシティ予約のアベイラビリティーゾーン。
+ キャパシティ予約の平均使用率。
+ キャパシティ予約のインスタンスタイプとプラットフォーム (オペレーティングシステム)。

さらに、アカウントのキャパシティ予約の 24 時間のキャパシティ使用率と 7 日間のキャパシティ使用率が 20% を下回ると、AWS Health はイベントを EventBridge に送信します。EventBridge では、このようなイベントに応じて、E メール通知の送信や AWS Lambda 関数のトリガーなどの自動アクションをアクティブにするルールを作成できます。詳細については、「[キャパシティ予約の低使用率をモニタリングする](#cr-eventbridge)」を参照してください。