A página Trace Analysis permite analisar dados de traces da sua aplicação. Nela, você visualiza gráficos de séries temporais com métricas principais, uma lista de traces e as abas Application Topology e End-to-End Aggregation.
Procedimento
Faça login no console do ARMS. No painel de navegação à esquerda, escolha .
-
Na página Applications, selecione uma região na barra de navegação superior e clique em o nome da aplicação.
NotaSe o ícone
aparecer na coluna Language, a aplicação está conectada ao Application Monitoring. Caso seja exibido um hífen (-), a aplicação utiliza o Managed Service for OpenTelemetry. Faça login no console do Managed Service for OpenTelemetry. No painel de navegação à esquerda, clique em Applications.
Na página Applications, selecione uma região na barra de navegação superior e clique em o nome da aplicação.
-
No painel de navegação à esquerda, clique em Trace Analysis.
O topo da página de análise de traces exibe a seção Time change trend, que inclui os gráficos Count trend, Duration trend e Span duration distribution. O painel esquerdo mostra a lista de filtros de Span name, enquanto os botões à direita permitem alternar entre as visualizações All Spans e API Calls. Abaixo dessa seção, há três abas: Traces, Application Topology e End-to-End Aggregation. A tabela de detalhes do trace apresenta colunas como ID do trace, horário, nome do span, duração e endereço IP. No canto inferior esquerdo, encontra-se o painel de filtros Machine/IP.
Ativar análise completa de dados em tempo real
Ative a análise completa de dados em tempo real para examinar todo o conjunto de dados de traces armazenados referente a uma taxa de amostragem específica.
Caso nenhuma taxa de amostragem esteja definida, ou se ela estiver configurada como 100%, ativar esse recurso exibirá todos os dados armazenados da sua conta.
No canto superior direito da página Trace Analysis, clique em Enable full real-time analysis.
-
No painel exibido à direita, selecione um período para a análise.
A página Trace Analysis é atualizada para mostrar os dados completos da análise do período selecionado em tempo real.
Filtrar traces
Clique em o seletor de horário no canto superior direito da página Trace Explorer para definir o intervalo de tempo da consulta.
-
Clique em a caixa de pesquisa no topo da página Trace Explorer. Na janela de filtros exibida, configure as condições desejadas e clique em Search.
Insira os valores mínimo e máximo em Time Consumed para buscar traces dentro desse intervalo específico.
Marque a caixa de seleção Abnormal para consultar traces que contenham exceções.
Adicione condições de filtro para Span Name, Machine/IP ou Tag. É possível incluir múltiplos valores para Span Name, Machine/IP ou Tag.
Tendência de variação temporal
A seção Time change trend apresenta um gráfico de série temporal com contagens de spans e exceções, além de gráficos de tendência e distribuição da duração dos spans.
Na seção Time change trend, estão disponíveis as seguintes ações:
Passe o mouse sobre um gráfico para visualizar estatísticas detalhadas.
Clique em e arraste sobre um período no gráfico para ampliar esse intervalo.
Clique em um item da legenda para ocultar ou mostrar a série de dados correspondente.
Listas de Span name e Machine/IP
As seções Span Name e Machine/IP exibem listas contendo todos os spans e máquinas.
Nas seções Span Name e Machine/IP, realize as seguintes operações:
Digite uma palavra-chave na caixa de pesquisa e clique em o ícone de busca para filtrar os itens da lista atual.
Clique em Span Count ou Response Time no canto superior direito da lista para ordenar os itens em ordem decrescente.
Clique em o nome de um span ou no endereço IP de uma máquina para adicioná-lo como condição de filtro.
Lista agrupada
Na página Trace Analysis, selecione um campo na seção Group By.
-
À direita, defina se a consulta deve abranger All spans ou API calls.
All Spans: Exibe uma lista de grupos para o campo atual, baseada em uma consulta de todos os spans.
API call: Apresenta uma lista agrupada para o campo atual, fundamentada na consulta do primeiro span.
Clique em o nome de um campo nos resultados para ver a lista de traces correspondente.
Traces
A área Traces mostra o ID do trace, horário, nome do span, duração e endereço IP de cada trace.
Na área Traces, execute as seguintes ações:
Clique em o ID de um trace para visualizar seu gráfico de cascata. Para mais informações, consulte Gráfico de cascata.
Passe o mouse sobre o nome de um span para ver detalhes como duração, horário de início, tags e eventos de log.
Topologia da aplicação
A aba Application topology exibe um grafo de dependências entre aplicações, juntamente com métricas como porcentagem de requisições, multiplicador de chamadas e proporções de duração. Por questões de desempenho, a topologia da aplicação agrega até 5.000 traces.
Porcentagem de requisições = Número de requisições de saída / Número total de requisições de entrada. Por exemplo, se uma aplicação upstream A recebe 100 requisições, mas faz apenas 90 requisições para uma aplicação downstream B, a porcentagem de requisições de A para B é de 90%. Isso ocorre porque a aplicação A pode conter uma instrução
ifpara filtrar requisições, impedindo que algumas sejam repassadas à aplicação B.Multiplicador de chamadas = Número de spans para chamadas de saída de uma aplicação / Número total de spans da aplicação. Se 100 spans entrarem na aplicação upstream A e 300 spans forem gerados de A para chamar a aplicação downstream B, o multiplicador de chamadas de A para B será 3. Quando a chamada de A para B é exibida como 90%/3x, isso indica que 90% das requisições para a aplicação A chamam a aplicação B, e que a aplicação A chama a aplicação B três vezes, em média.
Agregação ponta a ponta
A aba End-to-end aggregation apresenta uma tabela de traces agregados por nome de span e nome da aplicação. Devido a restrições de desempenho, essa agregação em tempo real processa até 5.000 traces.
Número de requisições/Porcentagem de requisições: A porcentagem de requisições representa a fração de requisições que chamam o nó do span atual. Se o total de requisições for 100 e a porcentagem for 10%, significa que 10 requisições chamaram o span atual. Fórmula = Número de requisições para o span atual / Número total de requisições × 100%.
Contagem de spans/Multiplicador de requisições: O multiplicador de requisições indica a média de vezes que o span atual é chamado por requisição. Um valor de 1,5x significa que, em média, cada requisição chama o span atual 1,5 vezes. A fórmula é: Contagem de spans / Número de requisições que incluem o span.
Tempo próprio médio decorrido/Proporção: O tempo próprio médio decorrido corresponde à duração média de um span, excluindo o tempo gasto em seus spans filhos. Se o Span A tem duração de 10 ms e seu filho, Span B, dura 8 ms, o tempo próprio decorrido do Span A é de 2 ms. A fórmula é: Duração do span - Soma(duração dos spans filhos). Em chamadas assíncronas, as durações dos spans filhos não são subtraídas; portanto, a fórmula é simplesmente: Duração do span.
Contagem de exceções/Porcentagem de exceções: A porcentagem de exceções refere-se à parcela de requisições que apresentaram falhas. Uma taxa de 3% indica que 3% das requisições tiveram exceções. Fórmula: Número de requisições com exceção / Número total de requisições. Vale notar que o número de requisições com exceção difere da contagem total de exceções. Quando o multiplicador de requisições é maior que 1, uma única requisição com falha pode gerar múltiplas exceções.
Na seção Trace Aggregation, realize as seguintes ações:
Passe o mouse sobre um nome de span (em azul) para ver uma dica de ferramenta com Recommended Trace. Clique em o ID do trace para visualizar seu gráfico de cascata. Para mais detalhes, consulte Gráfico de cascata.
Clique em o nome de uma aplicação para acessar sua página de visão geral. Para mais informações, veja Visão geral da aplicação.
Gráfico de cascata
A página do trace exibe o gráfico de cascata, que mostra informações como nomes de spans, linha do tempo, nomes de aplicações, horários de início, endereços IP e status.
A coluna IP Address mostra um endereço IP ou o nome da máquina, dependendo das configurações de exibição na página Application Settings. Para mais informações, consulte Gerenciar aplicações e tags.
Na coluna Span Name, passe o mouse sobre o nome de um span para visualizar sua duração, horário de início, tags e eventos de log. Ao clicar em um span, o painel de detalhes é aberto. O lado esquerdo do painel lista os métodos dentro do trace, como checkAndRefresh, getAppConfig e writeLog. O lado direito mostra os detalhes do span selecionado, incluindo Service, Duration (em ms) e Start Time. O painel também contém uma área de Tags, que exibe pares chave-valor como pid, sn e userId, além de uma área de Log Events.