Application Real-Time Monitoring Service:Trace Explorer

Legendas de status do span

O gráfico de barras na seção superior codifica por cores os códigos de status HTTP: 2XX (verde), 3XX (amarelo), 4XX (laranja) e 5XX (vermelho). Esses códigos vêm do campo attributes.http.status_code ou attributes.http.response.status_code. Se um span contiver ambos os campos, o código de status HTTP terá precedência sobre o indicador de estado do span.

Ações disponíveis

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

• Clique em Logs na coluna Actions para visualize logs relacionados ao trace. Consulte Análise de logs.

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

• Clique no ícone no canto superior direito para mostrar ou ocultar colunas da lista.

• Passe o mouse sobre um trace e clique no ícone para adicionar seus valores de parâmetro como condição de filtro.

Parâmetros de agregação

Exemplo de agregação

Considere um trace em que o Span A chama o Span B e o Span C:

Como ler esta tabela:

• Distribuição de requisições: O Span A tem 10 requisições (100%). Apenas 4 dessas requisições chamam o Span B (40%) e apenas 1 chama o Span C (10%). As requisições restantes ignoram o Span B e C 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 tem 8 spans em 4 requisições, então cada requisição chama o Span B duas vezes em média (multiplicador = 2,00).

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

• Distribuição de exceções: O Span A tem 2 exceções em 10 requisições (20%). O Span B tem 2 exceções em 4 requisições (50%). Como o multiplicador de requisição do Span B é 2,00, uma distribuição provável é: 2 das 4 requisições encontram uma exceção na primeira chamada, com a segunda chamada sendo bem-sucedida.

Análise de traces lentos

O ARMS analisa os 1.000 traces de maior duração e destaca as cinco dimensões mais correlacionadas com a lentidão.

Análise de traces com falha

O ARMS amostra aleatoriamente 1.000 traces com falha e destaca as cinco dimensões mais correlacionadas com as falhas.

Tags de componentes (1)

As tags representam tipos de chamada e contagens de spans. Os tipos de chamada são determinados pelo campo attributes.component.name. Clique em uma tag para mostrar ou ocultar seus spans relacionados.

Gráfico de barras do trace (2)

O gráfico de barras horizontais fornece uma visão geral de alto nível do trace e da distribuição de seus spans. Utilize-o para identificar rapidamente onde o tempo é gasto ao longo do trace.

• Cada barra representa um span. Apenas spans com duração superior a 1% da duração total do trace são exibidos.

• Cores distinguem diferentes aplicações. Na figura anterior, o azul representa a aplicação opentelemetry-demo-adservice.

• Uma linha preta dentro de cada barra representa o tempo próprio: a duração total do span menos o tempo gasto em spans filhos. Por exemplo, 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.

• A linha do tempo mostra o intervalo de tempo completo do trace.

Focar e filtrar spans (3)

Cada linha representa um span com sua hierarquia pai-filho. Spans pais exibem um número indicando a contagem de seus spans filhos. Operações disponíveis:

• Recolher/Expandir: Clique no ícone para recolher ou expandir um span e seus filhos.

• Focar: Selecione um span e clique no ícone para exibir apenas esse span e seus spans downstream.

• Desfocar: Clique no ícone para sair do modo de foco.

• Filtrar: Insira um nome de span, nome de aplicação ou atributo na caixa de pesquisa para filtrar o trace até os spans correspondentes e seu caminho até o span de entrada. Limpe a caixa de pesquisa e clique no ícone de Pesquisa para remover o filtro.

• Zoom: Clique no ícone para ampliar e ocultar o gráfico de barras. Clique no ícone para restaurá-lo.

Detalhes do span (4)

O painel de detalhes do span mostra atributos, métricas, logs e dados de exceção para o span selecionado.

• Additional Information: Exibe atributos do span, recursos, detalhes e eventos, agrupados por tipo. Para descrições dos campos, consulte Parâmetros do Trace Explorer.

• Metrics: Mostra métricas relacionadas ao span.

  • Para aplicações Java monitoradas pelo ARMS: métricas de JVM e do host.

  • Para traces de agentes open source: métricas do Método RED (taxa, erros, duração).

• Logs: Exibe logs de negócio vinculados ao trace. Se um Logstore do Simple Log Service (SLS) estiver configurado para a aplicação, consulte logs de negócio por ID de trace no Logstore.

• Exceptions: Mostra informações de exceção para o span, se houver.

• Event Config: Configure eventos de interação para um ou mais atributos de trace para acessar detalhes adicionais do trace ou logs e métricas relacionados. Consulte Configurar um evento de interação personalizado para um trace.

Por que as instruções SQL são truncadas nos traces?

O ARMS limita as instruções SQL a 1.024 caracteres por padrão. Para aumentar esse limite, acesse a aba Custom Configurations da sua aplicação e altere o Maximum retention length for SQL collection na seção Database call configuration.

Itens de configuração de chamada de banco de dados na aba Custom Configurations:

• Slow SQL Threshold: Padrão de 500 ms. Consultas SQL que excedem esse limiar são marcadas como SQL lento.

• Maximum Retention Length for SQL Collection: Padrão de 1.024 caracteres. Instruções SQL que excedem esse comprimento são truncadas.

• Display Variable Binding Values in SQL: Quando ativado, captura valores de vinculação de parâmetros PrepareStatement. Suportado apenas para MySQL.

• Display Constant Values in SQL: Ative para exibir valores constantes em instruções SQL.

• Record MySQL Query Return Value Size: Ative para registrar o tamanho dos valores de retorno de consultas MySQL.

Após configurar, clique em Save ou em Save and Batch Copy to Other Applications para sincronizar a configuração com outras aplicações.

Por que spans do Nacos com duração de 30 segundos aparecem após a atualização para o agente ARMS V4.x?

O agente ARMS 4.x instrumenta requisições de long polling HTTP que o Nacos utiliza para atualizações de configuração e descoberta de serviços. Esses spans não são capturados na V3.x. Para detalhes, consulte Anúncio de atualização do agente ARMS V4.x.

Para excluir esses spans, adicione uma regra de filtro na seção Interface call configuration na aba Custom Configurations da sua aplicação.

Na seção Interface Call Configuration da aba Custom Configurations, insira os caminhos de interface que deseja excluir na caixa de texto Invalid Interface Call Filter para suprimir esses spans. A seção também inclui Slow Call Threshold (padrão 500 ms), Exception Allowlist, HTTP Status Code Allowlist e vários alternadores para registro de métricas.