Como configurar uma regra do EventBridge para enviar notificações sobre eventos no AWS Health

Você pode criar uma regra do EventBridge para ser notificado para eventos AWS Health da sua conta. Antes de criar regras de eventos AWS Health, faça o seguinte:

• Familiarize-se com os eventos, regras e destinos no EventBridge. Para obter mais informações, consulte O que é o Amazon EventBridge? no Guia do usuário do Amazon EventBridge e no novo EventBridge: acompanhe e responda às mudanças em seus recursos de AWS.

• Crie os destinos para usar em suas regras de evento.

Para criar uma regra do EventBridge para o AWS Health

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

2. Para alterar a Região da AWS, use o Seletor de regiões no canto superior direito da página. Selecione uma região na qual você deseja rastrear eventos do AWS Health.

3. No painel de navegação, escolha Regras.

4. Escolha Criar regra.

5. Na página Definir detalhe de regra, insira um nome e uma descrição para sua regra.

6. Mantenha os valores padrão do Barramento de eventos e Tipo de regra e, depois, escolha Próximo.

7. Na página Criar padrão de evento, em Origem do evento, escolha AWS Eventos da ou eventos de parceiros do EventBridge.

8. Em Origem do evento, para Padrão do evento selecione Serviços da AWS.

9. Em Padrão de evento, para AWS service (Serviço da AWS), escolha Saúde.

10. Em Tipo de evento, selecione uma das seguintes opções:

    • Eventos específicos de abuso de saúde: Crie uma regra para eventos AWS Health que tenham a palavra Abuse no nome do tipo de evento.

    • Eventos específicos de saúde: Crie uma regra para eventos específicos AWS service (Serviço da AWS), como o Amazon EC2.

11. Você pode escolher Qualquer serviço ou Serviços específicos. Se você escolher um serviço específico, escolha uma das seguintes opções:

    • Selecione Qualquer categoria de tipo de evento para criar uma regra que se aplica a todas as categorias de tipo de evento.

    • Escolha categorias específicas do tipo de evento e, em seguida, escolha um valor na lista, como problema, accountNotification ou ScheduledChange.

    dica

    • Para monitorar todos os eventos do AWS Health de um serviço específico, recomendamos que você escolha Qualquer categoria de tipo de evento e Qualquer recurso. Isso garante que sua regra monitore todos os eventos do AWS Health, incluindo novos códigos de tipo de evento, para o serviço especificado. Para ver um exemplo de regra, consulte todos os eventos do Amazon EC2.

    • Você pode criar uma regra para monitorar mais de uma categoria de serviço ou de tipo de evento. Para fazer isso, você deve atualizar manualmente o padrão de eventos da regra. Para ter mais informações, consulte Criação de uma regra para vários serviços e categorias.

12. Se você escolheu uma categoria específica de serviço e tipo de evento, escolha uma das seguintes opções para códigos de tipo de evento.

    • Selecione Qualquer código de tipo de evento para criar uma regra que se aplica a todos os códigos de tipos de evento.

    • Selecione códigos específicos de tipo de evento e, em seguida, escolha um ou mais valores da lista. Isso cria uma regra que se aplica somente a códigos de tipo de evento específicos. Por exemplo, se você escolher AWS_EC2_INSTANCE_STOP_SCHEDULEDe AWS_EC2_INSTANCE_RETIREMENT_SCHEDULED, sua regra se aplicará somente a esses eventos quando eles ocorrerem em sua conta.

13. Escolha uma das seguintes opções para os recursos afetados.

    • Escolha Qualquer ID do recurso para criar uma regra que se aplica a todos os recursos.

    • Escolha recursos específicos e insira as IDs de um ou mais recursos. Por exemplo, você pode especificar um ID de instância do Amazon EC2, como i-ExampleA1B2C3DE4, para monitorar eventos que afetam somente esse recurso.

14. Analise a configuração da regra para garantir que ela atenda aos requisitos de monitoramento de eventos.

15. Escolha Próximo.

16. Na página Selecionar destinos, escolha o tipo de destino criado para essa regra e, em seguida, configure quaisquer opções adicionais necessárias para esse tipo. Por exemplo, você pode enviar o evento para uma fila do Amazon SQS ou a um tópico do Amazon SNS.

17. Escolha Próximo.

18. (Opcional) Na página Configurar tags, adicione tags e escolha Próximo.

    • Observação: no momento, as tags não são enviadas pela fonte aws.health no EventBridge.

19. Na página Revisar e criar, analise a configuração da regra e garanta que ela atenda aos requisitos de monitoramento de eventos.

20. Escolha Criar regra.

exemplo : regra para todos os eventos do Amazon EC2

O exemplo a seguir cria uma regra para que o EventBridge monitore todos os eventos do Amazon EC2, incluindo categorias de tipos de eventos, códigos de eventos e recursos.

exemplo : Regra para eventos específicos do Amazon EC2

O exemplo a seguir cria uma regra para que o EventBridge monitore o seguinte:

• O serviço do Amazon EC2

• A categoria do tipo do evento de ScheduledChange

• Os códigos de tipo de evento para AWS_EC2_INSTANCE_TERMINATION_SCHEDULED e AWS_EC2_INSTANCE_RETIREMENT_SCHEDULED

• A instância com o ID i-EXAMPLEa1b2c3de4

Criação de uma regra para vários serviços e categorias

Os exemplos do procedimento anterior mostram como criar uma regra para uma única categoria de serviço e tipo de evento. Você também pode criar uma regra para vários serviços e categorias de tipos de eventos. Isso significa que você não precisa criar uma regra separada para cada serviço e categoria que você deseja monitorar. Para isso, você deve criar uma lista de funções.

Você pode usar uma das opções a seguir:

Para adicionar serviços e categorias a uma regra existente

1. No console do EventBridge, na página Regras, escolha o nome da regra.

2. No canto superior direito, escolha Editar.

3. Escolha Próximo.

4. Em Padrão de evento, escolha Editar padrão e, em seguida, insira suas alterações no campo de texto.

5. Escolha Avançar até chegar à página Revisar e atualizar.

6. Escolha Atualizar regra para salvar suas alterações.

Para adicionar serviços e categorias a uma nova regra

1. Para fazer isso, siga o procedimento em Como configurar uma regra do EventBridge para enviar notificações sobre eventos no AWS Health para a etapa 9.

2. Em vez de escolher um único serviço ou categoria nas listas, em Padrão de evento, escolha Editar padrão.

3. Insira suas alterações no campo de texto. Consulte o exemplo de padrão a seguir como modelo para criar seu próprio padrão de evento.

4. Revise seu padrão de eventos e siga o restante do procedimento Como configurar uma regra do EventBridge para enviar notificações sobre eventos no AWS Health para criar sua regra.

Use a API ou AWS Command Line Interface (AWS CLI)

Para uma regra nova ou existente, use a operação da API PutRule ou o aws events put-rule comando para atualizar o padrão do evento. Para ver um exemplo de comando AWS CLI, consulte put-rule na Referência de Comando de AWS CLI.

exemplo Exemplo: vários serviços e categorias de tipos de eventos

O padrão de evento a seguir cria uma regra para monitorar eventos para as categorias de tipo de eventoissue,accountNotification, e scheduledChange para três serviços de AWS: Amazon EC2, Amazon EC2 Auto Scaling e Amazon VPC.

{
  "detail": {
    "eventTypeCategory": [
      "issue",
      "accountNotification",
      "scheduledChange"
    ],
    "service": [
      "AUTOSCALING",
      "VPC",
      "EC2"
    ]
  },
  "detail-type": [
    "AWS Health Event"
  ],
  "source": [
    "aws.health"
  ]
}