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 traces para ver detalhes sobre ele. Por padrão, você verá o Entity map, com um controle para voltar à experiência de mapa anterior.
A página de detalhes do trace oferece três maneiras de monitorar um trace: Map, Timeline e Latency. Map é a visualização padrão ao abrir um trace.
A visualização Map, também chamada de Entity map, é selecionada por padrão quando você abre um trace. Ela mostra todas as entidades amostradas no trace e como elas se relacionam entre si, usando os mesmos ícones isométricos e controles do Maps, que abrange a navegação geral do mapa, ícones de nós e controles de interface compartilhados em todos os mapas da New Relic.
Dica
Se preferir usar a experiência de mapa anterior, clique em Switch to old map.
Um único trace pode envolver centenas de entidades, o que pode poluir o mapa e dificultar a navegação. Para manter o mapa organizado, as entidades com baixas pontuações de anomalia são agrupadas automaticamente em um cluster, enquanto as entidades mais importantes (por exemplo, aquelas com erros ou anomalias) permanecem visíveis fora do cluster. Para visualizar e gerenciar entidades dentro de um cluster:
- Clique no nó do cluster. Uma lista de todas as entidades nesse cluster aparece no painel direito.
- Para exibir uma entidade separadamente no mapa, clique no ícone de visibilidade correspondente no painel direito.
No canto superior direito da guia Trace details, altere a visualização de Map para Timeline.
A visualização de linha do tempo é uma visualização de alta densidade de todos os spans no trace. Esta visualização permite que você role rapidamente por todo o trace e veja como a latência e os erros se propagam pelo trace e pelos limites da entidade. Você pode selecionar spans desta visualização para ver os detalhes do span no waterfall view abaixo.
No canto superior direito da guia Trace details, altere a visualização de Map para Latency.
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.
Monitorar operações em um trace
É possível monitorar todas as operações que compõem um distributed trace, até o contexto exato de onde surgem a latência e os erros, por meio do waterfall view. Isso permite identificar exatamente onde ocorreu um problema no trace.
Na parte inferior da guia Trace details, você pode expandir o trace para obter o waterfall view. A interface indica as propriedades de span com estes ícones:
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.