Compartilhar via

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

O Barramento de Serviço do Azure permite que os aplicativos cliente do remetente e do destinatário desacoplem sua lógica de negócios usando semânticas de ponto a ponto (fila) e de publicação/assinatura (tópico/assinatura) conhecidas.

Observação

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

A Service Bus Explorer de software livre de propriedade da comunidade é um aplicativo autônomo e é diferente deste.

Você pode executar dois tipos de operações em um namespace do Azure Service Bus.

  • Operações de gerenciamento – crie, atualize e exclua do namespace, filas, tópicos e assinaturas do Barramento de Serviço.
  • Operações de dados - Envie e receba mensagens de filas, tópicos e assinaturas.

Importante

  • O Service Bus Explorer não oferece suporte a operações de gerenciamento e sessões.
  • Não use o Service Bus Explorer para mensagens maiores, pois isso pode resultar em tempos limite, dependendo do tamanho da mensagem, da latência de rede entre o cliente e o serviço do Barramento de Serviço e outros fatores. Em vez disso, use seu próprio cliente para trabalhar com mensagens maiores, em que você pode especificar seus próprios valores de tempo limite.
  • Se você só puder acessar o namespace do Barramento de Serviço por meio de um ponto de extremidade privado, deverá executar seu navegador da Web em um host na rede virtual que inclua o ponto de extremidade privado. Além disso, verifique se nenhum grupo de segurança de rede (NSG) bloqueiem o acesso.
  • Se um usuário tiver acesso apenas a entidades e não ao namespace, o Gerenciador do Barramento de Serviço poderá não funcionar conforme o esperado em cenários que envolvem a migração para a camada premium ou recuperação de desastre de metadados.

Pré-requisitos

Para usar a ferramenta Service Bus Explorer, conclua as seguintes tarefas:

Usar o Service Bus Explorer

Para usar o Gerenciador do Barramento de Serviço, vá para o namespace do Barramento de Serviço onde você deseja executar operações de dados.

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

    Captura de tela da navegação do lado esquerdo, em que 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 Gerenciador do Barramento de Serviço no menu de navegação à esquerda.

    Captura de tela da página da fila onde o Service Bus Explorer pode ser selecionado.

    Observação

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

    Observação

    Ao navegar até o Service Bus Explorer para uma entidade em um namespace que tenha o acesso público desabilitado, você verá a mensagem a seguir, mesmo acessando-a em uma máquina virtual que está na mesma rede virtual do ponto de extremidade privado. Você pode ignorá-la.

    "O namespace tem o acesso à rede pública desabilitado. As operações de dados como Espiar, Enviar ou Receber nessa entidade do Barramento de Serviço só funcionarão quando você alternar para todas as redes ou adicionar o IP do cliente à lista de permissões em redes selecionadas."

Espiar uma mensagem

Usando a funcionalidade de espiada, você poderá utilizar o Service Bus Explorer para ver as 100 primeiras mensagens de uma fila, assinatura ou fila de mensagens mortas.

  1. Selecione Modo Espiar no menu suspenso do Service Bus Explorer para espiar as mensagens.

    Captura de tela do menu suspenso com o Modo Peek selecionado.

  2. Verifique as métricas para ver se há Mensagens ativas ou Mensagens mortas a serem recebidas. Selecione a subfila Fila/Assinatura ou DeadLetter.

    Captura de tela das guias de fila e subfila de mensagens inativas com métricas de mensagens exibidas.

  3. Selecione o botão Espiar na tela inicial .

    Captura de tela indicando o botão Espiar do início.

  4. Quando a operação de espiada for concluída, até 100 mensagens serão exibidas na grade. 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 mostrados para mensagens espiadas.

    Alterne para a aba 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 a espiada não é uma operação destrutiva, a mensagem não é removida da entidade.

    Observação

    Por motivos de desempenho, ao espiar mensagens de uma fila ou assinatura que tenha seu tamanho máximo de mensagem definido acima de 1 MB, o corpo da mensagem não é recuperado por padrão. Em vez disso, você pode carregar o corpo da mensagem para uma mensagem específica selecionando o botão Carregar corpo da mensagem . Se o corpo da mensagem tiver mais de 1 MB, ele não 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.

Espie uma mensagem usando opções avançadas

Ao usar a funcionalidade de espiada com opções, você poderá usar o Service Bus Explorer para ver as primeiras mensagens de uma fila, assinatura ou da fila de mensagens mortas. Você pode especificar o número de mensagens a serem espiadas e o número de sequência para iniciar a operação de espiada.

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

    Captura de tela do menu suspenso com o Modo de espiar selecionado para espiar com opções avançadas.

  2. Verifique as métricas para ver se há Mensagens ativas ou Mensagens mortas a serem recebidas. Selecione a subfila Fila/Assinatura ou DeadLetter.

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

  3. Selecione o botão Visualizar com opções. Insira o número de mensagens a visualizar e o número de sequência a partir do qual começar a visualizar. Selecione o botão Espiar .

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

  4. Quando a operação de espiada for concluída, as mensagens aparecerão 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 mostrados para espiar com opções avançadas.

    Alterne para a aba 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 a espiada não é uma operação destrutiva, a mensagem não é 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 no menu suspenso do Service Bus Explorer.

    Captura de tela do menu suspenso com o Modo de recebimento selecionado.

  2. Verifique as métricas para ver se há Mensagens Ativas ou Mensagens Inativas para receber e selecione Fila / Assinatura ou DeadLetter.

    Captura de tela das guias de fila e subfila de mensagens mortas 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 para aguardar uma mensagem e selecionar Receber.

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

    Importante

    O modo ReceiveAndDelete é um recebimento destrutivo, ou seja, a mensagem é removida da fila quando é exibida na ferramenta Service Bus Explorer.

    Para procurar mensagens sem removê-las da fila, considere usar a funcionalidade Peek ou usar 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 mostrados.

    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 que tenha seu tamanho máximo de mensagem definido acima de 1 MB, apenas uma mensagem é recebida por vez. Se o corpo da mensagem tiver mais de 1 MB, a ferramenta a truncará antes de ser exibida.

Depois que uma mensagem é recebida no modo PeekLock , há várias ações que você pode executar sobre ela.

Observação

Só é possível executar essas ações se você tiver um bloqueio na mensagem.

Concluir uma mensagem

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

  2. Selecione o botão Concluir .

    Captura de tela que indica o botão Concluir.

    Importante

    Ao concluir uma mensagem, você executa um recebimento destrutivo. O processo remove a mensagem da fila quando você seleciona Concluir na ferramenta Service Bus Explorer.

Adiar uma mensagem

  1. Na grade, selecione uma ou mais mensagens recebidas que você deseja adiar.

  2. Selecione o botão Adiar.

    Captura de tela indicando o botão Adiar.

Abandonar bloqueio

  1. Na grade, selecione uma ou mais mensagens recebidas que terão o bloqueio removido.

  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 está disponível novamente para operações de recebimento.

Mensagens mortas

  1. Na grade, selecione uma ou mais mensagens recebidas que você deseja enviar como inativa.

  2. Selecione o botão Mensagens inativas.

    Captura de tela indicando o botão Mensagens inativas.

Depois de colocar uma mensagem na fila de mensagens mortas, você poderá acessá-la na subfila Mensagens mortas.

Limpar mensagens

Para limpar mensagens, selecione o botão Limpar mensagens no Service Bus Explorer.

Captura de tela que indica o botão limpar mensagens.

Quando solicitado, insira "limpar" para confirmar a operação. O processo limpa as mensagens da respectiva entidade do Barramento de Serviço.

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 no Service Bus Explorer.

  1. Selecione o Tipo de Conteúdo para ser Text/Plain, Application/Xml ou Application/Json.

  2. Para o corpo da mensagem, adicione o conteúdo da mensagem. Verifique se ele corresponde ao Tipo de Conteúdo que você definiu anteriormente.

  3. Defina as propriedades do Broker (opcional). Essas propriedades incluem ID de correlação, ID da mensagem, ReplyTo, Rótulo/Assunto, TTL (Vida útil) e Tempo de enfileiramento agendado (para mensagens agendadas).

  4. Defina as Propriedades Personalizadas (opcional). Essas propriedades podem ser qualquer propriedade de usuário definida em relação a uma chave de dicionário.

  5. Verifique Repetir envio para enviar a mesma mensagem várias vezes. Se você não definir uma ID de Mensagem, o processo a preencherá automaticamente com valores sequenciais.

  6. Quando terminar de redigir a mensagem, selecione Enviar.

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

  7. Quando a operação de envio é concluída com êxito, ocorre uma das seguintes alterações:

    • Se você estiver enviando para uma fila, o processo incrementará o contador de métricas Mensagens Ativas.
    • Se você estiver enviando para um tópico, o processo incrementará o contador de métricas Mensagens Ativas nas assinaturas para as quais a mensagem foi roteada.

Reenviar uma mensagem

Depois de visualizar ou receber uma mensagem, você pode reenviar. O reenviamento envia uma cópia da mensagem para a mesma entidade, permitindo que você atualize seu conteúdo e propriedades. A mensagem original permanece e não é excluída, mesmo quando você reenvia a partir da fila de mensagens mortas.

  1. Na grade, selecione uma ou mais mensagens que você deseja reenviar.

  2. Selecione o botão Enviar mensagens selecionadas novamente .

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

  3. Opcionalmente, selecione qualquer mensagem cujos detalhes deseje 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 reenviar 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.

Exportar mensagens

Você pode exportar mensagens na grade para uma planilha do Excel selecionando o botão Exportar mensagens na barra de ferramentas.

Captura de tela mostrando a experiência de exportação de mensagens.

Mostrar ou ocultar o corpo da mensagem

Quando você seleciona uma mensagem na grade, o corpo da mensagem aparece no painel inferior por padrão. Para ocultar o corpo da mensagem, selecione Ocultar corpo da mensagem na barra de ferramentas. Em seguida, selecione Visualizar ou Receber para carregar as mensagens sem o corpo da mensagem. Essa opção é útil quando há mensagens grandes na entidade. O programa não alterna a guia do corpo da mensagem no painel inferior se ela já estiver aberta.

Captura de tela que indica o botão Ocultar corpo da mensagem.

Alternar o tipo de autenticação

Ao trabalhar com o Service Bus Explorer, você pode usar a Chave de Acesso ou a autenticação com o Microsoft Entra ID.

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

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

  2. Escolha o método de autenticação que você deseja usar e selecione Salvar.

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

Próximas etapas

  • Last updated on