# Traces

Source: https://instatus.com/help/pt-br/observability/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](https://instatus.com/help/observability/traces.png)

| At a glance | Details |
| :-- | :-- |
| [Encontrar](https://instatus.com/help/pt-br/observability/traces#encontre-requisições-lentas-e-com-erro) | status:error, duration:>1s, service: |
| [Abrir](https://instatus.com/help/pt-br/observability/traces#abra-um-trace) | Clique em uma linha para ver a cascata |
| [Corrigir](https://instatus.com/help/pt-br/observability/traces#corrija-uma-requisição-com-erro) | Copie um prompt de correção para seu agente de programação |
| [Logs](https://instatus.com/help/pt-br/observability/traces#abra-um-trace) | Vá aos logs de uma requisição |

Os traces chegam quando seu app os envia: marque **Traces** ao [copiar o prompt de configuração](https://instatus.com/help/pt-br/observability/send-logs#opção-1-copie-um-prompt), 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](https://instatus.com/help/pt-br/observability/logs#filtrar). 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.

![Um trace que passa por três serviços, com uma chamada lenta ao Okta no fim da cascata](https://instatus.com/help/observability/trace-waterfall.png)

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](https://instatus.com/help/observability/trace-error.png)

**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.

- [Métricas](https://instatus.com/help/pt-br/observability/metrics): Descubra o que mudou, a maior mudança primeiro
- [Logs](https://instatus.com/help/pt-br/observability/logs): Pesquise, filtre e acompanhe seus logs ao vivo
