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.

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:
| Filtro | Encontra |
|---|---|
status:error | Requisições que falharam |
duration:>1s | Requisições com mais de um segundo. Também >500ms, <100ms |
service:api | Requisições atendidas por um serviço |
span.name: | Spans com um nome específico, como GET /v1/users |
| Qualquer atributo | Como 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.

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.

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.