EventBridge を使用してキャパシティ予約の使用率をモニタリングする

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

EventBridge でのイベントは、JSON オブジェクトとして表されます。イベント固有のフィールドは、JSON オブジェクトの「detail (詳細)」セクションに表示されます。「event」 フィールドにはイベント名が入ります。「result」 フィールドには、イベントをトリガーしたアクションの完了したステータスが入ります。詳細については、「Amazon EventBridge ユーザーガイド」の「Amazon EventBridge のイベントパターン」を参照してください。

詳細については、「Amazon EventBridge ユーザーガイド」を参照してください。

この機能は AWS GovCloud (US) ではサポートされていません。

イベント

キャパシティ予約のキャパシティ使用率が 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 ルールを作成します

キャパシティ予約使用率が 20% を下回ったときに E メール通知を受け取るには、Amazon SNS トピックを作成してから、AWS_EC2_ODCR_UNDERUTILIZATION_NOTIFICATION イベントの EventBridge ルールを作成します。