Configurar o EventBridge para eventos do Systems Manager - AWS Systems Manager

Configurar o EventBridge para eventos do Systems Manager

Você pode usar o Amazon EventBridge para executar um evento de destino quando o status de AWS Systems Manager compatíveis for alterado, o estado mudar ou outras condições ocorrem. Você pode criar uma regra que será executada sempre que houver uma transição de estado ou status, ou quando houver uma transição para um ou mais estados que sejam de interesse.

O procedimento a seguir fornece etapas gerais para criar uma regra do EventBridge que se envolve quando um evento especificado é emitido pelo Systems Manager. Para obter uma lista de procedimentos neste manual do usuário que aborda cenários específicos, consulte Mais informações, no final deste tópico.

nota

Quando um serviço da Conta da AWS emite um evento, ele sempre vai para o barramento de eventos padrão da sua conta. Para escrever uma regra que responde a eventos de Serviços da AWS na sua conta, associe-a ao barramento de eventos padrão. Você pode criar uma regra em um barramento de eventos personalizado que procura eventos de Serviços da AWS, mas essa regra será acionada somente quando você receber esse evento de outra conta por meio da entrega de eventos entre contas. Para obter mais informações, consulte Enviar e receber eventos do Amazon EventBridge entre Contas da AWS no Guia do usuário do Amazon EventBridge.

Para configurar o EventBridge para eventos do Systems Manager
  1. Abra o console do Amazon EventBridge em https://console.aws.amazon.com/events/.

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

  3. Escolha Create rule.

  4. Insira um nome e uma descrição para a regra.

    Uma regra não pode ter o mesmo nome que outra regra na mesma Região da AWS e no mesmo barramento de eventos.

  5. Em Barramento de Eventos, escolha o barramento de eventos que você deseja associar a essa regra. Se você quiser que essa regra responda a eventos correspondentes provenientes da sua Conta da AWS, selecione default (padrão). Quando um AWS service (Serviço da AWS) na sua conta emite um evento, ele sempre vai para o barramento de eventos padrão da sua conta.

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

  7. Escolha Próximo.

  8. Em Event source, escolha Eventos da AWS ou eventos de parceiro do EventBridge.

  9. Na seção Event patter (Padrão de evento), selecione Event pattern form (Formulário de padrão de evento).

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

  11. Em Serviço da AWS, escolha Systems Manager.

  12. Em Event type (Tipo de evento), siga um destes procedimentos:

    • Escolha All Events (Todos os eventos).

      Se você selecionar All Events (Todos os eventos), todos os eventos emitidos pelo Systems Manager corresponderão à regra. Observe que essa opção pode resultar em muitas ações direcionadas ao evento.

    • Selecione o tipo de evento do Systems Manager a ser usado para essa regra. O EventBridge oferece suporte a eventos nos seguintes recursos do AWS Systems Manager:

      • Automação

      • Change Calendar

      • Conformidade

      • Inventário

      • Maintenance Windows

      • Parameter Store

      • Run Command

      • State Manager

      nota

      Para ações do Systems Manager, que não sejam compatíveis com o EventBridge, escolha uma chamada de API da AWS por meio do CloudTrail para criar uma regra de evento baseada em uma chamada de API, que é registrada pelo CloudTrail. Para ver um exemplo, consulte Monitorar as atividades da sessão usando o Amazon EventBridge (console).

  13. (Opcional) Para tornar a regra mais específica, adicione valores de filtros. Por exemplo, se você escolheu State Manager e deseja limitar a regra ao estado de uma instância única gerenciada que é direcionada por uma associação, para Specific type(s) (Tipos específicos), escolha EC2 State Manager Instance Association State Change (Alteração de estado da associação de instância do EC2 State Manager).

    Para obter detalhes completos sobre os tipos de detalhes compatíveis, consulte Referência: padrões e tipos de eventos do Amazon EventBridge para o Systems Manager.

    Alguns tipos de detalhes têm outras opções compatíveis, como status. As opções disponíveis dependem do recurso que você selecionou.

  14. Escolha Next (Avançar).

  15. Em Target types (Tipos de destinos), escolha AWS service (Serviço da ).

  16. Em Select a target (Selecione um destino), escolha um destino, como um tópico do Amazon SNS ou uma função do AWS Lambda. O destino é acionado quando é recebido um evento que corresponde ao padrão de evento definido na regra.

  17. Para muitos tipos de destino, o Eventbridge precisa de permissões para enviar eventos ao destino. Nesses casos, o Eventbridge pode criar a função do AWS Identity and Access Management (IAM) necessária para que sua regra seja executada.

    • Para criar um perfil do IAM automaticamente, escolha Criar novo perfil para este recurso específico.

    • Para usar um perfil do IAM criado anteriormente, escolha Usar função existente

  18. (Opcional) Selecione Adicionar outro destino para adicionar outro destino a essa regra.

  19. Escolha Next (Próximo).

  20. (Opcional) Insira uma ou mais tags para a regra. Para mais informações, consulte Tags Amazon EventBridge em Guia de Usuário Amazon EventBridge.

  21. Escolha Next (Próximo).

  22. Analise os detalhes da regra e selecione Criar regra.