Compartilhar via

Usar o Service Bus Explorer para executar operações de dados no Barramento de Serviço

  • Artigo

O Barramento de Serviço do Azure permite que os aplicativos cliente do remetente e do destinatário desassociem sua lógica de negócios com o uso de semântica de ponto a ponto (fila) e de publicação-assinatura (tópico-assinatura) familiares.

Observação

Este artigo destaca a funcionalidade do Azure Service Bus Explorer que é parte do portal do Azure.

O Service Bus Explorer de código aberto, pertencente à comunidade, é um aplicativo autônomo e é diferente deste.

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

  • Operações de gerenciamento – criar, atualizar, excluir do namespace do Barramento de Serviço, filas, tópicos e assinaturas.
  • Operações de dados – enviar e receber mensagens para/de filas, tópicos e assinaturas.

Importante

  • O Service Bus Explorer não oferece suporte a operações de gerenciamento e sessões.
  • Aconselhamos a não usar o Service Bus Explorer para mensagens maiores, pois isso pode resultar em tempos de espera, dependendo do tamanho da mensagem, latência da rede entre o cliente e o serviço Barramento de Serviço etc. Em vez disso, recomendamos que você use seu próprio cliente para trabalhar com mensagens maiores, em que você pode especificar seus próprios valores de tempo limite.

Pré-requisitos

Para usar a ferramenta Service Bus Explorer, você precisa realizar as seguintes tarefas:

Usar o Service Bus Explorer

Para usar o Service Bus Explorer, navegue até o namespace do Barramento de Serviço no qual você deseja executar as operações de dados.

  1. Se você estiver procurando executar operações em uma fila, escolha Filas no menu de navegação. Se você estiver procurando executar operações em um tópico (e nas assinaturas relacionadas), selecione Tópicos.

    Captura de tela da navegação do lado esquerdo, onde a entidade pode ser selecionada.

  2. Depois de selecionar Filas ou Tópicos, selecione a fila ou o tópico específico.

    Captura de tela da página Filas com uma fila específica selecionada.

  3. Selecione o Service Bus Explorer no menu de navegação à esquerda

    Captura de tela da página da fila em que o Gerenciador do Barramento de Serviço pode ser selecionado.

    Observação

    Ao espiar ou receber de uma assinatura, primeiro selecione a Assinatura específica no seletor suspenso. Captura de tela do menu suspenso para assinaturas de tópico.

Espiar uma mensagem

Com a funcionalidade de espiada, você pode usar o Service Bus Explorer para ver as 100 primeiras mensagens de uma fila, assinatura ou fila de mensagens mortas.

  1. Para espiar mensagens, selecione Modo Espiar no menu suspenso do Service Bus Explorer.

    Captura de tela da lista suspensa com o Modo Espiar selecionado.

  2. Verifique as métricas para ver se há Mensagens ativas ou Mensagens mortas a espiar e selecione a Fila / Assinatura ou a subfila de Mensagens Mortas.

    Captura de tela das guias de fila e subfila de mensagens não entregues com métricas de mensagens exibidas.

  3. Selecione o botão Espiar do início.

    Captura de tela indicando o botão Espiar do botão Iniciar.

  4. Depois que a operação de espiar for concluída, até 100 mensagens são exibidas na grade, conforme mostrado na imagem a seguir. Para exibir os detalhes de uma mensagem específica, selecione-a na grade. Você pode optar por exibir o corpo ou as propriedades da mensagem.

    Captura de tela com visão geral de mensagens espiadas e conteúdo do corpo da mensagem mostrado para mensagens espiadas.

    Alterne para a guia Propriedades da Mensagem no painel inferior para ver os metadados.

    Captura de tela com visão geral de mensagens espiadas e propriedades de mensagem mostradas para mensagens espiadas.

    Observação

    Como espiar não é uma operação destrutiva, a mensagem não será removida da entidade.

    Observação

    Por motivos de desempenho, ao espiar mensagens de uma fila ou assinatura com o tamanho máximo da mensagem definido em 1 MB, o corpo da mensagem não será recuperado por padrão. Em vez disso, você pode carregar o corpo da mensagem para uma mensagem específica clicando no botão Carregar corpo da mensagem. Se o corpo da mensagem tiver mais de 1 MB, ele será truncado antes de ser exibido. Captura de tela com visão geral de mensagens espiadas e botão para carregar o corpo da mensagem mostrado.

Espiar uma mensagem com opções avançadas

A funcionalidade de espiada com opções permite usar o Service Bus Explorer para exibir as primeiras mensagens em uma fila, assinatura ou fila de mensagens mortas, especificando o número de mensagens a espiar e o número da sequência a partir do qual começar a operação de espiada.

  1. Para espiar mensagens com opções avançadas, selecione Modo Espiar no menu suspenso do Service Bus Explorer.

    Captura de tela da lista suspensa com o Modo Espiar selecionado para espiar com opções avançadas.

  2. Verifique as métricas para ver se há Mensagens ativas ou Mensagens mortas a espiar e selecione a Fila / Assinatura ou a subfila de Mensagens Mortas.

    Captura de tela das guias de fila e subfila de mensagens não entregues com métricas de mensagens exibidas para visualização com opções avançadas.

  3. Selecione o botão Espiar com opções. Forneça o número de mensagens a serem espiadas e o número da sequência do qual começar a espiar e selecione o botão Espiar.

    Captura de tela indicando o botão Espiar com opções e uma página onde as opções podem ser definidas.

  4. Depois que a operação de espiar for concluída, as mensagens são exibidas na grade, conforme mostrado na imagem a seguir. Para exibir os detalhes de uma mensagem específica, selecione-a na grade. Você pode optar por exibir o corpo ou as propriedades da mensagem.

    Captura de tela com visão geral de mensagens espiadas e conteúdo do corpo da mensagem mostrado para espiar com opções avançadas..

    Alterne para a guia Propriedades da Mensagem no painel inferior para ver os metadados.

    Captura de tela com visão geral de mensagens espiadas e propriedades de mensagem mostradas para espiar com opções avançadas.

    Observação

    Como espiar não é uma operação destrutiva, a mensagem não será removida da fila.

Receber uma mensagem

A função de recebimento no Service Bus Explorer permite o recebimento de mensagens de uma fila ou assinatura.

  1. Para receber mensagens, selecione Modo de Recebimento na lista suspensa do Service Bus Explorer.

    Captura de tela da lista suspensa com o Modo de Recebimento selecionado.

  2. Verifique as métricas para ver se há Mensagens ativas ou Mensagens mortas a serem recebidas e selecione Fila/Assinatura ou Fila de Mensagens Mortas.

    Captura de tela das guias de fila e subfila de mensagens não entregues com métricas de mensagens exibidas para o modo de recebimento.

  3. Selecione o botão Receber mensagens e especifique o modo de recebimento, o número de mensagens a serem recebidas e o tempo máximo pelo qual aguardar uma mensagem e selecione Receber.

    Captura de tela indicando o botão Receber e uma página onde as opções podem ser definidas.

    Importante

    Observe que o modo ReceiveAndDelete é uma operação de recebimento destrutivo, ou seja, a mensagem é removida da fila quando ela é exibida na ferramenta Service Bus Explorer.

    Para procurar mensagens sem removê-las da fila, considere o uso da funcionalidade Espiar ou use o modo de recebimento PeekLock.

  4. Depois que a operação de recebimento for concluída, as mensagens são exibidas na grade, conforme mostrado na imagem a seguir. Para exibir os detalhes de uma mensagem específica, selecione-a na grade.

    Captura de tela com visão geral das mensagens recebidas e do conteúdo do corpo da mensagem mostrado.

    Captura de tela com visão geral das mensagens recebidas e das propriedades da mensagem mostradas.

    Observação

    Por motivos de desempenho, ao receber mensagens de uma fila ou assinatura com o tamanho máximo da mensagem definido em 1MB, apenas uma mensagem será recebida por vez. Se o corpo da mensagem tiver mais de 1 MB, ele será truncado antes de ser exibido.

Depois que uma mensagem é recebida no modo PeekLock, há várias ações que podemos executar nela.

Observação

Só podemos executar essas ações desde que tenhamos um bloqueio na mensagem.

Concluir uma mensagem

  1. Na grade, selecione as mensagens recebidas que desejamos concluir.

  2. Selecione o botão Concluir.

    Captura de tela indicando o botão Concluir.

    Importante

    Observe que concluir uma mensagem é um recebimento destrutivo, ou seja, a mensagem é removida da fila quando a opção Concluir é selecionada na ferramenta Service Bus Explorer.

Adiar uma mensagem

  1. Na grade, selecione as mensagens recebidas que desejamos adiar.

  2. Selecione o botão Adiar.

    Captura de tela que indica o botão Adiar.

Abandonar bloqueio

  1. Na grade, selecione as mensagens recebidas para as quais queremos abandonar o bloqueio.

  2. Selecione o botão Abandonar bloqueio.

    Captura de tela que indica o botão Abandonar Bloqueio.

Depois que o bloqueio for abandonado, a mensagem estará disponível novamente para operações de recebimento.

Mensagens mortas

  1. Na grade, selecione as mensagens recebidas que desejamos colocar na fila de Mensagens mortas.

  2. Selecione o botão Mensagens mortas.

    Captura de tela que indica o botão Mensagens mortas.

Depois que uma mensagem se torna mensagem morta, ela estará disponível na subfila de Mensagens mortas.

Enviar uma mensagem a uma fila ou um tópico

Para enviar uma mensagem para uma fila ou um tópico, selecione o botão Enviar mensagens do Service Bus Explorer.

  1. Escolha o Tipo de Conteúdo como Texto/Simples, Aplicativo/Xml ou Aplicativo/Json.

  2. Para o Corpo da mensagem, adicione o conteúdo da mensagem. Verifique se ele corresponde ao Tipo de conteúdo definido anteriormente.

  3. Defina Propriedades do agente (opcional) – isso inclui ID de correlação, ID da mensagem, ReplyTo, Rótulo/Assunto, TTL (Vida útil) e Tempo de enfileiramento agendado (para mensagens agendadas).

  4. Defina Propriedades personalizadas (opcional) – pode ser qualquer propriedade de usuário definida em relação a uma chave de dicionário.

  5. Marque Repetir o envio para enviar a mesma mensagem várias vezes. Se nenhuma ID de Mensagem tiver sido definida, ela será automaticamente preenchida com valores sequenciais.

  6. Depois que a mensagem tiver sido redigida, pressione o botão Enviar.

    Captura de tela mostrando a experiência de redação da mensagem.

  7. Quando a operação de envio for concluída com êxito, um dos seguintes eventos ocorrerá:

    • Se o envio estiver sendo feito para uma fila, o contador de métricas de Mensagens Ativas será incrementado.
    • Se o envio estiver sendo feito para um tópico, o contador de métricas de Mensagens ativas será incrementado na assinatura para a qual a mensagem foi roteada.

Reenviar uma mensagem

Depois de espiar ou receber uma mensagem, podemos reenviá-la, o que enviará uma cópia da mensagem para a mesma entidade, permitindo-nos atualizar seu conteúdo e suas propriedades. O original permanecerá e não será excluído, mesmo quando o reenvio for da fila de mensagens mortas.

  1. Na grade, selecione a(s) mensagem(ns) que deseja reenviar.

  2. Selecione o botão Reenviar as mensagens selecionadas.

    Captura de tela indicando o botão Reenviar mensagens selecionadas.

  3. Opcionalmente, selecione qualquer mensagem cujos detalhes desejamos atualizar e faça as alterações desejadas.

  4. Selecione o botão Enviar para enviar as mensagens para a entidade.

    Captura de tela mostrando a experiência de reenvio de mensagens.

    Observação

    • A operação de reenvio envia uma cópia da mensagem original. Ela não remove a mensagem original que você reenvia.
    • Se você reenviar uma mensagem em uma fila de mensagens mortas de uma assinatura, uma cópia da mensagem será enviada ao tópico. Portanto, todas as assinaturas receberão uma cópia da mensagem.

Alternar o tipo de autenticação

Observação

Para usar a autenticação do Microsoft Entra ID (Azure Active Directory), os itens a seguir são necessários:

  • A entidade de usuário/serviço recebe a função de “Proprietário de Dados do Barramento de Serviço do Azure”. Não há suporte para outras funções internas ou de cliente.
  • A função “Proprietário de Dados do Barramento de Serviço do Azure'”deve ser atribuída no escopo do namespace. Não há suporte para a atribuição no escopo da fila ou do tópico.

Ao trabalhar com o Service Bus Explorer do Azure, é possível usar a Chave de Acesso ou a autenticação do Microsoft Entra ID.

  1. Selecione o botão Configurações.

    Captura de tela indicando o botão Definições no Service Bus Explorer.

  2. Escolha o método de autenticação desejado e selecione o botão Salvar.

    Captura de tela indicando o botão Configurações e uma página mostrando os diferentes tipos de autenticação.

Próximas etapas