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
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
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
forRegistered
, 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.
Especifique um nome para o tópico:
topicname="<TOPIC NAME>"
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.
Especifique um nome exclusivo para o namespace dos Hubs de Eventos:
namespace="<EVENT HUBS NAMESPACE NAME>"
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
.
Normalmente você cria um aplicativo que recupera as mensagens de eventos do hub de eventos. Para saber mais, veja:
- Introdução à recepção de mensagens com o host do processador de eventos no .NET Standard
- Receber eventos dos Hubs de Eventos do Azure usando Java
- Receber eventos dos Hubs de Eventos usando o Apache Storm
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
Conteúdo relacionado
Agora que você sabe como criar tópicos e assinaturas de evento, saiba mais sobre como a Grade de Eventos pode ajudá-lo:
- Sobre a Grade de Eventos
- Rotear eventos do Armazenamento de Blobs do Azure para um ponto de extremidade da Web personalizado
- Monitorar alterações de máquina virtual com a Grade de Eventos do Azure e os Aplicativos Lógicos
- Transmitir Big Data para um data warehouse
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: