Entrega push da Grade de Eventos do Azure – Conceitos

Este artigo descreve os conceitos da Grade de Eventos principal relacionados à entrega por push.

Eventos

Um evento é a menor quantidade de informações que descreve por completo algo que aconteceu em um sistema. Cada evento tem informações comuns como o source, o time em que o evento ocorreu, e um identificador exclusivo. Cada evento também tem informações específicas que são relevantes apenas para o tipo específico de evento. Por exemplo, um evento sobre um novo arquivo que está sendo criado no Armazenamento do Azure traz detalhes sobre o arquivo, como o valor lastTimeModified. Um evento dos Hubs de Eventos tem a URL do arquivo de Captura. Um evento sobre uma nova ordem no seu microsserviço Pedidos pode ter um atributo orderId e um atributo URL à representação de estado da ordem.

CloudEvents

A Grade de Eventos usa a especificação CloudEvents 1.0 padrão aberta do (CNCF) CloudEvents 1.0 com a associação de protocolo HTTP e o formato JSON. CloudEvents é uma especificação de evento extensível com extensões documentadas para requisitos específicos. CloudEvents é o formato de evento preferencial devido a seus casos de uso bem documentados (modos para transferir eventos, formatos de evento e muito mais), extensibilidade e interoperabilidade aprimorada. O CloudEvents aprimora a interoperabilidade, fornecendo um formato comum de evento para publicar e consumir eventos. Ele permite ferramentas uniformes e formas padrão de roteamento e tratamento de eventos.

A seguinte tabela mostra o suporte atual para a especificação CloudEvents:

O tamanho máximo permitido para um evento é 1 MB. Eventos acima de 64 KB são cobrados em incrementos de 64 KB. Para obter as propriedades que são enviadas em um evento, consulte Esquema de CloudEvents.

Outros formatos

A Grade de Eventos também dá suporte ao formato de esquema proprietário da Grade de Eventos para editores de eventos do sistema. Configure a Grade de Eventos para fornecer eventos usando o formato CloudEvents.

Publicadores

Um editor é o aplicativo que envia eventos para a Grade de Eventos. Pode ser o mesmo aplicativo em que os eventos se originaram, a fonte do evento. Os serviços do Azure publicam eventos na Grade de Eventos para anunciar uma ocorrência nos respectivos serviços. Você pode publicar eventos em seu próprio aplicativo. As organizações que hospedam serviços fora do Azure também podem publicar eventos por meio da Grade de Eventos.

Origens de eventos

A origem de um evento é onde o evento acontece. Cada origem do evento está relacionada a um ou mais tipos de evento. Por exemplo, o Armazenamento do Azure é a origem dos eventos criados pelo blob. O Hub IoT é a origem do evento para os eventos criados pelo dispositivo. Seu aplicativo é a origem dos eventos personalizados definidos. As origens do evento são responsáveis por enviar eventos para a Grade de Eventos.

Parceiros

Um parceiro é uma espécie de publicador que envia eventos de seu sistema para disponibilizá-los aos clientes do Azure. Um parceiro normalmente é um provedor de SaaS (Software como um Serviço) ou de ERP (Enterprise Resource Planning) que se integra à Grade de Eventos do Azure para ajudar os clientes a implementar casos de uso baseados em eventos em diversas plataformas. Os parceiros não só podem publicar eventos em Grade de Eventos do Azure, mas também podem receber eventos dele. Esses recursos são habilitados por meio do recurso Eventos do Parceiro.

Tópicos

Um tópico contém eventos que você publica na Grade de Eventos. Normalmente, você usa um recurso de tópico para uma coleção de eventos relacionados. Para responder a determinados tipos de eventos, os assinantes (um serviço do Azure ou outros aplicativos) decidem os tópicos que eles vão assinar. Há vários tipos de tópicos: tópicos personalizados, tópicos do sistema e tópicos de parceiros.

Tópicos personalizados

Tópicos personalizados também são tópicos que você usa com seus aplicativos. Eles foram o primeiro tipo de tópicos projetados para criar integrações orientadas a eventos para aplicativos personalizados. Como um recurso independente, eles expõem seu próprio ponto de extremidade para o qual você publica eventos.

Os tópicos personalizados dão suporte à entrega push. Consulte quando usar a entrega push ou pull para ajudar a decidir se a entrega push é a abordagem certa, considerando seus requisitos. Talvez você também queira se referir ao artigo Tópicos personalizados.

Tópicos do sistema

Os Tópicos do sistema são tópicos internos fornecidos pelos serviços do Azure, como Armazenamento do Azure, Hubs de Eventos do Azure e Barramento de Serviço do Azure. Você pode criar tópicos do sistema em sua assinatura do Azure e assiná-los. Para obter mais informações, consulte Visão geral dos tópicos do sistema.

Tópicos de parceiros

Os tópicos do parceiro são um tipo de tópico usado para assinar eventos publicados por um parceiro. O recurso que habilita esse tipo de integração é chamado de Eventos de Parceiro. Por meio dessa integração, você obtém um tópico de parceiro em que eventos de um sistema de parceiros são disponibilizados. Depois de ter um tópico de parceiro, crie uma assinatura de evento como faria para qualquer outro tipo de tópico.

Assinaturas de evento

Uma assinatura informa à Grade de Eventos do Azure com eventos em um tópico você está interessado em receber. Ao criar uma assinatura, você fornece um ponto de extremidade para processar o evento. Os pontos de extremidade podem ser um webhook ou um recurso de serviço do Azure. Você pode filtrar os eventos que são enviados a um ponto de extremidade. É possível filtrar por tipo de evento ou assunto do evento, por exemplo. Para obter mais informações, confira Assinaturas de eventos e esquema CloudEvents. As assinaturas de eventos para tópicos personalizados, de sistema, de parceiros e domínios apresentam as mesmas propriedades de recurso.

Para obter exemplos de criação de assinaturas para tópicos personalizados, de sistema, de parceiros e domínios, consulte:

• Criar um tópico personalizado e assinar eventos usando a CLI do Azure
• Exemplos do Azure PowerShell para a Grade de Eventos
• Modelos do Azure Resource Manager para Grade de Eventos

Para obter informações sobre como obter as assinaturas de Grade de Eventos atuais, confira Consultar assinaturas de Grade de Eventos.

Validade da assinatura de evento

Você pode definir um tempo de expiração para assinaturas de evento associadas a tópicos personalizados, de sistema, de parceiros, de domínio, e assinaturas de domínio. A assinatura do evento expira automaticamente após essa data. Defina uma expiração para assinaturas de evento que você só precisa por um tempo limitado e não queira se preocupar em limpar essas assinaturas. Por exemplo, ao criar uma assinatura de evento para testar um cenário, você pode querer definir uma expiração.

Para um exemplo de configuração de expiração, consulte Inscrever-se com filtros avançados.

Manipuladores de eventos

Sob a perspectiva da Grade de Eventos, um manipulador de eventos é o local em que o evento é enviado quando a entrega push é usada. O manipulador usa alguma ação adicional para processar o evento. A entrega por push na Grade de Eventos dá suporte a vários tipos de manipulador. Você pode usar um serviço do Azure compatível ou seu próprio webhook como o manipulador. Dependendo do tipo de manipulador, a Grade de Eventos segue diferentes mecanismos para assegurar a entrega do evento. Para manipuladores de eventos de webhook HTTP, o evento é repetido até que o manipulador retorne um código de status de 200 – OK. Para o Armazenamento do Microsoft Azure Queue, os eventos são repetidos até que o serviço Fila processe com êxito o envio de mensagens para a fila.

Para obter informações sobre como entregar eventos para qualquer um dos manipuladores de Grade de Eventos compatíveis, consulte Manipuladores de evento na Grade de Eventos do Azure.

Segurança

A Grade de Eventos fornece segurança na assinatura de tópicos e na publicação de eventos em tópicos. Ao fazer a assinatura, você precisa ter permissões adequadas no tópico da Grade de Eventos. Se você usar a entrega por push, o manipulador de eventos será um serviço do Azure e uma identidade gerenciada autentica a Grade de Eventos, a identidade gerenciada deverá ter uma função RBAC apropriada. Por exemplo, se você enviar eventos aos Hubs de Eventos, a identidade gerenciada usada na assinatura do evento deverá ser um membro da função Remetente de Dados dos Hubs de Eventos. Ao publicar, você deve ter um token SAS ou autenticação de chave para o tópico. Para saber mais, confira Event Grid security and authentication (Segurança e autenticação da Grade de Eventos).

Entrega de eventos

Se o Event Grid não puder confirmar que o endpoint do assinante recebeu um evento ao usar entrega push, ele reenviará o evento. Para saber mais, confira Event Grid message delivery and retry (Entrega e repetição de mensagens da Grade de Eventos).

Envio em lote

Ao usar um tópico personalizado, você deve sempre publicar eventos em uma matriz. Pode ser um lote de um para cenários de baixa taxa de transferência.

Definições de tipo de evento embutido

Se você for um parceiro, poderá definir os tipos de eventos que disponibilizará aos clientes ao criar um canal. Com as definições de tipo de evento embutidas, os assinantes podem filtrar com facilidade os eventos, considerando o tipo de evento ao configurar uma assinatura de evento.

Zonas de disponibilidade

As zonas de disponibilidade do Azure são locais fisicamente separados em cada região do Azure que são tolerantes a falhas locais. Elas são conectadas por uma rede de alto desempenho com uma latência de viagem de ida e volta de menos de 2 milissegundos. Cada zona de disponibilidade é composta por um ou mais datacenters equipados com energia, resfriamento e infraestrutura de rede independentes. Se uma zona for afetada, as duas zonas restantes darão suporte a serviços regionais, capacidade e alta disponibilidade. Para obter informações sobre zonas de disponibilidade, confira Regiões e zonas de disponibilidade.

Conteúdo relacionado

• Para ver uma introdução à Grade de Eventos, confira About Event Grid (Sobre a Grade de Eventos).
• Para começar a usar os tópicos personalizados, confira Criar e rotear eventos personalizados com a Grade de Eventos do Azure.