502 Bad Gateway – TooBigLine

<ph type="x-smartling-placeholder"></ph> Vous consultez la documentation Apigee Edge.
Accédez à la page Documentation sur Apigee X. En savoir plus

Symptôme

L'application cliente obtient le code d'état HTTP 502 Bad Gateway avec un code d'erreur protocol.http.TooBigLine en réponse aux appels d'API.

Message d'erreur

L'application cliente reçoit le code de réponse suivant:

HTTP/1.1 502 Bad Gateway

Le message d'erreur suivant peut également s'afficher:

{
   "fault":{
      "faultstring":"response line size exceeding 2,048",
      "detail":{
         "errorcode":"protocol.http.TooBigLine"
      }
   }
}

Causes possibles

Cette erreur se produit si la taille Response-Line (Ligne de réponse) envoyée par serveur cible/backend vers Apigee La périphérie dans la réponse HTTP est supérieure au maximum autorisé limite dans Apigee Edge.

Avant d'examiner les causes possibles de cette erreur, voyons ce que la ligne de réponse et comment vérifier sa taille.

Comprendre la ligne de réponse

Une réponse HTTP se compose généralement de trois parties:

1. <ph type="x-smartling-placeholder"></ph> Ligne d'état (appelée Ligne de réponse dans Apigee)
2. ( Ensemble d'en-têtes HTTP )
3. [ Corps ]

La ligne de réponse se compose de trois parties: la version du protocole, suivie d'une chaîne numérique code d'état et la synthèse textuelle associée, comme indiqué ci-dessous:

Response-Line   = <HTTP-Version> <Status-Code> <Reason-Phrase>

Lorsqu'une réponse HTTP est envoyée par l'application du serveur cible/backend, la première ligne qui est envoyé représente la ligne de réponse décrite ci-dessus. Elle est suivie de en-têtes et corps/charge utile de la réponse.La capture d'écran suivante montre un exemple curl, les parties Request et Response (avec les éléments de réponse).

Comprendre la taille de la ligne de réponse

1. Dans l'exemple présenté ci-dessus, la ligne start (première ligne) de la réponse contient également (appelée Ligne de réponse) se présente comme suit:

   HTTP/1.1 200 OK
   

   La taille de cette ligne de réponse est ~15 bytes, car elle contient 15 ASCII characters. Puisqu'il s'agit d'un emplacement limite autorisée dans Apigee Edge, la réponse est renvoyée au client sans qu'aucune d'Apigee Edge.

2. De même, si vous regardez faultstring dans Le message d'erreur ci-dessus, qui contient "response line size exceeding 2,048". Cela indique que la ligne de réponse (Response-Line) de la réponse HTTP envoyées par le serveur cible/backend dépassaient 2 048 octets.

Comprendre les grandes lignes de réponse

Conformément à la définition <ph type="x-smartling-placeholder"></ph> "Status-Line" (appelée Response-Line ici), les requêtes HTTP types et , la taille serait bien inférieure à la limite par défaut définie de 2 K dans Apigee Edge, donc nous ne pourrons peut-être pas atteint la limite. Vous pouvez toutefois dépasser cette limite dans les cas suivants:

1. Le serveur cible/backend n'est pas un système HTTP. Il pourrait répondre avec une réponse non-HTTP de réponse.
2. Le serveur cible/backend rencontre des problèmes et envoie une longue ligne de réponse dans le message de réponse.

Pour en savoir plus, consultez <ph type="x-smartling-placeholder"></ph> Le message d'erreur "protocol.http.TooBigLine", "taille de la ligne de réponse supérieure à 2 048" s'affiche.

Voici les causes possibles de cette erreur:

Cause	Description	Instructions de dépannage applicables
La taille de la ligne de réponse est supérieure à la limite autorisée	La taille de la ligne de réponse (Response-Line) envoyée par le serveur cible/backend dans le cadre de La réponse HTTP à Apigee Edge est supérieure à la valeur limite autorisée dans Apigee Edge	Utilisateurs Edge de cloud public et privé

Étapes de diagnostic courantes

Utilisez l'une des techniques ou l'un des outils suivants pour diagnostiquer ce problème:

Cause: La taille de la ligne de réponse est supérieure à la limite autorisée

Diagnostic

1. Déterminez le code d'erreur et la source d'erreur pour l'erreur observée à l'aide de l'API. Monitoring, l'outil Trace ou les journaux d'accès NGINX comme expliqué dans Étapes de diagnostic courantes.
2. Si la source de la défaillance a la valeur target, cela indique que le La taille de la ligne de réponse envoyée par l'application du serveur cible/backend à Apigee est supérieure à la limite autorisée dans Apigee Edge.

3. Pour confirmer que la taille de la ligne de réponse a dépassé la limite autorisée de 2 Ko, utilisez des méthodes suivantes:

   Message d'erreur

   Pour valider à l'aide du message d'erreur:

   Si vous avez accès au message d'erreur complet reçu d'Apigee Edge, consultez faultstring

   Exemple de message d'erreur:

   "faultstring":"response line size exceeding 2,048"
   

   La valeur faultstring ci-dessus indique que la taille de la ligne de réponse dépasse la limite autorisée ne doit pas dépasser 2 Ko.

   Demande réelle

   Pour effectuer la validation à l'aide de la requête réelle:

   Si vous avez accès à la requête réelle adressée au serveur cible/backend , puis effectuez les étapes suivantes:

   1. Vérifier la taille de la ligne de réponse
   2. Si vous constatez que la taille de l'URI est supérieure à limite autorisée dans Apigee Edge, cela explique le problème.

      Exemple de réponse du serveur cible/backend:

      curl -v http://HOSTALIAS/test
      

      *   Trying 3.2.1.4...
      * TCP_NODELAY set
      * Connected to <hostalias> (3.2.1.4) port 80 (#0)
      > GET /test HTTP/1.1
      > Host: HOSTALIAS
      > User-Agent: curl/7.64.1
      > Accept: */*
      >
      < HTTP/1.1 200 1111…<trimmed>...11111111
      < Date: Mon, 26 Jul 2021 07:07:18 GMT
      < Content-Type: application/json
      < Content-Length: 269
      < Connection: keep-alive
      < Server: gunicorn/19.9.0
      < Access-Control-Allow-Origin: *
      < Access-Control-Allow-Credentials: true
      <
      {
      <Response Body>
      }
      * Connection #0 to host <hostalias> left intact
      * Closing connection 0
      

      Dans le cas ci-dessus, la taille de la ligne de réponse HTTP/1.1 200 1111…<trimmed>...11111111 dépasse 2 Ko, c'est-à-dire qu'elle contient plus de 2 000 caractères ASCII.

      Si vous utilisez un autre client, vous pouvez consulter les journaux du client et essayer pour connaître la taille de la ligne de réponse envoyée à Apigee Edge.

   Journaux de processeur de messages

   Pour valider l'utilisation des journaux du processeur de messages:

   <ph type="x-smartling-placeholder">

   Si vous êtes un utilisateur du cloud privé, vous pouvez utiliser les journaux du processeur de messages pour vérifier si la taille de la ligne de réponse a dépassé la limite autorisée dans Apigee Edge.

   1. Déterminez l'ID du message de la requête ayant échoué à l'aide de l'API Monitoring, de l'outil Trace ou NGINX, comme expliqué dans la section Étapes de diagnostic courantes.

   2. Recherchez l'ID du message dans le journal du processeur de messages:

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

   3. Les lignes de system.log se présentent comme suit:

      2021-07-26 06:45:41,451 org:myorg env:prod api:testtoobigline rev:1 messageid:r-5110240-1
      NIOThread@1 ERROR HTTP.CLIENT - HTTPClient$Context$3.onException() :
      ClientChannel[Connected: Remote:3.2.1.2:80 Local:192.168.205.251:44398]@20592
      useCount=1 bytesRead=0 bytesWritten=201 age=144ms  lastIO=0ms  isOpen=true.onExceptionRead
      exception: {}
      com.apigee.errors.http.server.BadGateway: response line size exceeding 2,048
      at <snipped>
      
      2021-07-26 06:45:41,451 org:myorg env:prod api:testtoobigline rev:1
      messageid:r-5110240-1  NIOThread@1 ERROR ADAPTORS.HTTP.FLOW -
      AbstractResponseListener.onException() : AbstractResponseListener.onError
      (HTTPResponse@6a5d6c33, response line size exceeding 2,048)
      

      Le texte message = response line size exceeding 2,048 ci-dessus indique que la taille de la ligne de réponse est supérieure à 2 Ko. Par conséquent, Apigee Edge génère l'exception et renvoie un code d'état 502 avec code d'erreur protocol.http.TooBigline aux applications clientes.

Solution

<ph type="x-smartling-placeholder">

Limites

Apigee s'attend à ce que l'application cliente et le serveur backend n'envoient pas de lignes de requête/réponse dont la taille dépasse la limite autorisée, telle qu'indiquée dans le nombre maximal de lignes de requêtes/réponses. dans les limites d'Apigee Edge.

1. Si vous êtes un utilisateur de cloud public, la limite maximale pour les ressources La taille de la ligne de réponse est telle qu'indiquée dans le champ Request/Response-Line size (Taille de la ligne de requête/réponse) dans Limites d'Apigee Edge
2. Si vous êtes un utilisateur du Private Cloud , il est possible que vous ayez modifié le nombre maximal par défaut pour la taille de la requête et de la ligne de réponse (même s'il ne s'agit pas d'une pratique recommandée). Vous pouvez déterminer la limite de taille maximale pour la ligne de réponse en suivant les instructions fournies dans l'article Vérifier la limite actuelle

Comment vérifier la limite actuelle ?

<ph type="x-smartling-placeholder">

Cette section explique comment vérifier que la propriété HTTPResponse.line.limit a a été mis à jour avec une nouvelle valeur sur les processeurs de messages.

1. Sur le processeur de messages, recherchez la propriété HTTPResponse.line.limit dans la /opt/apigee/edge-message-processor/conf et vérifier consultez la valeur définie ci-dessous:

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

2. Voici un exemple de résultat de la commande ci-dessus:

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

3. Dans l'exemple de résultat ci-dessus, notez que la propriété HTTPResponse.line.limit a été définie avec la valeur 2k dans http.properties.

   Cela indique que la limite de taille de ligne de réponse configurée dans Apigee pour les est de 2 Ko.

Si vous avez encore besoin de l'aide de l'assistance Apigee, accédez à Obligation de recueillir des informations de diagnostic.

Vous devez collecter des informations de diagnostic

Rassemblez les informations de diagnostic suivantes, puis contactez l'assistance Apigee Edge:

Si vous êtes un utilisateur de cloud public, fournissez les informations suivantes:

• Nom de l'organisation
• Nom de l'environnement
• Nom du proxy d'API
• Commande curl complète utilisée pour reproduire l'erreur 502
• Fichier de suivi des requêtes API

Si vous êtes un utilisateur du Private Cloud, fournissez les informations suivantes:

• Message d'erreur complet observé pour les requêtes en échec
• Nom de l'organisation
• Nom de l'environnement
• Groupe de proxys d'API
• Fichier de suivi des requêtes API en échec
• Exécutez la commande curl utilisée pour reproduire l'erreur 502.

• Journaux d'accès NGINX /opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log

  Où:ORG, ENV et PORT# sont remplacés par les valeurs réelles.

• Journaux système du processeur de messages /opt/apigee/var/log/edge-message-processor/logs/system.log