Share via


Rastreamento distribuído

O Azure Private 5G Core oferece uma GUI da Web de rastreamento distribuído, que você pode usar para coletar rastreamentos detalhados para fluxos de sinalização envolvendo instâncias principais de pacote. Você pode usar os rastreamentos para diagnosticar muitos problemas comuns de configuração, rede e interoperabilidade que afetam o serviço do usuário.

Acessar a GUI Web de rastreamento distribuído

Dica

Ao entrar, se você vir um aviso no navegador de que a conexão não é segura, talvez esteja usando um certificado autoassinado para atestar o acesso às ferramentas de monitoramento locais. Recomendamos seguir as instruções em Modificar a configuração de acesso local em um site para configurar um certificado HTTPS personalizado assinado por uma autoridade de certificação globalmente conhecida e confiável.

ID do Microsoft Entra

Para entrar na GUI da Web de rastreamento distribuído se você habilitou a autenticação do Microsoft Entra:

  1. No navegador, digite https:// domínio de monitoramento local/sas, em que domínio de monitoramento local é o nome de domínio>> das ferramentas de monitoramento local que você configurou em <Configurar nome do sistema de domínio (DNS) para IP de monitoramento local.<
  2. Siga as instruções para entrar com as credenciais da sua conta.

Nome de usuário e senha locais

Para entrar na GUI da Web de rastreamento distribuído se você tiver habilitado a autenticação de nome de usuário e senha local:

  1. No navegador, digite https://< IP> de monitoramento local/sas, em que <IP de monitoramento local é o endereço IP> para acessar as ferramentas de monitoramento local configuradas na rede de gerenciamento.

    Screenshot of the distributed tracing web G U I sign in page, with fields for the username and password.

  2. Entre usando as suas credenciais.

    Se estiver acessando a GUI Web de rastreamento distribuído pela primeira vez depois de instalar ou atualizar a instância de núcleo do pacote, você deve preencher os campos com o nome de usuário e a senha padrão. Posteriormente, siga os prompts para configurar uma nova senha que você usará na próxima vez que entrar.

    • Nome: admin
    • Senha: packetCoreAdmin

Depois de entrar na GUI Web de rastreamento distribuído, você pode usar o menu de nível superior para sair ou alterar suas credenciais. Selecione Sair para encerrar sua sessão atual e Alterar senha para atualizar sua senha.

Pesquisar informações específicas

A GUI da Web de rastreamento distribuído fornece duas guias de pesquisa para permitir que você procure o diagnóstico.

Se você não conseguir ver o título Pesquisar, selecione o botão Pesquisar no menu de nível superior.

  • SUPI – permite que você pesquise atividades envolvendo um determinado assinante usando o SUPI (identificador permanente de assinatura) ou, em redes 4G, sua IMSI (identidade internacional de assinante móvel). Essa guia também fornece o painel Erros, que permite filtrar os resultados por condição de erro. Para procurar a atividade de um assinante específico, insira todos os dígitos iniciais do SUPI ou da IMSI do assinante na caixa de texto no painel de pesquisa SUPI.

  • Erros – Permite que você procure ocorrências de condições de erro em todos os assinantes. Para procurar ocorrências de condições de erro em todos os assinantes, selecione a guia Erros e, em seguida, use os menus suspensos no painel Erro para selecionar uma categoria de erro e, opcionalmente, um erro específico.

    Screenshot of the Search display in the distributed tracing web G U I, showing the S U P I and Errors tabs.

Ambas as guias também fornecem um painel Intervalo de data/hora que permite especificar uma janela de tempo personalizada para pesquisar dados de diagnóstico. Você pode especificar essa janela de tempo de várias maneiras.

  • Selecione Mais recente e escolha uma opção para procurar registros nos 15 minutos, 30 minutos, 1 hora ou 2 horas mais recentes.
  • Selecione Hoje, Ontem ou uma data específica e, em seguida, escolha um intervalo de uma hora na data especificada, selecionando a faixa de opções.
  • Selecione Intervalo personalizado e especifique as datas e horas para o início e o término do período de pesquisa. Os intervalos personalizados permitem que você especifique um período de pesquisa que abrange dias consecutivos.

Os intervalos de pesquisa longos resultam em pesquisas mais lentas, portanto, é recomendável manter o intervalo de pesquisa em uma hora ou menos, se possível.

Dica

Você pode selecionar o ícone de engrenagem ao lado do título Intervalo de data/hora para personalizar o formato de data e hora, o período de pesquisa padrão e o fuso horário de acordo com suas preferências.

Depois de entrar nos parâmetros de pesquisa escolhidos, selecione Pesquisar. A imagem a seguir mostra um exemplo dos resultados retornados para uma pesquisa em um SUPI específico.

Screenshot of search results on a specific S U P I in the distributed tracing web G U I. It shows matching Successful P D U Session Establishment records.

Você pode selecionar uma entrada nos resultados da pesquisa para exibir informações detalhadas sobre esse fluxo de chamada ou erro.

Exibir detalhes de diagnóstico

Quando você seleciona um resultado específico, a exibição mostra as guias a seguir que contêm diferentes categorias de informações.

Observação

Além das guias descritas abaixo, a GUI da Web de rastreamento distribuído também inclui a guia Experiência do Usuário. Essa guia não é usada pelo Azure Private 5G Core e não exibirá informações.

Exibição de Resumo

A exibição Resumo mostra uma descrição do fluxo ou do erro.

Screenshot of the Summary view of the distributed tracing web G U I, providing detailed information on a Successful P D U Session Establishment record.

Exibição Linha do Tempo Detalhada

A exibição Linha do Tempo Detalhada mostra a sequência de operações e eventos que ocorreram durante o fluxo ou o erro.

Screenshot of the Detailed Timeline view of the distributed tracing web G U I. It shows messages sent between Network Functions and other components.

Cada entrada na lista mostra informações resumidas para um evento específico que ocorreu durante o fluxo ou o erro. Cada entrada inclui a data e a hora em que o evento ocorreu e o nome do componente em que ocorreu. Quando você seleciona uma entrada específica nessa lista, o painel na parte inferior da tela fornece mais detalhes sobre o evento selecionado.

O menu suspenso Eventos a serem exibidos permite controlar o nível dos eventos incluídos na lista. É possível escolher um dos seguintes níveis:

  • Eventos de alto nível – O nível mais baixo de detalhes, com um resumo de uma linha de cada evento.
  • Eventos de alto nível e fluxos de protocolo – inclui as mesmas informações que os Eventos de alto nível, mas adiciona detalhes do conteúdo das mensagens de protocolo de rede envolvidas em cada estágio.
  • Eventos detalhados – inclui as mensagens de protocolo de rede e maiores detalhes dos eventos.
  • Eventos de nível de engenharia – fornece uma lista detalhada de eventos internos, normalmente para ser usada pela equipe da Microsoft.

Exibição Fluxo de Chamadas

A exibição Fluxo de Chamadas mostra a sequência de mensagens que fluem entre os componentes no decorrer do fluxo ou do erro.

Screenshot of the Call Flow view of the distributed tracing web G U I. It shows the messages exchanged during a Successful P D U Session Establishment.

As linhas verticais no diagrama mostram os componentes de rede envolvidos no fluxo.

  • As linhas pretas indicam as Funções de Rede de núcleo de pacotes que registraram o envio ou recebimento de mensagens para esse fluxo.
  • As linhas cinzas indicam os outros componentes que não registram mensagens.

Você pode personalizar a exibição mostrando ou ocultando colunas individuais e dando a elas nomes de exibição mais descritivos. Para exibir essas opções, selecione o nome da coluna atual e o sinal + (mais) que aparece à direita para abrir um menu suspenso. Além disso, você pode selecionar várias colunas mantendo a tecla Ctrl pressionada, à medida que você seleciona cada coluna. O sinal + (mais) permanece ao lado da coluna mais recente selecionada.

  • A opção Remover esta coluna oculta a coluna selecionada na exibição no momento.
  • A opção Remover outras colunas oculta todas as colunas que não incluem mensagens com fluxo de entrada ou saída na coluna selecionada.
  • A opção Agrupar colunas permite combinar várias colunas em uma única coluna.
  • A opção Desagrupar colunas permite que você reverta a opção Agrupar colunas.
  • A opção Mostrar mensagens no grupo mostra as mensagens entre os membros do grupo como setas que voltam para a coluna de origem.
  • A opção Definir anotação permite que você insira um novo nome de exibição para a coluna.

Você pode reverter para as opções de exibição padrão usando o menu Opções. Você pode acessar esse menu selecionando a engrenagem branca em uma tela de fundo azul no canto superior direito da janela de exibição. Você pode executar as seguintes ações:

  • Escolha Cores, estilos e anotações –> Reverter para o padrão para limpar os nomes de exibição personalizados.
  • Escolha Visibilidade –> Mostrar Todos para restaurar as colunas que você já ocultou na exibição.
  • Escolha Agrupamento de colunas –> Desagrupar todos para separar as colunas que você já agrupou.

Uma linha horizontal no diagrama mostra cada mensagem de sinalização individual que flui entre dois componentes de rede. Uma seta indica a direção do fluxo do componente de envio para o de recebimento.

  • Uma linha dupla indica que a mensagem foi registrada nos componentes de envio e recebimento.
  • Uma única linha indica que a mensagem foi registrada por apenas um desses componentes, porque o outro componente não registra mensagens.
  • Uma linha que é metade dupla e metade simples, com um símbolo X no ponto médio, indica uma das seguintes opções:
    • A mensagem deveria ter sido registrada em ambos os componentes, mas foi registrada por apenas um deles. Por exemplo, isso ocorre se uma mensagem é registrada pelo componente de envio, mas é perdida em trânsito e nunca chega ao componente de recebimento.
    • A mensagem foi ultrapassada por outra mensagem no diagrama, enquanto estava em trânsito e, portanto, foi recebida fora de ordem.
    • As mensagens foram registradas na ordem errada. Isso não indica um problema na implantação e pode acontecer devido à latência de rede nas comunicações.
  • Uma mensagem retransmitida é exibida como uma linha separada para cada retransmissão.
  • Uma linha em loop que retorna para a mesma coluna indica uma mensagem entre os membros do grupo.

As cores e os estilos de linha diferentes (tracejados, pontilhados e assim por diante) para linhas horizontais são usados para distinguir entre diferentes trechos de chamada.

As mensagens aparecem no diagrama na ordem em que ocorreram. Uma quebra de eixo em todas as linhas verticais no diagrama entre duas mensagens consecutivas indica uma lacuna de 10 segundos ou mais entre essas duas mensagens.

Se o diagrama de fluxo de chamadas for muito grande para caber na janela do navegador, você poderá usar as barras de rolagem vertical e horizontal para se mover pela exibição.

Exibir informações da ajuda

Para exibir informações de ajuda, selecione o símbolo Opções no canto superior direito e escolha Ajuda. As informações de ajuda aparecem em um painel na parte inferior da exibição. Para ocultar esse painel, selecione o símbolo X no canto superior direito do painel.

Próximas etapas