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.
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
Um sintoma HTTP é o ponto de partida; o percurso e a correlação localizam a investigação.
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