Traces

Um trace é uma requisição, acompanhada por cada serviço que ela toca. Cada etapa é um span: uma chamada HTTP, uma consulta ao banco de dados, uma chamada a outro serviço. Os traces mostram onde uma requisição lenta gastou seu tempo e onde uma com erro quebrou.

Abra Observability → Traces na sua página de status. Cada linha é uma requisição.

O explorador de traces, com a duração das requisições ao longo do tempo e uma linha por requisição

Os traces chegam quando seu app os envia: marque Traces ao copiar o prompt de configuração, ou use a autoinstrumentação.

Leia o gráfico

Cada ponto é uma requisição, posicionada por quando aconteceu e quanto durou. Pontos vermelhos falharam. Acima do gráfico:

  • Traces: quantas requisições a pesquisa encontrou.
  • Erros: quantas falharam e a proporção.
  • p50, p95, p99: metade, 95% e 99% das requisições foram mais rápidas que isso.

Arraste sobre o gráfico para dar zoom em uma janela de tempo.

Encontre requisições lentas e com erro

Use a caixa de pesquisa como na página Logs. Estes filtros foram feitos para traces:

FiltroEncontra
status:errorRequisições que falharam
duration:>1sRequisições com mais de um segundo. Também >500ms, <100ms
service:apiRequisições atendidas por um serviço
span.name:Spans com um nome específico, como GET /v1/users
Qualquer atributoComo http.route: ou http.response.status_code:

O texto livre pesquisa nos nomes dos spans. Spans raiz vem ativado, então cada requisição aparece uma vez. Desative para listar cada span separadamente.

O botão de download exporta a lista em CSV.

Abra um trace

Clique em uma linha. O trace abre com cada span em uma linha do tempo, aninhado sob o span que o chamou. As barras longas mostram para onde o tempo foi.

Um trace que passa por três serviços, com uma chamada lenta ao Okta no fim da cascata

Neste exemplo, carregar uma página leva 842 ms. A cascata mostra o motivo: web chama api, api chama sso e sso espera 468 ms pelo Okta.

  • Clique em um span para ver seus atributos, como a rota, o código de status ou a consulta ao banco.
  • N logs deste span abre os logs gravados durante esse span.
  • N logs no topo abre cada log da requisição, em todos os serviços.
  • Copiar ID do trace copia o ID, para compartilhar ou pesquisar com trace_id:.
  • Use ↑ ↓ ou J K para ir ao trace anterior ou ao próximo, e Esc para fechar.

Corrija uma requisição com erro

Spans com falha ficam em vermelho. Só erros esconde os que funcionaram, para a falha se destacar em um trace longo.

Uma requisição com falha, com os spans de erro em vermelho e um botão para copiar um prompt de correção

Copiar prompt para corrigir copia uma descrição da requisição com falha: os spans, seus erros e atributos. Cole no seu agente de programação, no projeto do seu app, e ele terá o que precisa para achar a causa.