← Middleware: compreender e operar a cadeia
01 / 12 · 20 MIN

Mapear o percurso do pedido

Localiza cada etapa e identifica onde existe evidência da falha.

Uma cadeia de componentes

Um pedido pode passar por DNS, WAF, balanceador, proxy, servidor de aplicação, base de dados e serviços externos. Cada salto acrescenta configuração, limites e pontos de falha. Desenha o percurso para uma operação concreta, incluindo protocolo, identidade, porta, timeout e responsável. Distingue o percurso de entrada das dependências chamadas pela aplicação.

Usar códigos e correlação com contexto

Um 502 ou 503 não identifica sozinho a causa. Determina que componente produziu a resposta e cruza o instante com logs e métricas a jusante. Um identificador de correlação pode ligar vários saltos, desde que seja propagado e registado. Nem todos os pedidos têm o mesmo contexto: rota, identidade, tamanho e dados de entrada podem explicar falhas apenas numa parte do tráfego.

Saúde técnica e saúde funcional

Uma verificação que testa apenas se a porta abre não valida autenticação, processamento ou dependências. Define verificações adequadas a cada objetivo: vida do processo, capacidade de receber tráfego e uma operação funcional representativa. Evita que uma verificação cara provoque carga ou que uma dependência opcional retire todas as instâncias do serviço. O desenho deve refletir como o sistema degrada e recupera.

Aplicação no trabalho

Num serviço fictício de fundos, desenha o percurso de /close e /lookup separadamente. Identifica onde TLS termina e quais dependências cada rota chama. Um código HTTP emitido pelo proxy pode resultar de falha a jusante; regista origem, hora e correlação antes de atribuir causa. Compara pedidos de volume e identidade semelhantes, sem colocar dados pessoais nos identificadores partilhados.

NA PRÁTICA

Só os pedidos /export falham com 504. A rota chama um serviço externo que os outros endpoints não usam. Antes de reiniciar o cluster, compara latência, timeout e logs dessa dependência para o mesmo identificador de pedido.

Armadilhas comuns

Atribuir causa por um código HTTP; testar uma rota e generalizar a todas.

Tópicos relacionados: Investigar JVM, heap e pausas · Relacionar threads, pools e dependências

Leva esta ideia contigo

Um sintoma HTTP é o ponto de partida; o percurso e a correlação localizam a investigação.

Criar conta

Referência: HTTP Semantics · DR Middleware 2026.4; HotSpot JDK 25; JDBC 25; PostgreSQL 18; RabbitMQ 4.3; OpenSSL 3.5; explicitly scoped runtime references