Partilhar via

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

O Barramento de Serviço do Azure permite que as aplicações cliente de envio e receção desacoplem a sua lógica de negócios com o uso da semântica familiar de ponto-a-ponto (Fila) e publicação-assinatura (Tópico-Assinatura).

Nota

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

O Service Bus Explorer de código aberto de propriedade da comunidade é um aplicativo independente 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 - Crie, atualize, exclua namespace, filas, tópicos e assinaturas do Service Bus.
  • Operações de Dados - Enviar e receber mensagens de filas, tópicos e assinaturas.

Importante

  • O Service Bus Explorer não oferece suporte a operações e sessões de gerenciamento.
  • Aconselhamos a não usar o Service Bus Explorer para mensagens maiores, pois isso pode resultar em tempos limites, dependendo do tamanho da mensagem, latência de rede entre o cliente e o serviço do Service Bus, etc. Em vez disso, recomendamos que você use seu próprio cliente para trabalhar com mensagens maiores, onde você pode especificar seus próprios valores de tempo limite.
  • Se o namespace do Service Bus só puder ser acessado por meio de um ponto de extremidade privado, você deverá executar seu navegador da Web em um host na rede virtual com o ponto de extremidade privado e também garantir que não haja NSGs (gateways de segurança de rede) no caminho.
  • Se um usuário tiver acesso apenas a entidades e não ao namespace, o Service Bus Explorer pode não funcionar como esperado em cenários que envolvem a migração para a camada premium ou recuperação de desastres de metadados.

Pré-requisitos

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

Usar o Service Bus Explorer

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

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

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

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

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

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

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

    Nota

    Ao espiar ou receber de uma assinatura, primeiro selecione a Assinatura específica no seletor suspenso. Captura de ecrã do menu pendente para subscrições de tópicos.

    Nota

    Quando se navega para o Explorador do Service Bus para uma entidade num namespace que tem o acesso público desativado, vê-se a seguinte mensagem, mesmo ao aceder de uma máquina virtual que está na mesma rede virtual que o endpoint privado. Você pode ignorá-lo.

    "O namespace tem o acesso à rede pública desabilitado. "As operações de dados, como Peek, Send ou Receive, contra esta entidade do Service Bus não funcionam até que se alterne para todas as redes ou autorize o IP do seu cliente nas redes selecionadas."

Ver uma mensagem

Com a funcionalidade de visualização, você pode usar o Service Bus Explorer para exibir as 100 principais mensagens em uma fila, assinatura ou fila de mensagens mortas.

  1. Para espreitar mensagens, selecione Modo de Espreitar na lista suspensa do Explorador do Service Bus.

    Captura de ecrã da lista pendente com o Modo de Espreitar selecionado.

  2. Verifique as métricas para ver se há Mensagens Ativas ou Mensagens Mortas para inspecionar e selecione a fila/subscrição ou a subfila DeadLetter.

    Captura de tela das guias de fila e subfila de letra morta com métricas de mensagem exibidas.

  3. Selecione o botão Espreitar a partir do início.

    Captura de ecrã a indicar o botão Espreitar desde o início.

  4. Quando a operação de visualização for concluída, até 100 mensagens aparecerão na grade, conforme mostrado na imagem a seguir. Para visualizar os detalhes de uma mensagem específica, selecione-a na grade. Você pode escolher exibir o corpo ou as propriedades da mensagem.

    Captura de tela com visão geral das mensagens espiadas e do 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 ecrã com uma visão geral das mensagens espiadas e das propriedades das mensagens mostradas para mensagens espiadas.

    Nota

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

    Nota

    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 clicando no 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 das mensagens espiadas e botão para carregar o corpo da mensagem mostrado.

Espie uma mensagem com opções avançadas

A funcionalidade de espreitar com opções permite que o utilizador use o Service Bus Explorer para visualizar as mensagens principais numa fila, subscrição ou fila de mensagens mortas, especificando o número de mensagens a espreitar e o número de sequência para iniciar a operação de espreita.

  1. Para espreitar mensagens com opções avançadas, selecione Modo de Espreitar no menu desdobrável do Service Bus Explorer.

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

  2. Verifique as métricas para ver se há Mensagens Ativas ou Mensagens Mortas para inspecionar e selecione a fila/subscrição ou a subfila DeadLetter.

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

  3. Selecione o botão Espreitar com opções. Forneça o número de mensagens a espreitar e o número de sequência a partir do qual começar a espreitar e selecione o botão Espreitar .

    Captura de ecrã que indica o botão Espreitar com opções e uma página onde as opções podem ser definidas.

  4. Quando a operação de visualização for concluída, as mensagens aparecerão na grelha, como mostrado na imagem a seguir. Para visualizar os detalhes de uma mensagem específica, selecione-a na grade. Você pode escolher exibir o corpo ou as propriedades da mensagem.

    Captura de ecrã com uma visão geral das mensagens espiadas e do conteúdo do corpo da mensagem mostrado para espreitar 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 mensagens mostradas para espiar com opções avançadas.

    Nota

    Como espreitar 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 receber mensagens de uma fila ou assinatura.

  1. Para receber mensagens, selecione Modo de Receção no dropdown do Service Bus Explorer.

    Captura de ecrã do menu suspenso com o modo de receção selecionado.

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

    Captura de tela das guias de fila e subfila de letra morta com métricas de mensagem 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 receber e o tempo máximo de espera por 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

    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 o modo de recebimento PeekLock .

  4. Quando a operação de recebimento for concluída, as mensagens aparecerão na grade, conforme mostrado na imagem a seguir. Para visualizar 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 propriedades das mensagens mostradas.

    Nota

    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 de cada 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 você pode tomar nela.

Nota

Você só pode executar essas ações desde que tenha 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 indicando o botão Concluir.

    Importante

    Concluir uma mensagem é um recebimento destrutivo, ou seja, a mensagem é removida da fila quando Concluir é selecionado na ferramenta Service Bus Explorer.

Adiar uma mensagem

  1. Na grelha, selecione uma ou mais mensagens recebidas que pretende 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 para as quais você deseja abandonar o bloqueio.

  2. Selecione o botão Abandonar bloqueio.

    Captura de tela indicando o botão Abandonar bloqueio.

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

Carta não entregue

  1. Na grelha, selecione uma ou mais mensagens recebidas que pretende marcar como falha.

  2. Selecione o botão Dead-letter.

    Captura de ecrã indicando o botão Dead-letter.

Depois que uma mensagem é transferida para a lista de mensagens rejeitadas, ela fica disponível na subfila de mensagens rejeitadas.

Limpar mensagens

Para Limpar mensagens, selecione o botão Limpar mensagens do explorador do Service Bus.

Captura de tela indicando o botão de mensagens de limpeza.

Depois de inserir 'eliminar' para confirmar a operação, as mensagens serão eliminadas da respetiva entidade do barramento de serviço.

Enviar uma mensagem para uma fila ou tópico

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

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

  2. Em Corpo da mensagem, adicione o conteúdo da mensagem. Certifique-se de que corresponde ao Tipo de Conteúdo definido anteriormente.

  3. Defina as propriedades do Broker (opcional). Essas propriedades incluem ID de Correlação, ID de Mensagem, ReplyTo, Rótulo/Assunto, Tempo de Vida (TTL) e Tempo de Enfila 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. Marque Repetir 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. Quando a mensagem estiver redigida, selecione o botão Enviar .

    Captura de tela mostrando a experiência de redigir mensagem.

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

    • Se enviar para uma fila, o contador de métricas do Ative Messages será incrementado.
    • Se enviar para um tópico, o contador de métricas do Ative Messages será incrementado nas assinaturas para as quais a mensagem foi roteada.

Reenviar uma mensagem

Depois de espreitar ou receber uma mensagem, pode reenviá-la, enviando uma cópia da mensagem para a mesma entidade, permitindo-nos atualizar o conteúdo e as propriedades da mensagem. O original permanece e não é excluído, mesmo quando o reenvio é da fila de deadletters.

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

  2. Selecione o botão Reenviar mensagens selecionadas .

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

  3. Opcionalmente, selecione qualquer mensagem para a qual você deseja atualizar seus detalhes e faça as alterações desejadas.

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

    Captura de ecrã a mostrar a experiência de reenvio de mensagens.

    Nota

    • A operação de reenvio envia uma cópia da mensagem original. Ele 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 para o tópico. Portanto, todas as assinaturas recebem uma cópia da mensagem.

Alterar tipo de autenticação

Ao trabalhar com o Service Bus Explorer, é possível usar Chave de Acesso ou 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 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.

Passos Seguintes