> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Erros no Web Analytics: 5xx, 4xx e rotas com falha

> A sub-aba Erros mostra os erros de servidor (5xx) no tempo, quais rotas mais falham e por que os erros 4xx são opcionais e barulhentos.

A sub-aba Erros mostra quais requisições falharam, com que frequência e em quais rotas, para você distinguir um problema real de ruído de fundo. Está disponível em todos os planos.

Os mesmos dados pela API: [Erros da aplicação](https://docs.vertracloud.app/pt-br/api-reference/endpoint/apps/analytics/errors.md).

## 5xx: seu app tem um problema

Um status que começa com **5** (`500`, `502`, `503`, `504`) significa que o servidor não conseguiu responder. O visitante vê isso como página quebrada, por isso eles sempre aparecem.

Causas comuns: uma exceção no seu código, um banco de dados que não responde, um app reiniciando ou sem memória, ou uma requisição que demorou demais. Combine esta aba com os [logs da aplicação](https://docs.vertracloud.app/api-reference/endpoint/apps/logs.md) para achar a causa.

## 4xx: opcional

Um status que começa com **4** (`400`, `401`, `403`, `404`, `429`) significa que a própria requisição foi recusada ou apontava para algo que não existe. Eles ficam ocultos por padrão; ligue **Incluir 4xx** para vê-los.

> [!WARNING]
>
> **4xx é ruidoso.** Bots e scanners testam o tempo todo endereços como `/wp-login.php` ou `/.env`, o que gera uma enxurrada de `404` que não diz nada sobre a saúde do seu site. Uma contagem alta de 4xx é normal em qualquer site público. Olhe para ela só quando estiver atrás de algo específico, como um link quebrado nas suas próprias páginas ou um `401` que o seu login não deveria devolver.

## O que a aba mostra

* **Totais por classe:** quantos 5xx (e 4xx, se incluídos) no período.
* **Erros ao longo do tempo:** um gráfico, para ver se os erros começaram com um deploy ou em certo horário.
* **Rotas com mais erros:** para cada rota, a **contagem** e a **taxa** de erro. Use as duas: uma rota com 3 erros em 3 requisições (100%) é um problema diferente de uma com 300 em 100.000 (0,3%).
* **Distribuição por status:** como os erros se dividem entre `500`, `502`, `504`, `404` e assim por diante. Cada classe aponta para uma causa diferente.

## Investigando

1. Procure o momento em que a linha sobe e compare com seus [deploys](https://docs.vertracloud.app/pt-br/guides/rollback-and-zero-downtime-deploys.md).
2. Clique na pior rota para filtrar tudo por ela.
3. No Pro e acima, abra [Requisições](https://docs.vertracloud.app/pt-br/web-analytics/requests.md) para ver as requisições exatas que falharam e anotar um ID da requisição.
4. Leia os logs da aplicação daquele horário.

Próximo: [Desempenho](https://docs.vertracloud.app/pt-br/web-analytics/performance.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.