Rotas de eventos

É possível rotear eventos para o destino configurando filtros em um gatilho do Eventarc. A configuração do gatilho varia conforme o tipo de evento. A rota do evento selecionada também depende do tipo de evento.

Tipos de evento

  • Eventos diretos de um provedor integrado do Google: o Eventarc pode rotear eventos diretos, como uma atualização de um objeto em um bucket do Cloud Storage ou uma atualização de um modelo da Configuração remota do Firebase. Veja a lista de eventos diretos compatíveis.

  • Registros de auditoria do Cloud e Eventarc: quando um registro de auditoria é criado e corresponde aos critérios de filtro do gatilho do Eventarc, os eventos são roteados, permitindo capturar e agir em eventos específicos. Consulte a lista de eventos de registro de auditoria compatíveis.

  • Pub/Sub e Eventarc: quando uma mensagem é publicada em um tópico do Pub/Sub especificado pelos critérios do filtro do Eventarc ("type=google.cloud.pubsub.topic.v1.messagePublished"), os eventos são roteados. É possível integrar o Eventarc a qualquer serviço capaz de publicar mensagens usando o Pub/Sub.

  • Envio direto do Pub/Sub: em vez de usar o Eventarc, use o Pub/Sub para enviar mensagens diretamente ao seu serviço. Isso é válido para aplicativos ou serviços que têm uma integração direta do Pub/Sub. Para mais informações, consulte Acionar via push do Pub/Sub.

Selecionar uma rota de evento

Para determinar a melhor forma de rotear seus eventos para um destino, faça as seguintes perguntas:

  1. O Eventarc é compatível com eventos diretos em relação ao evento que você quer rotear? Em caso afirmativo, crie um gatilho do Eventarc para rotear esse evento direto. Se não, considere a próxima pergunta (nº 2).

    Para o evento que você quer rotear, se as opções diretas e de registro de auditoria forem compatíveis, recomendamos criar um gatilho para rotear o evento direto. Os eventos diretos oferecem as vantagens a seguir em comparação com os eventos de registro de auditoria:

    • Melhor capacidade de resposta do gatilho e latência de entrega de eventos
    • Formatos de eventos com tipagem forte, que são mais previsíveis e detectáveis
    • Compatibilidade com filtragem de IDs de coleção (componentes do nome do recurso).
    • Não há custos adicionais por ativar os Registros de auditoria do Cloud

  2. Seu serviço ou aplicativo do Google é compatível com os Registros de auditoria do Cloud, o Pub/Sub ou com ambos?

  3. Se os Registros de auditoria do Cloud e o Pub/Sub forem compatíveis, qual dos dois fornecerá as informações necessárias? Por exemplo, o Cloud Build pode gerar registros de auditoria e mensagens do Pub/Sub. No entanto, o Pub/Sub pode fornecer notificações de status do build (sucesso ou falha), enquanto os registros de auditoria do Cloud Build podem fornecer informações sobre operações de criação e exclusão do build. Em alguns casos, o impacto do conteúdo e da latência dos registros de auditoria e das mensagens do Pub/Sub é similar, e você pode escolher qualquer um deles. Depois, considere a próxima pergunta (nº 4).

  4. Ao usar o Pub/Sub, há alguma vantagem em receber eventos por meio do Eventarc e um formato comum do CloudEvents? Por exemplo, existem várias origens de eventos? Embora você possa ter familiaridade com o push direto de mensagens do Pub/Sub, são recomendáveis a eficiência e a praticidade de um formato e mecanismo de entrega padrão.

A seguir