Elastic Compute Service:Assine eventos do ECS rapidamente com o EventBridge

Informações básicas

Cenários

• Assine eventos específicos do ECS para acionar notificações via DingTalk, mensagens de texto ou e-mail.

• Envie eventos específicos do ECS para serviços HTTP ou HTTPS downstream pela internet ou por uma VPC.

• Agrupe eventos do ECS de várias contas da Alibaba Cloud.

• Dispare ações específicas usando o Function Compute quando ocorrer um evento determinado do ECS.

• Entregue eventos do ECS ao Simple Message Queue (formerly MNS) para assinatura em cenários com alta latência ou grande volume de eventos.

Pré-requisitos

• Activate EventBridge and grant permissions.

• Crie um robô do DingTalk e anote sua URL de webhook e chave.

• Crie um service e uma função. Para mais informações, consulte Manage services e Manage functions.

• Crie uma fila do Simple Message Queue (formerly MNS). Para mais informações, consulte Activate Simple Message Queue (formerly MNS) and grant permissions e Create a queue.

Etapa 1: Selecione o barramento de eventos dedicado a serviços da Alibaba Cloud

O barramento de eventos do sistema é o barramento default que o EventBridge cria automaticamente. Os serviços da Alibaba Cloud entregam eventos ao barramento default em tempo real. Nesse barramento, você localiza e assina eventos provenientes desses serviços.

Etapa 2: Crie uma regra de evento para eventos do ECS

1. Na página EventBridge, clique em Event Rules no painel de navegação à esquerda e, em seguida, clique em Create Rule.

2. No painel Create Rule, conclua as etapas a seguir.

   1. Na aba Configure Basic Info, insira um nome na caixa de texto Name e uma descrição na caixa de texto Description. Depois, clique em Next.

   2. Na aba Configure Event Pattern, configure o padrão de evento. Em seguida, clique em Next.

      • Clique na aba Alibaba Cloud Service Event Sources.

      • Na lista suspensa Event Source, selecione acs.ecs.

      • Na lista suspensa Event Type, escolha os tipos de evento que deseja assinar. É possível selecionar vários tipos.

      • Na seção Event Pattern Debugging, visualize um exemplo correspondente ao tipo de evento selecionado. Por exemplo, ao escolher ecs.Instance.StateChange for instance lifetime status changes, o sistema exibe o seguinte exemplo:

        {
          "id": "45ef4dewdwe1-7c35-447a-bd93-fab****",
          "source": "acs.ecs",
          "specversion": "1.0",
          "subject": "acs.ecs:cn-hangzhou:123456789098****:215672",
          "time": "2020-11-19T21:04:41Z",
          "type": "ecs:Instance:StateChange",
          "aliyunaccountid": "123456789098****",
          "aliyunpublishtime": "2020-11-19T21:04:42Z",
          "aliyuneventbusname": "default",
          "aliyunregionid": "cn-hangzhou",
          "aliyunpublishaddr": "172.25.XX.XX",
          "data": {
            "instanceName": "iZ0jl0kyquo46h****",
            "instanceType": "ecs.c6.large",
            "privateIpAddress": "172.21.XX.XX",
            "publicIpAddress": "8.37.XX.XX",
            "resourceId": "i-0jl0kyquo46****",
            "resourceType": "ALIYUN::ECS::Instance",
            "spotStrategy": "SpotWithPriceLimit",
            "state": "Running"
          }
        }

   3. Na aba Configure Targets, selecione um Service Type e configure o cenário de envio.

      Cenário 1: Envio para o Simple Message Queue (formerly MNS)

      O Simple Message Queue (formerly MNS) permite assinar eventos em cenários com alta latência ou grande volume de eventos. Para mais detalhes sobre o faturamento do Simple Message Queue (formerly MNS), consulte Billing.

      • Service Type: Selecione Simple Message Queue (formerly MNS).

      • Queue: Escolha a fila criada anteriormente.

      • Message Body: Selecione Complete Event.

      • Enable Base64 Decoding: Marque Yes. Ao ativar a codificação Base64, os dados são codificados antes da entrega à fila de destino no Simple Message Queue (formerly MNS).

      Se você definir Service Type como Simple Message Queue (formerly MNS), utilize o arquivo NetworkInterfaceDemo.zip para escutar mensagens do Simple Message Queue (formerly MNS) e recuperar os eventos.

      Cenário 2: Envio para o DingTalk

      • Service Type: Selecione DingTalk.

      • Address: Insira a URL de webhook do robô do DingTalk.

      • Secret Key: Insira a chave do robô do DingTalk.

      • Pushed Content: Utilize o recurso de modelo do EventBridge para enviar parâmetros do evento ao robô do DingTalk. Por exemplo, para enviar o nome da instância (instanceName) e o estado de execução (state) de uma instância ECS, configure os seguintes parâmetros:

        • Parameters: Use uma expressão JSONPath para especificar os campos que deseja extrair do evento e defina nomes de variáveis.

          {
            "instanceName":"$.data.instanceName",
            "state":"$.data.state"
          }

        • Template: Defina um modelo no formato exigido pelo robô do DingTalk e referencie as variáveis definidas.

          {
            "msgtype": "text",
            "text": {
                "content": "${instanceName} state is ${state}" 
            } 
          }

      Cenário 3: Envio para um service HTTP downstream

      • Service Type: Selecione HTTP ou HTTPS.

      • URL: Configure a URL para receber os eventos.

      • Body: Defina o formato do conteúdo do evento. O EventBridge transforma eventos e os envia a um destino HTTP no formato necessário. Os formatos de transformação suportados incluem: Complete Event, Partial Event, Static Field e Template. Para mais informações, consulte Event transformation.

      • Network Type:

        • Internet: Acessa a URL de destino pela internet.

        • VPC: Escolha esta opção se a URL de destino não estiver exposta à internet. É necessário especificar o ID da VPC, o ID do vSwitch e o ID do grupo de segurança.

      Cenário 4: Disparar uma ação após o envio

      Para disparar uma ação mais personalizada quando ocorrer um evento do ECS, defina o tipo de service como Function Compute. Assim, o evento chega a uma função específica onde você escreve código no Function Compute para definir a ação personalizada.

      • Service Type: Selecione Function Compute.

      • Service: Nome do service criado no Function Compute.

      • Function: Nome da função criada no Function Compute.

      • Event: Configure o formato do conteúdo do evento. O EventBridge transforma eventos e os envia ao Function Compute no formato necessário. Os modelos de transformação suportados são: Complete Event, Partial Event, Static Field e Template. Para mais informações, consulte Event transformation.

      • Invocation Mode:

        • Síncrono: o Function Compute recebe o evento e a solicitação é considerada bem-sucedida após o processamento pela função.

        • Assíncrono: a solicitação é considerada bem-sucedida assim que o Function Compute recebe o evento.

        Para mais informações, consulte Route to Function Compute.

      Cenário 5: Agregar eventos do ECS de várias contas da Alibaba Cloud

      O EventBridge agrega eventos do ECS de diferentes contas e regiões em um único barramento de eventos, em uma conta e região específicas. Para isso, defina o tipo de service como EventBridge Event Bus.

      • Destination Type:

        • Same-account Event Bus: Entrega eventos a outro barramento na conta atual.

        • Cross-account Event Bus: Entrega eventos a um barramento em outra conta. Ao escolher esta opção, conceda as permissões necessárias. Para mais informações, consulte Route events to EventBridge.

      • Region: A entrega entre regiões é suportada entre regiões na China continental e entre regiões fora da China continental.

      • Event Bus: Nome do barramento de eventos de destino.

      • Event: Por padrão, o evento completo é entregue. Essa configuração não pode ser alterada.

      Na parte inferior da aba Configure Targets, configure uma política de nova tentativa e uma fila de mensagens mortas conforme necessário. Para mais informações, consulte Retries and dead-letter queues.

      Para mais detalhes sobre outros cenários, consulte Tipos de service de destino.

Etapa 3: Dispare um evento

Este tópico usa o tipo de evento ecs.Instance.StateChange (alterações de status durante o ciclo de vida da instância) como exemplo. Para disparar esse evento, altere o status de execução de uma instância ECS.

1. Faça login no console do ECS.

2. No painel de navegação à esquerda, escolha Instances & Images > Instance.

3. Na barra de navegação superior, selecione a região onde o recurso de destino está localizado.

4. Localize a instância ECS desejada. Na coluna Actions, escolha > Instance Status e altere o status de execução da instância.

Etapa 4: Visualize o resultado da entrega

1. Verifique se um evento do ECS foi gerado.

   O EventBridge permite buscar eventos do ECS por intervalo de tempo, tipo de evento, nome da regra ou ID do evento. O ID do evento corresponde ao ID do evento do ECS. Para mais informações, consulte Query events.

2. Verifique o resultado da entrega da assinatura de eventos do ECS.

   Com o ID do evento obtido na etapa anterior, clique em Event Trace na coluna Actions para visualizar o rastreamento de envio do evento. Esse rastreamento inclui detalhes como destino, status, quantidade de envios e horário. Os detalhes do Event Trace mostram:

   • Recepção do evento: a source do evento é Elastic Compute Service (ECS) acs.ecs, o tipo de evento é ecs:Instance:StateChange e o barramento de eventos é default.

   • Entrega do evento: o nome da regra é test, com 1 destino bem-sucedido, 0 destinos com falha e 1 entrega total. O destino da entrega é a URL de webhook do robô do DingTalk, o status da entrega é Succeeded, a latência de entrega é de 258 milissegundos e a resposta da entrega é [200]NoMessage.

Monitoramento e alertas de eventos

No painel de monitoramento do EventBridge, visualize o número de chamadas, a taxa de sucesso de envio e a latência de envio da tarefa de assinatura de eventos do ECS criada. Também é possível configurar políticas de alerta conforme seus cenários de negócios.

Na página de monitoramento, defina regras de alerta para recursos do EventBridge. Quando um recurso atender às condições de uma regra de alerta, o CloudMonitor envia automaticamente uma notificação de alerta. Para mais informações, consulte Set alert rules.

Novas tentativas e filas de mensagens mortas

Após a gravação de um evento em um barramento de eventos, o EventBridge garante que o evento seja enviado ao service downstream pelo menos uma vez. Caso o receptor downstream não consiga receber o evento devido a exceções como indisponibilidade, falha no service ou instabilidade de rede, o EventBridge oferece várias formas de lidar com essas situações, incluindo políticas de nova tentativa, políticas de tolerância a falhas e filas de mensagens mortas. Configure políticas de nova tentativa e de fila de mensagens mortas em Step 2: Create an event rule for ECS events para assegurar a entrega correta dos eventos.