Início Rápido: rotear eventos personalizados para um hub de eventos usando a Grade de Eventos e a CLI do Azure

A Grade de Eventos do Azure é um agente de eventos altamente escalonável e sem servidor que você pode usar para integrar aplicativos por meio de eventos. A Grade de Eventos fornece eventos para manipuladores de eventos com suporte e os Hubs de Eventos do Azure são um deles.

Neste início rápido, você usará a CLI do Azure para criar um tópico personalizado da Grade de Eventos e uma assinatura dos Hubs de Eventos para esse tópico. Em seguida, você enviará os eventos de exemplo para o tópico personalizado e irá verificar se esses eventos foram entregues a um hub de eventos.

Caso você não tenha uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.

Criar um grupo de recursos

Os tópicos de Grade de Eventos são recursos do Azure e devem ser colocados em um grupo de recursos do Azure. O grupo de recursos do Azure é uma coleção lógica na qual os recursos do Azure são implantados e gerenciados.

Crie um grupo de recursos usando o comando az group create. O exemplo a seguir cria um grupo de recursos chamado gridResourceGroup na localização westus2.

Selecione Abrir Cloud Shell para abrir o Azure Cloud Shell no painel direito. Selecione o botão Copiar para copiar o comando, colá-lo no Cloud Shell e selecionar a tecla Enter para executá-lo.

az group create --name gridResourceGroup --location westus2

Habilitar o provedor de recursos da Grade de Eventos

  1. Se você ainda não tiver usado a Grade de Eventos em sua assinatura do Azure, talvez seja necessário registrar o provedor de recursos desse serviço. Execute o seguinte comando para registrar o provedor:

    az provider register --namespace Microsoft.EventGrid
    
  2. A conclusão do registro pode demorar um pouco. Para verificar o status, execute o seguinte comando:

    az provider show --namespace Microsoft.EventGrid --query "registrationState"
    

    Quando registrationState for Registered, você está pronto para continuar.

Criar um tópico personalizado

Um tópico de Grade de Eventos fornece um ponto de extremidade definido pelo usuário no qual você posta seus eventos. O exemplo a seguir cria o tópico personalizado no seu grupo de recursos.

Substitua <TOPIC NAME> por um nome exclusivo para o tópico personalizado. O nome do tópico da Grade de Eventos deve ser exclusivo porque uma entrada DNS (Sistema de Nomes de Domínio) o representa.

  1. Especifique um nome para o tópico:

    topicname="<TOPIC NAME>"
    
  2. Execute o comando a seguir para criar o tópico:

    az eventgrid topic create --name $topicname -l westus2 -g gridResourceGroup
    

Criar um Hub de Evento

Antes de assinar o tópico personalizado, crie o ponto de extremidade para a mensagem de evento. Um hub de eventos deve ser criado para coletar os eventos.

  1. Especifique um nome exclusivo para o namespace dos Hubs de Eventos:

    namespace="<EVENT HUBS NAMESPACE NAME>"
    
  2. Execute os comandos a seguir para criar um namespace dos Hubs de Eventos e um hub de eventos chamado demohub nesse namespace:

    hubname=demohub
    
    az eventhubs namespace create --name $namespace --resource-group gridResourceGroup
    az eventhubs eventhub create --name $hubname --namespace-name $namespace --resource-group gridResourceGroup
    

Assinar um tópico personalizado

Assine um tópico da Grade de Eventos para indicar à Grade de Eventos quais eventos você deseja acompanhar. O exemplo a seguir assina o tópico personalizado que você criou e passa a ID do recurso do hub de eventos para o ponto de extremidade. O ponto de extremidade está nesse formato:

/subscriptions/<AZURE SUBSCRIPTION ID>/resourceGroups/<RESOURCE GROUP NAME>/providers/Microsoft.EventHub/namespaces/<NAMESPACE NAME>/eventhubs/<EVENT HUB NAME>

O script a seguir obtém a ID do recurso para o hub de eventos e assina um tópico da Grade de Eventos. Ele define o tipo de ponto de extremidade como eventhub e usa a ID de hub de evento para o ponto de extremidade.

hubid=$(az eventhubs eventhub show --name $hubname --namespace-name $namespace --resource-group gridResourceGroup --query id --output tsv)
topicid=$(az eventgrid topic show --name $topicname -g gridResourceGroup --query id --output tsv)

az eventgrid event-subscription create \
  --source-resource-id $topicid \
  --name subtoeventhub \
  --endpoint-type eventhub \
  --endpoint $hubid

A conta que cria a assinatura de evento deve ter acesso de gravação ao hub de eventos.

Enviar um evento para o tópico personalizado

Disparar um evento para ver como a Grade de Eventos distribui a mensagem para o ponto de extremidade. Primeiro, obtenha a URL e a chave para o tópico personalizado:

endpoint=$(az eventgrid topic show --name $topicname -g gridResourceGroup --query "endpoint" --output tsv)
key=$(az eventgrid topic key list --name $topicname -g gridResourceGroup --query "key1" --output tsv)

Para simplificar neste artigo, use exemplo de dados de evento para enviar para o tópico personalizado. Normalmente, um aplicativo ou serviço do Azure enviaria os dados de evento.

A ferramenta cURL envia solicitações HTTP. Neste artigo, use o cURL para enviar o evento ao tópico personalizado. O exemplo a seguir envia três eventos para o tópico de Grade de Eventos:

for i in 1 2 3
do
   event='[ {"id": "'"$RANDOM"'", "eventType": "recordInserted", "subject": "myapp/vehicles/motorcycles", "eventTime": "'`date +%Y-%m-%dT%H:%M:%S%z`'", "data":{ "make": "Ducati", "model": "Monster"},"dataVersion": "1.0"} ]'
   curl -X POST -H "aeg-sas-key: $key" -d "$event" $endpoint
done

No portal do Azure, na página Visão geral do namespace dos Hubs de Eventos, observe que a Grade de Eventos enviou esses três eventos para o hub de eventos. Você vê o mesmo gráfico na página Visão geral da instância dos Hubs de Eventos demohub.

Captura de tela que mostra a página do portal com uma contagem de mensagens de entrada de 3.

Normalmente você cria um aplicativo que recupera as mensagens de eventos do hub de eventos. Para saber mais, veja:

Limpar os recursos

Caso planeje continuar a trabalhar com esse evento, não limpe os recursos que você criou neste artigo. Caso contrário, use o seguinte comando para excluir os recursos:

az group delete --name gridResourceGroup

Agora que você sabe como criar tópicos e assinaturas de evento, saiba mais sobre como a Grade de Eventos pode ajudá-lo:

Para saber mais sobre como publicar eventos e consumir eventos da Grade de Eventos usando várias linguagens de programação, confira os seguintes exemplos: