Application Real-Time Monitoring Service:Trace Explorer

Cores dos códigos de status HTTP

O gráfico de barras codifica as respostas por cores conforme a classe de status HTTP:

Os códigos de status são derivados de attributes.http.status_code ou attributes.http.response.status_code. Quando existem tanto um código de status HTTP quanto um status de span, o código de status HTTP tem precedência.

Indicadores de status do span

Barras coloridas no lado esquerdo da coluna TraceId indicam o status do span:

A coluna Status usa ícones para indicar o estado do span:

Ações na lista de rastros

• Clique em em um ID de rastro ou em Details na coluna Actions para visualize os detalhes e a topologia do rastro.

• Clique em em Logs na coluna Actions para visualize trace-correlated logs.

• Clique em no ícone para expandir todos os spans sob um ID de rastro. Por padrão, apenas os spans raiz são exibidos por rastro.

• Clique em no ícone no canto superior direito para personalizar as colunas exibidas na lista.

• Passe o mouse sobre um span e clique em no ícone para adicionar esse valor como condição de filtro.

Métricas de agregação

Exemplo de agregação

Considere um rastro onde o Span A chama o Span B e o Span C:

Como interpretar esta tabela:

• Distribuição de requisições: Todas as 10 requisições passam pelo Span A, mas apenas 4 chegam ao Span B e 1 chega ao Span C. As requisições restantes ignoram esses spans filhos devido a lógica condicional ou exceções.

• Frequência de spans: O Span A é chamado uma vez por requisição (multiplicador = 1,00). O Span B é chamado duas vezes por requisição, em média (8 spans / 4 requisições = 2,00), indicando um padrão de loop ou nova tentativa.

• Distribuição de tempo: O tempo próprio do Span A é de 5 ms (25% de sua duração total de 20 ms), o que significa que 75% do tempo é gasto em spans filhos. O Span B e o Span C têm 100% de tempo próprio porque não possuem filhos.

• Distribuição de exceções: O Span B apresenta 2 exceções em 4 requisições (proporção de exceções de 50%). Como cada requisição chama o Span B duas vezes, um padrão provável é: 2 requisições são totalmente bem-sucedidas, enquanto as outras 2 falham na primeira chamada, mas obtêm sucesso na nova tentativa.

Passe o mouse sobre um nome de span azul para ver um ID de rastro recomendado. Clique em no ID do rastro para visualize seus detalhes.

Análise de rastros lentos

O ARMS seleciona os 1.000 rastros mais longos e identifica cinco dimensões com maior correlação ao desempenho lento.

Detalhes de rastros lentos

O ARMS seleciona os 1.000 rastros mais longos acima de um limiar configurável e amostra 1.000 rastros abaixo dele. Ao comparar os dois grupos, o sistema destaca três características com maior correlação à alta latência.

Defina o limiar com base nos seus requisitos de desempenho. Por exemplo, para analisar rastros mais lentos que 1 minuto, defina o limiar como 60000 milissegundos.

Análise de rastros com falha

O ARMS seleciona aleatoriamente 1.000 rastros com falha e identifica cinco dimensões com maior correlação às falhas.

Detalhes de rastros com falha

O ARMS compara rastros com falha contra rastros normais e destaca três características com maior correlação aos erros.

Tags de componentes

As tags no topo da visualização agrupam os spans por tipo de chamada, conforme definido pelo campo attributes.component.name. Cada tag mostra o nome do tipo de chamada e sua contagem de spans. Clique em em uma tag para mostrar ou ocultar spans desse tipo.

Gráfico de barras da linha do tempo do rastro

Um gráfico de barras horizontais fornece uma visão geral visual de todo o rastro:

• Cada barra representa um span. Apenas spans que excedem 1% da duração total do rastro são mostrados.

• As cores distinguem as aplicações. Por exemplo, o azul pode representar opentelemetry-demo-adservice.

• Segmentos de linha preta dentro das barras indicam o tempo próprio — o tempo de processamento do span excluindo os spans filhos. Se o Span A leva 10 ms e seu filho Span B leva 8 ms, o tempo próprio do Span A é de 2 ms.

• O eixo da linha do tempo mostra o intervalo de tempo do rastro.

Árvore de spans e navegação

A árvore de spans exibe cada span como uma linha, mostrando as relações pai-filho por meio de recuo. Um número antes de cada span pai indica quantos spans filhos ele contém.

Controles disponíveis:

• Recolher/Expandir: Clique em no ícone para recolher ou expandir os filhos de um span.

• Focar: Clique em no ícone para isolar um span e suas chamadas downstream.

• Desfocar: Clique em no ícone para restaurar a visualização completa.

• Filtrar: Insira um nome de span, nome de aplicação ou atributo na caixa de pesquisa para filtrar a árvore. A visualização mostra o span correspondente e todos os spans ancestrais até o span de entrada. Limpe a caixa de pesquisa e clique em no ícone de Pesquisa para remover o filtro.

• Zoom: Clique em no ícone para ampliar e ocultar o gráfico de barras. Clique em no ícone para restaurar o gráfico de barras.

Painel de detalhes do span

Selecione um span para visualize seus detalhes no painel direito:

• Additional Information: Exibe atributos do span, recursos, detalhes e eventos, agrupados por tipo. Para definições de campos, consulte Trace Explorer parameters.

• Metrics: Mostra métricas relacionadas ao span. Para aplicações Java monitoradas pelo ARMS, isso inclui métricas de JVM e do host. Para rastros provenientes de agentes open-source, inclui métricas do Método RED (taxa, erros, duração).

  

• Logs: Logs de negócio correlacionados com este rastro. Se um Logstore do Simple Log Service (SLS) estiver configurado para a aplicação, clique em para consultar logs por ID de rastro.

• Exceptions: Detalhes de exceções para o span selecionado, se houver.

• Event Config: Configure eventos de interação personalizados para um ou mais atributos de span. Use esses eventos para vincular dados de rastro a logs relacionados, métricas ou sistemas externos. Para instruções de configuração, consulte Configure a custom interaction event for a trace.

Spans POST /ingest inesperados em rastros do ARMS

Se você vir spans com o nome de API POST /ingest em rastros do ARMS, as possíveis causas são:

• Uma requisição foi enviada para uma URL inexistente.

• A aplicação utiliza um servidor HTTP sem mecanismo de roteamento, como Netty puro.

• A requisição sofreu limitação (throttling) antes de chegar ao estágio de roteamento.

• O plugin Spring da aplicação ARMS está desativado.

Para ocultar esses spans, configure regras de filtragem de spans nas configurações da aplicação.