414 URI de solicitação muito longo - TooBigLine

Você está vendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X. informações

Sintoma

O aplicativo cliente recebe um código de status HTTP de 414 Request-URI Too Long com código de erro protocol.http.TooBigLine como resposta para chamadas de API.

Mensagem de erro

O aplicativo cliente recebe este código de resposta:

HTTP/1.1 414 Request-URI Too Long

Além disso, talvez você veja a seguinte mensagem de erro:

{
   "fault":{
      "faultstring":"request line size exceeding 7,168",
      "detail":{
         "errorcode":"protocol.http.TooBigLine"
      }
   }
}

Observe que o faultstring na mensagem de erro acima contém o limite permitido para a linha de solicitação na Apigee Edge, que é 7168 bytes (7 KB).

Causas possíveis

Esse erro vai ocorrer se o tamanho da linha de solicitação enviada pelo aplicativo cliente para o Apigee Edge como parte da solicitação HTTP for maior que o limite permitido no Apigee Edge.

Antes de analisar as possíveis causas desse erro, vamos entender o que a linha de solicitação significa e como verificar o tamanho dela.

Noções básicas sobre a linha de solicitação

Uma solicitação HTTP típica consiste em três partes:

1. Linha de solicitação
2. ( Conjunto de cabeçalhos HTTP)
3. [ Corpo ]

A linha de solicitação consiste em três partes, conforme mostrado abaixo.

Request-Line = <Method> <Request-URI> <HTTP-Version>

Quando uma solicitação HTTP é feita pelo aplicativo cliente para um servidor, a primeira linha que chega ao servidor contém a linha de solicitação descrita acima. Isso é seguido pelos cabeçalhos e corpo/payload da solicitação.

A captura de tela de exemplo a seguir mostra uma solicitação curl típica, a parte Solicitação (com a linha de solicitação) e a parte Resposta.

Noções básicas sobre o tamanho da linha de solicitação

1. No exemplo discutido acima, a linha de início (primeira linha) na solicitação, também chamada de linha de solicitação, é a seguinte:

   GET /test/ HTTP/1.1
   

   O tamanho da linha de solicitação é ~19 bytes, porque ela contém 19 ASCII characters. Como isso está dentro do limite permitido na Apigee Edge, a solicitação é processada sem nenhum erro e você recebe uma resposta bem-sucedida.

2. Da mesma forma, se você observar o faultstring na mensagem de erro mostrada acima, ele contém "request line size exceeding 7,168". Isso indica que a linha de solicitação na solicitação HTTP feita pelo cliente excedeu 7.168 bytes.

Estas são as possíveis causas desse erro:

Causa	Descrição	Instruções de solução de problemas aplicáveis para
O tamanho do payload da solicitação é maior que o limite permitido	O tamanho do URI de solicitação enviado pelo aplicativo cliente como parte da solicitação HTTP para o Apigee Edge é maior que o limite permitido no Apigee Edge.	Usuários de nuvens públicas e privadas de borda

Etapas comuns do diagnóstico

Use uma das seguintes ferramentas/técnicas para diagnosticar esse erro:

Causa: o tamanho do payload da solicitação é maior do que o limite permitido

Diagnóstico

1. Determine o código de falha, a origem da falha e o tamanho da solicitação do erro observado usando os registros de monitoramento da API, da ferramenta de rastreamento ou do acesso NGINX, conforme explicado nas etapas comuns de diagnóstico.
2. Se a Origem da falha tiver o valor apigee ou MP, isso indica que o tamanho da solicitação enviada pelo aplicativo cliente para a Apigee é maior que o limite permitido no Apigee Edge.
3. É possível validar se o tamanho da linha de solicitação excedeu o limite permitido de 7 KB usando um destes métodos:

   Mensagem de erro

   Para validar usando a mensagem de erro, siga estas etapas:

   Se você tiver acesso à mensagem de erro completa recebida do Apigee Edge, consulte faultstring. O faultstring indica que o tamanho da linha de solicitação excedeu o limite permitido de 7 KB.

   Exemplo de mensagem de erro:

   "faultstring":"request line size exceeding 7,168"
   

   Solicitação real

   Para validar usando a solicitação real, faça o seguinte:

   Se você tiver acesso à solicitação real feita pelo aplicativo cliente, siga estas etapas:

   1. Verifique o tamanho do URI transmitido na solicitação.

   2. Se você achar que o tamanho do URI é maior do que o limite permitido no Apigee Edge, essa é a causa do problema.

      Exemplo de solicitação:

      curl http://<hostalias>/testtoobigline?_qparam=000000000000000000……..000000<trimmed> -k -X POST
      

      No caso acima, o valor do parâmetro de consulta qparam é maior que 7 KB, ou seja, ele contém mais de 7 mil caracteres ASCII.

      Se você estiver usando outro cliente, revise os registros dele e tente descobrir o tamanho da linha de solicitação que está sendo enviada para o Apigee Edge.

   Registros do processador de mensagens

   Para validar usando os registros do processador de mensagens:

   Se você for um usuário de nuvem privada, poderá usar os registros do processador de mensagens para validar se o tamanho da linha de solicitação excedeu o limite permitido no Apigee Edge.

   1. Verifique os registros do processador de mensagens:

      /opt/apigee/var/log/edge-message-processor/logs/system.log

   2. Pesquise se há erros 414 durante um período específico (se o problema ocorreu anteriormente) ou se há alguma solicitação que ainda falha com 414. Você pode usar as seguintes strings de pesquisa.

      grep -ri "exceeding"
      

      grep -ri "RequestURITooLong"
      

   3. Você vai encontrar linhas de system.log semelhantes a estas:

      2021-07-12 08:53:31,461  NIOThread@0 ERROR ADAPTORS.HTTP.FLOW -
      AbstractRequestListener.onException() : Request:null, uri:null,
      message Id:null, exception:com.apigee.errors.http.user.RequestURITooLong{
      code = protocol.http.TooBigLine, message = request line size exceeding 7,168,
      associated contexts = []}, context:Context@366f4217
      input=ClientInputChannel(SSLClientChannel[Accepted: Remote:192.168.195.90:8443
      Local:192.168.67.23:34256]@301912 useCount=1 bytesRead=0 bytesWritten=45849
      age=2254670ms lastIO=0ms isOpen=true)
      

      O texto message = request line size exceeding 7,168 na mensagem de erro acima indica que o tamanho do URI de solicitação é maior que 7 KB. Portanto, o Apigee Edge gera a exceção com.apigee.errors.http.user.RequestURITooLong e retorna o código de status 414 com código de falha protocol.http.TooBigline para aplicativos clientes.

Resolução

Limites

A Apigee espera que o aplicativo cliente e o servidor de back-end não enviem linhas de solicitação/resposta com tamanhos maiores que o limite permitido, conforme documentado para o Limite de linha de solicitação/resposta em Limites do Apigee Edge.

1. Se você for um usuário da nuvem pública, o limite máximo de tamanho de solicitação e linha de resposta será conforme documentado em Tamanho da solicitação/linha de resposta em Limites do Apigee Edge.
2. Se você for um usuário da nuvem privada , talvez tenha modificado o limite máximo padrão para o tamanho da solicitação e da linha de resposta, mesmo que isso não seja uma prática recomendada. Para determinar o limite máximo de tamanho da linha de solicitação, siga as instruções em Como verificar o limite atual.

Como verificar o limite atual?

Esta seção explica como verificar se a propriedade HTTPRequest.line.limit foi atualizada com um novo valor nos processadores de mensagens.

1. Na máquina do processador de mensagens, pesquise a propriedade HTTPRequest.line.limit no diretório /opt/apigee/edge-message-processor/conf e verifique qual valor foi definido conforme mostrado abaixo:

   grep -ri "HTTPRequest.line.limit" /opt/apigee/edge-message-processor/conf
   

2. O resultado do exemplo do comando acima é o seguinte:

   /opt/apigee/edge-message-processor/conf/http.properties:HTTPRequest.line.limit=7k
   

3. No exemplo de saída acima, observe que a propriedade HTTPRequest.line.limit foi definida com o valor 7k em http.properties.

   Isso indica que o limite para o tamanho da linha de solicitação configurado na Apigee para nuvem privada é de 7 KB.

Se você ainda precisar de ajuda do suporte da Apigee, acesse Precisamos coletar informações de diagnóstico.

É necessário coletar informações de diagnóstico

Reúna as seguintes informações de diagnóstico e entre em contato com o suporte do Apigee Edge:

Se você for um usuário da nuvem pública, forneça as seguintes informações:

• Nome da organização
• Nome do ambiente
• Nome do proxy de API
• Completar o comando curl usado para reproduzir o erro 414
• Arquivo de rastreamento das solicitações de API

Se você for um usuário da nuvem privada, forneça as seguintes informações:

• Concluir a mensagem de erro observada para as solicitações com falha
• Nome da organização
• Nome do ambiente
• Pacote de proxy de API
• Arquivo de rastreamento das solicitações de API com falha
• Completar o comando curl usado para reproduzir o erro 414

• Registros de acesso do NGINX /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  Onde:ORG, ENV e PORT# são substituídos por valores reais.

• Registros do sistema do processador de mensagens /opt/apigee/var/log/edge-message-processor/logs/system.log