Monitorar a utilização das reservas de capacidade usando o EventBridge

O AWS Health envia eventos para o Amazon EventBridge quando uma reserva de capacidade em sua conta está abaixo de 20% do uso em determinados períodos. Com o EventBridge, é possível estabelecer regras que acionam ações programáticas em resposta a tais eventos. Por exemplo, você pode criar uma regra que vai cancelar automaticamente uma reserva de capacidade quando a utilização estiver abaixo de 20% em um período de sete dias.

Os eventos no EventBridge são representados como objetos JSON. Os campos que são exclusivos do evento estão contidos na seção "detalhes" do objeto JSON. O campo "evento" contém o nome do evento. O campo "resultados" contém o status concluído da ação que acionou o evento. Para obter mais informações, consulte Amazon EventBridge event patterns no Amazon EventBridge User Guide.

Para obter mais informações, consulte o Guia do Usuário do Amazon EventBridge.

Não há suporte a este recurso na AWS GovCloud (US).

Eventos

O AWS Health enviará os eventos a seguir quando o uso de capacidade para uma reserva de capacidade estiver abaixo de 20%.

Eventos

• AWS_EC2_ODCR_UNDERUTILIZATION_NOTIFICATION
• AWS_EC2_ODCR_UNDERUTILIZATION_NOTIFICATION_SUMMARY

AWS_EC2_ODCR_UNDERUTILIZATION_NOTIFICATION

Veja a seguir um exemplo de evento gerado quando uma reserva de capacidade recém-criada está abaixo de 20% do uso da capacidade em um período de 24 horas.

{
    "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

Veja a seguir um exemplo de evento gerado quando uma ou mais reservas de capacidade estão abaixo de 20% do uso da capacidade em um período de sete dias.

{ 
    "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%" 
            }
        ]
    }
}

Criar uma regra de EventBridge

Para receber notificações por e-mail quando a utilização da reserva de capacidade estiver abaixo de 20%, crie um tópico do Amazon SNS e, em seguida, crie uma regra do EventBridge para o evento AWS_EC2_ODCR_UNDERUTILIZATION_NOTIFICATION.

Para criaro tópico do Amazon SNS

1. Abra o console do Amazon SNS em https://console.aws.amazon.com/sns/v3/home.

2. No painel de navegação, selecione Topics (Tópicos) e Create topic (Criar tópico).

3. Em Tipo, escolha Padrão.

4. Em Nome, digite um nome para o novo tópico.

5. Escolha Criar tópico.

6. Selecione Criar assinatura.

7. Em Protocolo, escolha E-mail e, em seguida, para Endpoint, insira o endereço de e-mail que receberá as notificações.

8. Selecione Criar assinatura.

9. O endereço de e-mail inserido acima receberá uma mensagem de e-mail com a seguinte linha de assunto: AWS Notification - Subscription Confirmation. Siga as instruções para confirmar sua assinatura.

Como criar a regra do EventBridge

1. Abra o console do Amazon EventBridge em https://console.aws.amazon.com/events/.

2. No painel de navegação, escolha Rules (Regras) e Create rule (Criar regras).

3. Em Nome, digite um nome para a nova regra.

4. Em Tipo de Regra, escolha Regra com Padrão de Evento.

5. Escolha Próximo.

6. Em Padrão de evento, faça o seguinte:

   1. Em Fonte do evento, selecione Serviços da AWS.

   2. Em Serviço da AWS, escolha AWS Health.

   3. Em Tipo de evento, escolha Notificação de subutilização de ODCR do EC2.

7. Escolha Próximo.

8. Em Destino 1, faça o seguinte:

   1. Em Tipos de destino, escolha Serviço da AWS.

   2. Em Select a target (Selecionar um destino), escolha SNS topic (Tópico do SNS).

   3. Em Tópico, escolha o tópico criado anteriormente.

9. Selecione Próximo e, em seguida, Próximo novamente.

10. Escolha Criar Regra.