Erros Comuns do Balanceador de Carga

Saiba mais sobre erros comuns do balanceador de carga associados aos balanceadores de carga.

Os erros comuns do balanceador de carga incluem os da série 500 e 400, erros de verificação de integridade, erros do cliente e erros de SSL. Os tópicos subsequentes nesta seção descrevem esses erros comuns e detalham os procedimentos de solução de problemas de cada um, quando aplicável.

Erros do Servidor (500-599)

504

Mensagens de erro:

  • lbStatusCode: "504"

  • backendStatusCode: ""

Categoria de log do Oracle Cloud Infrastructure: Log de acesso

Sintomas:

O cliente falha com um erro 504.

Possíveis causas:

O balanceador de carga não pode estabelecer conexões com qualquer um dos backends, mesmo que a verificação de integridade esteja marcando os backends como disponíveis.

Soluções possíveis:

Configure a verificação de integridade corretamente.

Documentação de diagnóstico e solução de problemas: Editando Políticas de Verificação de Integridade de um Balanceador de Carga

502, 502

Mensagens de erro:
  • lbStatusCode: "502"

  • backendStatusCode: "502"

Categoria de log do Oracle Cloud Infrastructure: Log de acesso e log de erros

Sintomas:
  • O cliente falha com um erro 502 Bad Gateway.

  • A verificação de integridade do backend é bem-sucedida.

  • O backend retorna um erro 502.

Possíveis causas:
  • Um aplicativo no backend está retornando um erro 502.

  • O backend está configurado incorretamente.

  • O backend provavelmente é outro proxy reverso ou balanceador de carga.

Soluções possíveis:

Examine os logs do aplicativo de backend para determinar por que um erro 502 é retornado.

Documentação de diagnóstico e solução de problemas: Erros HTTP 502 Bad Gateway e Testando Servidores de Backend TCP e HTTP.

502

Mensagens de erro:
  • lbStatusCode: "502"

  • backendStatusCode: ""

  • No healthy backends available in associated backend set

Categoria de log do Oracle Cloud Infrastructure: Log de acesso e log de erros

Sintomas:
  • O cliente falha com um erro 502 Bad Gateway.

  • Falha na verificação de integridade do backend.

  • Nenhum tráfego observado para um backend específico ou para todos os backends.

Possíveis causas:
  • Um aplicativo de backend não está respondendo à verificação de integridade com a resposta esperada.

  • Se não ocorrer nenhum erro no backend, uma verificação de integridade de TCP estará configurada.

  • Um único backend ou todos os backends estão configurados no modo drain.

Soluções possíveis:
  • Determine por que a verificação de integridade de TCP está falhando.

  • Converta em verificação de integridade de HTTP.

  • Altere o modo drain para falso (undrain) para um determinado backend ou para todos os backends.

Documentação de diagnóstico e solução de problemas: Erros HTTP 502 Bad Gateway e Testando Servidores de Backend TCP e HTTP.

Problema de Persistência de Sessão

Mensagem de erro:
Persistence selected backend ip_address which failed and no_fallback is selected

Categoria de log do Oracle Cloud Infrastructure: Log de erros

Sintomas:
  • O cliente falha com um erro 502 Bad Gateway.

  • Falha na persistência de sessão.

Possíveis causas
  • O conjunto de backend está configurado com persistência de sessão e o backend esperado não está disponível porque a conexão falhou ou expirou.

  • A opção de fallback está desativada.

Soluções possíveis:
  • Determine por que o aplicativo de backend não está acessível.

  • Ative a opção de fallback caso o servidor selecionado esteja indisponível.

Documentação de solução de problemas: Fallback

Para todos os outros erros 5nn, as causas mais prováveis são problemas com o servidor de backend.

Erro do Cliente (400-499)

400

Mensagens de erro:
  • lbStatusCode: "400"

  • backendStatusCode: ""

  • 400 bad request header or cookie too large

Categoria de log do Oracle Cloud Infrastructure: Log de acesso

Sintomas:
  • O balanceador de carga retorna um código de status 400.

  • O backend não retorna um código de status.

Possíveis causas:

O cliente está enviando uma solicitação que excede o tamanho do buffer configurado.

Soluções possíveis:

Aumente o tamanho do cabeçalho da solicitação HTTP no balanceador de carga. Por padrão, o limite de tamanho é de 8 KB, mas aumentá-lo para 64 KB resolve o problema.

Documentação de diagnóstico e solução de problemas: Regras de Cabeçalho HTTP

404, 404

Mensagens de erro:
  • lbStatusCode: "404"

  • backendStatusCode: "404"

Categoria de log do Oracle Cloud Infrastructure: Log de acesso

Sintomas:
  • O balanceador de carga retorna um código de status 404.

  • O backend retorna um código de status 404.

Possíveis causas:

A página esperada não existe no backend.

Soluções possíveis:
  • Crie a página ausente.

  • Configure o cliente para chamar a página correta.

403, 403

Mensagens de erro:
  • lbStatusCode: "403"

  • backendStatusCode: "403"

Categoria de log do Oracle Cloud Infrastructure: Log de acesso

Sintomas:
  • O balanceador de carga retorna um código de status 403.

  • O backend retorna um código de status 403.

Possíveis causas:
  • A página esperada não tem permissão suficiente no backend.

  • O token de autenticação esperado está ausente ou não está sendo encaminhado.

Soluções possíveis:

  • Crie as permissões ausentes no backend.

  • Ajuste a configuração do cliente para garantir que os tokens sejam enviados corretamente.

  • Certifique-se de que todos os tokens que estão sendo enviados estejam chegando no backend.

  • Se o cabeçalho estiver ausente:

    • Ajuste o tamanho do cabeçalho no balanceador de carga ou no cliente.

    • Permita cabeçalhos com caracteres especiais.

Documentação de diagnóstico e solução de problemas: Regras de Cabeçalho HTTP

Erros de Verificação de Integridade

Não Há Backends Saudáveis

Mensagem de erro:
No healthy backends available in associated backendSet

Categoria de log do Oracle Cloud Infrastructure: Log de erros

Sintomas:

O cliente falha com um erro 502 Bad Gateway.

Possíveis causas:
  • Nenhum backend no conjunto de backend.

  • Nenhum backend respondendo à verificação de integridade.

Soluções possíveis:
  • Determine por que os backends não estão respondendo à verificação de integridade.

  • Verifique e ajuste quaisquer definições de verificação de integridade, incluindo código de status, expressões regulares, timeout de intervalo, porta e protocolo.

Documentação de diagnóstico e solução de problemas: Editando Políticas de Verificação de Integridade de um Balanceador de Carga

Problemas de Código de Status

Motivo da falha de status de integridade do backend: Código de status incompatível

Categoria do Oracle Cloud Infrastructure: Status de Integridade do Backend

Mensagem de erro:
Status code mismatch

Categoria de log do Oracle Cloud Infrastructure: Log de erros

Sintomas:
  • O backend falha na verificação de integridade.

  • O cliente falha com um erro 502 Bad Gateway.

  • invalid statusCode aparece nos logs de erro.

Possíveis causas:
  • O backend está respondendo com um código de resposta incorreto.

  • A verificação de integridade do backend falha por causa de incompatibilidade do código de resposta.

  • As falhas de verificação de integridade são decorrentes de um código de status inesperado no corpo da expressão regular.

Soluções possíveis:
  • Determine por que o backend está enviando o código de resposta incorreto.

  • Ajuste o caminho ou o código de status da verificação de integridade para corresponder ao backend.

Documentação de diagnóstico e solução de problemas: Editando Políticas de Verificação de Integridade de um Balanceador de Carga

Falha na Correspondência de Resposta

Motivo da Falha de Status de Integridade do Backend: Incompatibilidade de expressão regular

Categoria do Oracle Cloud Infrastructure: Status de Integridade do Backend

Mensagem de erro:
"response match result: failed"

Categoria de log do Oracle Cloud Infrastructure: Log de erros

Sintomas:
  • O backend falha na verificação de integridade.

  • O cliente falha com um erro 502 Bad Gateway.

  • "response match result: failed" aparece nos logs de erro.

Possíveis causas:

A verificação de integridade do backend falha por causa da incompatibilidade de expressão regular, valor incorreto retornado ou valor incorreto fornecido para a verificação de integridade.

Soluções possíveis:
  • Determine por que o backend está enviando o corpo incorreto.

  • Ajuste o caminho ou o padrão de expressão regular da verificação de integridade para corresponder ao backend.

Documentação de diagnóstico e solução de problemas: Editando Políticas de Verificação de Integridade de um Balanceador de Carga

Host Inachável

Motivo da Falha de Status de Integridade do Backend: Falha na conexão

Categoria do Oracle Cloud Infrastructure: Status de Integridade do Backend

Mensagens de erro:
"errno":"EHOSTUNREACH","syscall":"connect"
"ECONNREFUSED","errno":"ECONNREFUSED"

Categoria de log do Oracle Cloud Infrastructure: Log de erros

Sintomas:
  • O backend falha na verificação de integridade.

  • O cliente falha com um erro 502 Bad Gateway.

  • "EHOSTUNREACH" aparece nos logs de erro.

Possíveis causas:
  • A verificação de integridade do backend falha por causa de um host inacessível.

  • A verificação de integridade do backend falha por causa de uma redefinição de conexão.

  • Um aplicativo ou firewall está recusando ativamente a conexão.

Soluções possíveis:
  • Verifique o firewall da instância local para confirmar se o tráfego está sendo permitido.

  • Verifique a instância local para confirmar se o aplicativo está em execução.

  • Verifique o grupo de segurança de rede e as listas de segurança para confirmar se o tráfego é permitido.

Documentação de diagnóstico e solução de problemas: Acesso e Segurança

Problemas de status de integridade

Mensagens de erro:
"healthStatus":"Unhealthy to Healthy"
"healthStatus":"Healthy to Unhealthy"

Categoria de log do Oracle Cloud Infrastructure: Log de erros

Sintomas:
  • O cliente se comporta conforme o esperado, mas falha periodicamente.

  • O backend alterna entre aprovação e reprovação na verificação de integridade.

  • "Unhealthy to Healthy" ou "Healthy to Unhealthy" aparece nos logs de erro.

Possíveis causas:
  • Um backend não íntegro torna-se íntegro.

  • Se o status de integridade do backend mudar com frequência, isso poderá indicar um problema crônico.

Soluções possíveis:
  • Certifique-se de que a instância não esteja alterando o status de integridade de maneira anormal.

  • Verifique os logs do aplicativo no servidor de backend para ver se há problemas específicos do aplicativo.

Problemas de Conexão

Motivo da Falha de Status de Integridade do Backend: Tempo esgotado

Categoria do Oracle Cloud Infrastructure: Status de Integridade do Backend

Mensagens de erro:
"msg":"connect timed out","elapsed":3000}

Categoria de log do Oracle Cloud Infrastructure: Log de erros

Sintomas:
  • O cliente falha com um erro 502 Bad Gateway.

  • O backend está sendo reprovado nas verificações de integridade de forma periódica ou crônica.

  • "connect timed out" aparece nos logs de erro.

Possíveis causas:
  • O servidor de backend não está respondendo às verificações de integridade no período esperado.

  • Dependência upstream lenta, incluindo banco de dados, serviço de aplicativo ou API, ou serviços de armazenamento lentos, como File Storage, Elastic Block Store ou Object Storage do Oracle Cloud Infrastructure.

Soluções possíveis:
  • Execute um teste local no backend para eliminar o balanceador de carga como causa.

  • Verifique o desempenho de todas as dependências upstream.

  • Verifique os logs do aplicativo no servidor de backend para ver se há dependências que reportam qualquer tipo de timeout.

Documentação de diagnóstico e solução de problemas: Testando Servidores de Backend TCP e HTTP.

Erros de SSL

Problemas do Listener Virtual SSL

Mensagem de erro:
Not all SSL virtual listeners on port 443 have the same set of SSL protocols defined

Sintomas:

Você não pode criar backends para um balanceador de carga existente nem adicionar novos servidores ao backend criado anteriormente no mesmo balanceador de carga.

Possíveis causas:

Incompatibilidade de versões de TLS (Transport Layer Security).

Soluções possíveis:

Faça a correspondência das versões do TLS nos listeners.

Documentação de diagnóstico e solução de problemas: Certificados SSL para Balanceadores de Carga

Problemas de handshake SSL

Mensagem de erro:
(SSL: error:140770FC:SSL routines:SSL23_GET_SERVER_HELLO:unknown protocol) while SSL handshake error

Categoria de log do Oracle Cloud Infrastructure: Log do cliente

Sintomas:

O cliente apresenta falhas de handshake SSL nas métricas do Balanceador de Carga (consulte Métricas do Balanceador de Carga).

Possíveis causas:

O backend não está configurado para aceitar SSL.

Soluções possíveis:
  • Confirme se o certificado de backend corresponde à autoridade de certificação fornecida.

  • Certifique-se de que todos os certificados da cadeia sejam fornecidos na ordem correta no campo Certificado.

  • Certifique-se de fornecer a profundidade correta do certificado.

Documentação de diagnóstico e solução de problemas: Certificados SSL para Balanceadores de Carga

Problemas de Handshake SSL de Backend

Mensagens de erro:
Peer backend_ip_address closed connection in SSL handshake

Categoria de log do Oracle Cloud Infrastructure: Log de erros

Sintomas:
  • O cliente falha com um erro 502 Bad Gateway.

  • O cliente apresenta falhas de handshake SSL nas métricas do Oracle Cloud Infrastructure (consulte Métricas do Balanceador de Carga).

Possíveis causas:
  • O backend não está configurado para aceitar SSL.

  • O certificado do backend é inválido.

Soluções possíveis:
  • Confirme se o certificado de backend corresponde à autoridade de certificação fornecida.

  • Certifique-se de que todos os certificados da cadeia sejam fornecidos na ordem correta no campo Certificado.

  • Certifique-se de fornecer a profundidade correta do certificado.

Documentação de diagnóstico e solução de problemas: Certificados SSL para Balanceadores de Carga

Problemas de certificado SSL

Erro:

O backend_ip_address do cliente tem erro de verificação de certificado SSL.

Categoria de log do Oracle Cloud Infrastructure: Log de erros

Sintomas:

O cliente apresenta falhas de handshake SSL nas métricas do Oracle Cloud Infrastructure (consulte Métricas do Balanceador de Carga).

Possíveis causas:
  • O certificado do cliente é inválido.

  • O certificado do cliente não é confiável.

  • Profundidade de verificação de certificação de pareamento inválida.

Soluções possíveis:
  • Verifique se o certificado do cliente é válido.

  • Remova o recurso Verificação de Certificados de Pareamento no listener.

Documentação de diagnóstico e solução de problemas: Incompatibilidade do Par de Chaves e Consistência de Chave Privada.

Problemas de certificados SSL do cliente

Mensagem de erro:
Client backend_ip_address sent no required SSL certificate

Categoria de log do Oracle Cloud Infrastructure: Log de erros

Sintomas:
  • O cliente apresenta um erro 400 Response.

  • no required SSL certificate aparece nos logs de erro.

Possíveis causas:

O cliente não está enviando um certificado de cliente.

Soluções possíveis:
  • Atualize o cliente para enviar o certificado de cliente correto.

  • Remova o recurso Verificação de Certificados de Pareamento no listener.

  • Ajuste a profundidade de verificação do certificado.

Documentação de diagnóstico e solução de problemas: Configurando a Verificação de Certificados de Pareamento.

Erro de SSL Causa Falha na Verificação de Integridade do Backend

Mensagem de erro:
"code":"EPROTO","errno":"EPROTO"

Categoria de log do Oracle Cloud Infrastructure: Log de erros

Sintomas:

A verificação de integridade do backend falha por causa do erro de SSL.

Possíveis causas:

O backend está configurado para aceitar SSL, mas o protocolo de verificação de integridade selecionado não corresponde ao do backend.

Soluções possíveis:

Confirme se você está usando uma verificação de integridade que não é de TLS em um backend que tem o TLS ativado.

Documentação de diagnóstico e solução de problemas: Editando Políticas de Verificação de Integridade de um Balanceador de Carga

Falha na Verificação do Nome do Host SSL

Mensagem de erro:
SSL host name verification failed for host_name

Categoria de log do Oracle Cloud Infrastructure: Log de erros

Sintomas:
  • O cliente falha com um erro 502 Bad Gateway.

  • A mensagem de erro contém SSL host name verification failed.

Possíveis causas:

O nome do host fornecido não corresponde ao esperado.

Soluções possíveis:
  • Configure o cliente para usar o nome de host esperado.

  • Configure o certificado para corresponder ao nome de host enviado pelo cliente.

Documentação de diagnóstico e solução de problemas: Certificados SSL para Balanceadores de Carga

Erros do Cliente

Acesso ao Cliente Negado

Erro:

Acesso para client_ip_address negado pela regra de ACL HTTP.

Categoria de log do Oracle Cloud Infrastructure: Log de erros

Sintomas:
  • O cliente falha com um erro 502 Bad Gateway.

  • O backend não passou na verificação de integridade.

  • forbidden by HTTP ACL rule aparece no log de erros.

Possíveis causas:

O conjunto de regras de controle de acesso está ativado, mas não inclui o endereço IP de origem.

Soluções possíveis:

Verifique e aplique o respectivo conjunto de regras para incluir o endereço IP de origem.

Documentação de diagnóstico e solução de problemas: Regras de Controle de Acesso

Problema de Timeout do Cliente

Erro:

Timeout do cliente client_name

Categoria de log do Oracle Cloud Infrastructure: Log de erros

Sintomas:
  • O cliente falha com um erro 502 Bad Gateway.

  • O cliente apresenta falhas de handshake SSL nas métricas do Oracle Cloud Infrastructure (consulte Métricas do Balanceador de Carga).

Possíveis causas:

O cliente encerrou a conexão antes do timeout configurado para o balanceador de carga.

Soluções possíveis:
  • Configure o timeout do cliente para corresponder à configuração esperada do aplicativo.

  • Determine por que o servidor de backend não respondeu no tempo configurado.

Documentação de diagnóstico e solução de problemas: Testando Servidores de Backend TCP e HTTP.

Conexão do Cliente Fechada Abruptamente

Erro:

A conexão com address foi abruptamente fechada por

Categoria de log do Oracle Cloud Infrastructure: Log de erros

Sintomas:

O cliente falha com um erro 502 Bad Gateway.

Possíveis causas:

O listener tem uma regra de conexão de listener Máx. e um IP tentou fazer mais conexões com o listener do que o permitido pela regra.

Soluções possíveis

  • Aumente o número permitido de conexões que um IP pode fazer com o listener.

  • Reduza o número de conexões que o IP está fazendo com o listener.

Documentação de diagnóstico e solução de problemas: Regras de Conexão do Listener Máximo.

Erros do Servidor de Backend

Problema de Conexão do Servidor de Backend

Erro:

O backend ip_address fecha a conexão abruptamente.

Categoria de log do Oracle Cloud Infrastructure: Log de erros

Sintomas:
  • O cliente falha com um erro 502 Bad Gateway.

  • O cliente reporta um erro de Entrada/Saída nas métricas do balanceador de carga.

  • O conjunto de servidores de backend usa HTTPS e as suítes de cifragem ou versões TLS não são compatíveis.

Possíveis causas:

  • O timeout da conexão do servidor de backend está configurado incorretamente, com um valor de timeout inferior ao do balanceador de carga.

  • O servidor de backend ou seu conjunto de backend contendo tem maxConnections definido e o número de conexões com o servidor de backend atingiu o limite especificado.

Soluções possíveis:

  • Determine por que está ocorrendo timeout do aplicativo do servidor de backend.

  • Se o valor do tempo limite do servidor de backend precisar ser ajustado, ajuste-o para ser maior que o valor do tempo limite do balanceador de carga.

  • Adicione mais servidores de backend para tratar a carga.

  • Aumente a definição maxConnections.

Nenhum Servidor de Backend Saudável

Erro:

Nenhum backend íntegro disponível no backendSet associado

Categoria de log do Oracle Cloud Infrastructure: Log de erros

Sintomas:

O cliente falha com um erro 502 Bad Gateway.

Possíveis causas:

  • Nenhum servidor de backend no conjunto de backend.

  • Não há servidores de backend que respondam à verificação de integridade.

  • Todos os servidores de backend de integridade no conjunto de backend atingiram seu limite maxConnections.

Soluções possíveis:

  • Determine por que os backends não estão respondendo à verificação de integridade.

  • Verifique e ajuste quaisquer definições de verificação de integridade, incluindo código de status, expressões regulares, timeout de intervalo, porta e protocolo.

  • Verifique se os servidores de backend têm um limite maxConnections definido. Em caso afirmativo, adicione mais servidores de backend para tratar a carga ou aumentar o limite maxConnections

Documentação de diagnóstico e solução de problemas: Testando Servidores de Backend TCP e HTTP.