Usar o Data Explorer de Hubs de Eventos para executar operações de dados nos Hubs de Eventos

Os Hubs de Evento do Azure é um serviço de processamento de evento escalonável que recebe e processa grandes volumes de eventos e dados, com baixa latência e alta confiabilidade. Para obter uma visão geral de alto nível do serviço, veja O que são Hubs de Eventos do Azure?.

Os desenvolvedores e operadores geralmente procuram uma ferramenta fácil para enviar dados de amostra para ao hub de eventos para testar o fluxo de ponta a ponta ou exibir eventos em um deslocamento específico (ou ponto no tempo) para depuração leve, geralmente após o fato. O Data Explorer de Hubs de Eventos simplifica esses fluxos de trabalho comuns, eliminando a necessidade de gravar aplicativos cliente sob medida para testar e inspecionar os dados no hub de eventos.

Este artigo destaca a funcionalidade do Data Explorer de Hubs de Eventos do Azure que está disponível no portal do Azure.

Importante

Se o namespace dos Hubs de Eventos só pode ser acessado por meio de um ponto de extremidade privado, acesse o Data Explorer dos Hubs de Eventos de uma máquina virtual na mesma rede virtual do ponto de extremidade privado, isso garante que o navegador da Web tem o acesso necessário ao ponto de extremidade privado.

As operações executadas em um namespace do Hubs de Eventos do Azure são de dois tipos.

• Operações de Gerenciamento - Criação, atualização e exclusão do namespace de Hubs de Eventos e hubs de eventos.
• Operações de Dados - Envio e exibição de eventos de um hub de eventos.

Importante

• O Data Explorer de Hubs de Eventos não dá suporte a operações de gerenciamento. O hub de eventos deve ser criado antes que o data explorer possa enviar ou exibir eventos desse hub de eventos.
• Embora os conteúdos de eventos (conhecidos como valores no Kafka) enviados usando o protocolo Kafka estejam visíveis por meio do data explorer, a chave do evento específico não está visível.
• Não recomendamos o uso do Data Explorer de Hubs de Eventos para mensagens maiores, pois isso pode resultar em tempos de espera, dependendo do tamanho da mensagem, da latência da rede entre o cliente e o serviço Barramento de Serviço etc. Em vez disso, recomendamos que você use o próprio cliente para trabalhar com mensagens maiores, no qual é possível especificar os seus próprios valores de tempo limite.
• As operações que um usuário pode realizar usando o Data Explorer dos Hubs de Eventos são determinadas pela função RBAC (controle de acesso baseado em função) à qual o usuário está atribuído.

Pré-requisitos

Para usar a ferramenta Data Explorer de Hubs de Eventos, crie um namespace de Hubs de Eventos do Azure e um hub de eventos.

Uso do Data Explorer de Hubs de Eventos

Para usar o data explorer de Hubs de Eventos, navegue até o namespace dos Hubs de Eventos no qual você deseja executar as operações de dados.

Navegue até o Data Explorer diretamente, onde você pode escolher o hub de eventos ou escolha o hub de eventos no entities e, em seguida, escolha Data Explorer no menu de navegação.

Enviar eventos

Você pode enviar conteúdos personalizados ou conjuntos de dados pré-definidos para o hub de eventos selecionado usando a experiência Send events.

Para fazer isso, selecione o botão send events, que habilita o painel direito.

Envio de conteúdo personalizado

Para enviar um conteúdo personalizado -

1. Selecione Conjunto de Dados - Escolha Custom payload. Você também pode selecionar conjuntos de dados predefinidos, como dados Yellow Taxi, dados meteorológicos etc. conforme mostrado na próxima seção.
2. Selecione o Tipo de Conteúdo, entre Text/Plain, JSONou XML.
3. Carregue um arquivo JSON ou digite o conteúdo na caixa Inserir conteúdo.
4. [Opcional] Especifique as propriedades do sistema.
5. [Opcional] Especifique propriedades personalizadas - disponíveis como par chave-valor.
6. [Opcional] Se desejar enviar vários conteúdos, marque a caixa Repetir envio e especifique a contagem de repetição de envio (ou seja, o número de conteúdos a serem enviados) e o Intervalo entre repetição de envio em ms.

Depois que os detalhes do conteúdo forem definidos, selecione Enviar para enviar a carga do evento conforme definido.

Envio de conjunto de dados pré-definido

Para enviar cargas de evento de um conjunto de dados pré-definido -

1. Selecione Conjunto de Dados - Escolha uma opção dos Conjuntos de dados pré-definidos, por exemplo, táxi amarelo, dados meteorológicos e outros.
2. [Opcional] Especifique as propriedades do sistema.
3. [Opcional] Especifique propriedades personalizadas - disponíveis como pares de chave-valor.
4. [Opcional] Se desejar enviar vários conteúdos, marque a caixa Repetir envio e especifique a contagem de repetição de envio (ou seja, o número de conteúdos a serem enviados) e o Intervalo entre repetição de envio em ms.

Depois que os detalhes do conteúdo forem definidos, selecione Enviar para enviar a carga do evento conforme definido.

Exibir eventos

O data explorer de Hubs de Eventos permite exibir os eventos para inspecionar os dados que se encaixam nos critérios.

Para exibir os eventos, você pode definir as propriedades abaixo ou confiar no padrão -

1. partitionID - Escolha uma partição específica ou selecione Todas as IDs de partição.
2. Grupo de Consumidores - Escolha o $Default ou outro grupo de consumidores, ou crie um na hora.
3. Posição de evento - Escolha a posição mais antiga (ou seja, o início do hub de eventos), Posição mais recente (ou seja, a mais recente), Posição personalizada (para um deslocamento específico, número de sequência ou carimbo de data/hora).
   1. Posição mais antiga: comece a receber eventos a partir do primeiro evento na partição que não expirou devido à política de retenção.
   2. Posição personalizada: adicione filtro para especificar a posição na partição a partir da qual receber eventos.
   3. Posição mais recente: comece a receber eventos a partir do evento que é enfileirado logo após a chamada de exibição. Somente os eventos enviados após a última exibição de eventos são recebidos.
4. Propriedades avançadas - Especifique o tamanho máximo do lote e o tempo máximo de espera em segundos.

Depois que as opções acima forem definidas, selecione Exibir eventos para extrair os eventos e renderizá-los no data explorer.

Depois que os eventos forem carregados, você poderá selecionar Exibir próximos eventos para extrair eventos usando a mesma consulta novamente ou Limpar tudo para atualizar a grade.

Baixar a carga do evento

Ao exibir os eventos em um determinado hub de eventos, é possível baixar a carga do evento para análise posterior.

Para baixar a carga do evento, selecione o evento específico e selecione o botão de Download exibido acima do corpo da carga do evento.

Conteúdo relacionado

• Saiba mais sobre os Hubs de Eventos.
• Confira os Recursos e a terminologia de Hubs de Eventos