

# Monitorar a subutilização da Reserva de capacidade
<a name="cr-eventbridge"></a>

É possível monitorar a subutilização da Reserva de capacidade usando o seguinte:

**Topics**
+ [Eventos do Amazon EventBridge](#cr-underutilization-events)
+ [Notificações por e-mail e no painel do AWS Health](#monitor-cr-utilization)

## Eventos do Amazon EventBridge
<a name="cr-underutilization-events"></a>

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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) no *Amazon EventBridge User Guide*.

Para saber mais, consulte o [Guia do Usuário do Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/).

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

### Eventos
<a name="cr-eventbridge-events"></a>

O AWS Health enviará os eventos a seguir quando o uso de capacidade para uma reserva de capacidade estiver abaixo de 20%.
+ `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
<a name="cr-eventbridge-use"></a>

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](https://console.aws.amazon.com/sns/v3/home).

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

1. Em **Tipo**, escolha **Padrão**.

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

1. Escolha **Criar tópico**.

1. Selecione **Criar assinatura**.

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

1. Selecione **Criar assinatura**.

1. 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/](https://console.aws.amazon.com/events/).

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

1. Em **Nome**, digite um nome para a nova regra.

1. Em **Rule type**, escolha **Rule with an event pattern**.

1. Escolha **Próximo**.

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

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

   1. Em **Serviço da AWS**, escolha **AWS Health**.

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

1. Escolha **Próximo**.

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

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

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

   1. Em **Tópico**, escolha o tópico criado anteriormente.

1. Selecione **Próximo** e, em seguida, **Próximo** novamente.

1. Escolha **Criar regra**.

## Notificações por e-mail e no painel do AWS Health
<a name="monitor-cr-utilization"></a>

O AWS Health enviará o e-mail e as notificações do Health Dashboard a seguir quando a utilização da capacidade para reservas de capacidade em sua conta estiver abaixo de 20%.
+ Notificações individuais para cada reserva de capacidade recém-criada que esteve abaixo de 20% de utilização nas últimas 24 horas.
+ Uma notificação resumida para todas as reservas de capacidade que estiveram abaixo de 20% de utilização nos últimos sete dias.

As notificações por e-mail e as notificações do Health Dashboard serão enviadas para o endereço de e-mail associado à conta da AWS que tem as reservas de capacidade como propriedade. As notificações incluem as seguintes informações:
+ O ID da reserva de capacidade.
+ A zona de disponibilidade da reserva de capacidade.
+ A taxa de utilização média para a reserva de capacidade.
+ O tipo de instância e a plataforma (sistema operacional) da reserva de capacidade.

Além disso, quando a utilização da capacidade de uma reserva de capacidade em sua conta estiver abaixo de 20% em um período de 24 horas e sete dias, o AWS Health enviará eventos para o EventBridge. Com o EventBridge, é possível criar regras que ativam ações automáticas, como o envio de notificações por e-mail ou o acionamento de funções do AWS Lambda, em resposta a esses eventos. Para obter mais informações, consulte [Monitorar a subutilização da Reserva de capacidade](#cr-eventbridge).