Depois de selecionar um trace na lista trace , você será direcionado para a página de detalhes trace na interface do usuário. Use os detalhes trace para entender o fluxo de operações que compõem um distributed trace e ajuste a visualização para encontrar as informações mais importantes para você.
Selecione um trace na lista de rastreamentos para ver detalhes sobre ele.
Confira maneiras de exibir os intervalos do seu rastreamento:
A visualização da linha do tempo é uma visualização de alta densidade de todos os intervalos no trace. Essa visualização permite rolar rapidamente por todo trace e ver como a latência e os erros se propagam pelo trace e pelos limites da entidade. Você pode selecionar extensões nesta visualização para ver os detalhes da extensão na visualização em cascata abaixo dela.
A visualização de latência mostra quanta latência é contribuída por cada entidade no trace, bem como o número de intervalos de erro por entidade. A latência contribuída por uma entidade é o tempo transcorrido em que ela tinha um ou mais processos em execução, mas não estava fazendo nenhuma chamada externa ou de banco de dados. Aqui estão dois exemplos:
Se uma entidade tiver um processo com duração de 500 ms, mas durante 400 ms desse tempo estiver fazendo uma chamada externa, isso será mostrado como contribuindo com 100 ms de latência para o trace.
Se uma entidade tiver três processos em execução em paralelo por um segundo e nenhum deles tiver feito chamadas externas, isso será mostrado como contribuindo com um segundo de latência para o trace.
A visualização em cascata na seção inferior da página exibe um fluxo detalhado de todas as operações que compõem o distributed trace. Isso permite que você veja o contexto exato de onde surgem a latência e os erros.
Controles de cascata
A visualização em cascata possui vários controles para facilitar a localização de trechos importantes para você:
Expand all/Collapse all: Use esta opção para alternar entre mostrar todos os trechos (incluindo trechos em processamento) e mostrar trechos recolhidos.
Standard/Manual: no modo padrão, você obtém uma visualização semi-expandida que inclui o primeiro intervalo de cada processo. No modo manual, você vê apenas o que expande.
- Ambos Standard e Manual são substituídos por Expand all, que exibe todos os períodos.
- Se você estiver no modo padrão ou manual e clicar em Collapse all, a cascata será redefinida para o padrão do modo que você está usando.
Focus onSe o seu span apresentar erros ou anomalias, você verá caixas de seleção para cada um desses tipos. Se você marcar essas caixas, a visualização em cascata irá ocultar todos os outros tipos de trechos e mostrar apenas os trechos com erros ou anomalias codificados por cores. Esta é uma maneira rápida de encontrar trechos problemáticos.
Maximize: Isso permite que você veja mais trechos na tela expandindo a cascata e ocultando o mapa de entidades.
Propriedades de extensão em cascata
A interface indica propriedades de span com estes ícones:
Propriedade de extensão
Indicador
Descrição
Serviço
Este ícone representa um intervalo que é o ponto de entrada de um serviço.
Em processo
Este ícone representa um span em processamento, que é um span que ocorre dentro de um processo (em oposição a um span entre processos). Exemplos: instrumentação de middleware, spans criados pelo usuário.
Armazenamento de dados
Este ícone representa uma chamada span para um armazenamento de dados.
Externo
Este ícone representa uma categoria que representa uma chamada para um serviço externo feita via HTTP.
Aplicativo de browser
Este ícone representa uma extensão de aplicativo do browser.
Lambda
Este ícone representa um intervalo de uma função do Lambda.
Alguns períodos terão indicadores adicionais:
Propriedade de extensão
Indicador
Descrição
Tipo de conexão
As linhas sólidas indicam um relacionamento direto entre pais e filhos; em outras palavras, um processo ou função chamando outro diretamente. Uma linha pontilhada indica um relacionamento não direto. Para obter mais informações sobre relacionamentos entre extensões, consulte Estrutura de rastreamento.
Erros
Um intervalo com um erro. Consulte Como entender erros de span.
Anômalo
Este ícone representa a detecção de um intervalo anômalo.
Períodos órfãos
Alguns spans podem ser "órfãos" ou separados do trace. Esses intervalos aparecerão na parte inferior do trace. Para obter mais detalhes, consulte Rastreamento fragmentado.
Vários nomes de aplicativos
Ao lado de um nome de extensão, representa uma entidade que teve vários nomes de aplicativos definidos. Selecione esta opção para ver todos os nomes de aplicativos aos quais ele se reporta. Para pesquisar dados trace por nomes de aplicativos alternativos, use o atributo
appName.Diferença de horário cliente/servidor
Se o indicador de duração de um período não estiver completamente colorido (como neste exemplo), significa que há uma discrepância de tempo entre a duração do lado do servidor e a duração do lado do cliente para essa atividade. Para obter detalhes sobre isso, consulte Diferença de horário cliente/servidor.
Painel de detalhes do intervalo
Quando você seleciona um intervalo, um painel é aberto com detalhes do intervalo. Esses detalhes podem ser úteis para questões de desempenho de resolução de problemas. Esta página possui três guias:
- PerformanceVocê verá gráficos mostrando a duração média e as taxas de transferência para essa operação de span, bem como a comparação do desempenho desse span específico com a média.
- Attributes: Você pode aprender mais sobre atributo em nosso dicionário de dados.
- Details: Você pode visualizar detalhes, como o nome completo e a fonte de dados do intervalo .
- Span linksSe o elemento span contiver links do tipo span, você verá esta aba. Isso demonstra relações causais com trechos de outros registros. Saiba mais sobre links span.
O que um intervalo exibe é baseado em seu tipo de intervalo. Por exemplo, os detalhes do intervalo do armazenamento de dados incluirão a consulta ao banco de dados. Para obter mais informações sobre a estrutura trace e como as propriedades de span são determinadas, consulte Estrutura de rastreamento.
Entendendo links de extensão
Os links de extensão ajudam você a entender as relações causais entre extensões em diferentes rastreamentos. Quando os rastreamentos são divididos devido à comunicação assíncrona ou a processos de longa duração, os links de extensão permitem navegar entre rastreamentos relacionados e visualizar o panorama completo de seus sistemas distribuídos.
Quando o rastreamento é dividido
Em sistemas distribuídos modernos, o rastreamento pode aparecer como um rastreamento separado e desconectado nos seguintes cenários:
- Long-running workflows: Tarefas em segundo plano ou fluxo de trabalho que excedam os limites de duração trace (mais de 90 segundos para Amostragem baseada em cabeçalho, mais de 20 segundos para Rastreamento Infinito) ou que sejam executadas por períodos prolongados.
Ao rastrear uma fila de mensagens, geralmente é recomendável usar links span para associar o rastreamento do(s) produtor(es) e do(s) consumidor(es). Exemplos incluem:
- General asynchronous message queues: Um serviço publica mensagens em uma fila (como AWS SQS, RabbitMQ ou Kafka), e outro serviço as consome posteriormente.
- Batch-processing: Trabalhadores que processam várias mensagens em lotes, onde cada mensagem se origina de um tracediferente.
- Fan-in pattern: Vários serviços produzem mensagens de forma independente, que são agregadas por um único consumidor.
- Fan-out pattern: Vários consumidores consomem de uma mesma fila de mensagens, cada um iniciando seu próprio trace
Quando os registros são divididos dessa forma, as relações tradicionais entre pais e filhos não capturam o quadro completo. Os links Span preenchem essa lacuna ao criar conexões causais explícitas.
O que são links span?
Os links de span são atributos OpenTelemetry que criam relações causais entre spans que não possuem uma conexão direta pai-filho. Eles permitem que você:
- Navegue de um intervalo consumidor de volta para o intervalo produtor.
- Compreenda todo o fluxo da solicitação, mesmo quando os rastreamentos estiverem divididos.
- Depurar problemas que se estendem por vários limites do assíncrono
Um link de span inclui o ID trace e o ID do span relacionado, permitindo que New Relic conecte o rastreamento para você.
Identificando traços com links de extensão
Na interface de detalhes trace, os rastreamentos com links de extensão são marcados de diversas maneiras:
- Span links filter badge: Na barra de filtro trace, você verá um indicador mostrando o número de spans com links (por exemplo,
span links (2)). - Span count indicator: Ao visualizar a lista de spans, cada span exibe a contagem de links, caso possua links internos.
O indicador de filtro de links de trechos aparece na barra de filtros trace quando um trace contém trechos com links.
Links de visualização
Para visualizar e navegar pelos links do span:
Na página de detalhes trace, selecione um intervalo na dropdown de links de intervalo.
No painel de detalhes do intervalo, clique na guia Span links.
Você verá uma lista de rastreamentos vinculados com as seguintes informações:
- Direction badge:
Forwardindica um intervalo que ocorreu posteriormente (sucessor), enquantoBackwardindica um intervalo que ocorreu anteriormente (predecessor). - Trace ID: O ID do trace vinculado (truncado para exibição).
- Timestamp: Quando o intervalo vinculado ocorreu.
- Duration: Quanto tempo levou para o trecho vinculado carregar.
- Errors: Número de erros no trace vinculado.
- Direction badge:
Clique em um trace vinculado para navegar até ele. Use o botão Voltar do seu navegador para retornar ao trace original.
A aba "Links Span" exibe o rastreamento vinculado com indicadores de direção (Avançar/Retroceder), IDs trace, carimbo de data/hora, durações e contagens de erros.
Dica
Understanding forward vs. backward links
- Forward links: Apontar para o evento que ocorreu como resultado do intervalo atual. Exemplo: Uma mensagem foi publicada por este intervalo e processada posteriormente por outro trace.
- Backward links: Indique o traço que causou o intervalo atual. Exemplo: Este intervalo está processando uma mensagem que foi publicada por um trace anterior.
Quando os links span não aparecem
Se você espera ver links span, mas eles não estão aparecendo, verifique o seguinte:
Quando um trace não tiver links de extensão, você verá esta mensagem na guia Links de extensão.
Para obter mais informações sobre a implementação de links de span em sua instrumentação, consulte nosso guia de práticas recomendadas para rastreamentoOpenTelemetry .
Atributo do período
Se quiser saber mais sobre dados de Span :
- Explore seus dados de span usando o criador de consulta.
- Para ver o atributo padrão anexado aos dados span, use o dicionário de dados.
- Confira estes exemplos de consulta para obter ajuda com a consulta NRQL usando esses atributos.
Ver registro relacionado
Se você estiver usando nosso recurso de logs contextualizados , poderá ver qualquer log vinculado ao seu rastreamento:
- Vá para a página de detalhes trace clicando em um trace.
- No canto superior esquerdo da página de detalhes do período, clique na guia Logs .
- Para obter detalhes relacionados a uma mensagem individual do log, clique diretamente na mensagem.