502 Плохой шлюз - TooBigLine

Вы просматриваете документацию Apigee Edge .
Перейдите к документации Apigee X. информация

Симптом

Клиентское приложение получает код состояния HTTP 502 Bad Gateway с кодом ошибки protocol.http.TooBigLine в качестве ответа на вызовы API.

Сообщение об ошибке

Клиентское приложение получает следующий код ответа:

HTTP/1.1 502 Bad Gateway

Кроме того, вы можете увидеть следующее сообщение об ошибке:

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

Возможные причины

Эта ошибка возникает, если размер строки ответа , отправленный целевым/внутренним сервером в Apigee Edge как часть ответа HTTP, превышает максимально допустимый предел в Apigee Edge .

Прежде чем мы рассмотрим возможные причины этой ошибки, давайте разберемся, что означает строка ответа и как проверить ее размер.

Понимание линии ответа

Типичный HTTP-ответ состоит из трех частей:

1. Строка состояния (называемая строкой ответа в Apigee)
2. (Набор HTTP-заголовков)
3. [ Тело ]

Строка ответа состоит из трех частей: версия протокола , за которой следует числовой код состояния и связанная с ним текстовая фраза , как показано ниже:

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

Когда ответ HTTP отправляется приложением целевого/внутреннего сервера, первая отправляемая строка представляет собой строку ответа , как описано выше. За этим следуют заголовки и тело ответа/полезная нагрузка. На следующем примере снимка экрана показан типичный запрос curl , часть запроса и часть ответа (вместе со строкой ответа).

Понимание размера линии ответа

1. В примере, рассмотренном выше, начальная строка (первая строка) ответа, также называемая строкой ответа, выглядит следующим образом:

   HTTP/1.1 200 OK

   Эта строка ответа имеет размер ~15 bytes поскольку содержит 15 ASCII characters . Поскольку это находится в пределах допустимого предела в Apigee Edge , ответ отправляется обратно клиенту без каких-либо ошибок со стороны Apigee Edge.

2. Аналогично, если вы посмотрите на faultstring в сообщении об ошибке , показанном выше, она содержит "response line size exceeding 2,048" . Это указывает на то, что строка ответа в ответе HTTP, отправленном целевым/внутренним сервером, превысила 2048 байт.

Понимание большой линии ответа

В соответствии с определением строки состояния (называемой здесь строкой ответа ) и типичными HTTP-запросами и ответами, размер будет намного меньше, чем определенный предел по умолчанию в 2 КБ в Apigee Edge, поэтому мы можем не достичь предела. Однако вот несколько возможных сценариев, в которых вы можете превысить этот предел:

1. Целевой/внутренний сервер не является системой HTTP. Возможно, он отвечает ответом, отличным от HTTP.
2. На целевом/внутреннем сервере возникли проблемы, и он отправляет длинную строку ответа как часть ответа HTTP.

Подробнее об этом читайте в разделе Получение протокола ошибок.http.TooBigLine, «размер строки ответа превышает 2048 .

Вот возможные причины ошибки:

Общие этапы диагностики

Для диагностики этой ошибки используйте один из следующих инструментов/методов:

Причина: Размер строки ответа превышает допустимый предел.

Диагностика

1. Определите код ошибки и источник ошибки , наблюдаемой с помощью мониторинга API, инструмента трассировки или журналов доступа NGINX, как описано в разделе «Общие шаги диагностики» .
2. Если источник сбоя имеет значение target , это означает, что размер строки ответа, отправленный приложением целевого/внутреннего сервера в Apigee, превышает допустимый предел в Apigee Edge .

3. Вы можете проверить, что размер строки ответа превысил разрешенный предел в 2 КБ, используя один из следующих методов:

   Сообщение об ошибке

   Чтобы подтвердить использование сообщения об ошибке:

   Если у вас есть доступ к полному сообщению об ошибке, полученному от Apigee Edge, обратитесь к faultstring .

   Пример сообщения об ошибке:

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

   Приведенная выше faultstring указывает на то, что размер строки ответа превысил допустимый предел в 2 КБ.

   Фактический запрос

   Чтобы подтвердить использование фактического запроса:

   Если у вас есть доступ к фактическому запросу, сделанному к приложению целевого/внутреннего сервера, выполните следующие шаги:

   1. Проверьте размер линии ответа
   2. Если вы обнаружите, что размер URI превышает допустимый предел в Apigee Edge , то это и есть причина проблемы.

      Пример ответа от целевого/внутреннего сервера:

      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

      В приведенном выше случае строка ответа HTTP/1.1 200 1111…<trimmed>...11111111 имеет размер более 2 КБ, то есть содержит более 2 000 символов ASCII.

      Если вы используете какой-либо другой клиент, вы можете просмотреть журналы клиента и попытаться узнать размер строки ответа, отправляемой в Apigee Edge.

   Журналы процессора сообщений

   Для проверки с использованием журналов процессора сообщений:

   Если вы являетесь пользователем частного облака , вы можете использовать журналы процессора сообщений, чтобы проверить, превысил ли размер строки ответа разрешенный предел в Apigee Edge .

   1. Определите идентификатор сообщения неудачного запроса с помощью мониторинга API, инструмента трассировки или журналов доступа NGINX, как описано в разделе «Общие шаги диагностики» .

   2. Найдите идентификатор сообщения в журнале процессора сообщений:

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

   3. Вы найдете строки из system.log , подобные следующим:

      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)

      Текстовое message = response line size exceeding 2,048 в приведенном выше сообщении об ошибке, указывает на то, что размер строки ответа превышает 2 КБ. Поэтому Apigee Edge выдает исключение и возвращает код состояния 502 с кодом ошибки protocol.http.TooBigline http.TooBigline клиентским приложениям.

Разрешение

Пределы

Apigee ожидает, что клиентское приложение и внутренний сервер не будут отправлять строки запроса/ответа, размеры которых превышают допустимый предел, как описано в разделе «Ограничение строки запроса/ответа» в Apigee Edge Limits .

1. Если вы являетесь пользователем общедоступного облака , то максимальный предел размера строки запроса и ответа соответствует размеру строки запроса/ответа, указанному в Apigee Edge Limits .
2. Если вы являетесь пользователем частного облака, возможно, вы изменили максимальный предел по умолчанию для размера строки запроса и ответа (хотя это не рекомендуется). Вы можете определить максимальный размер строки ответа, следуя инструкциям в разделе «Как проверить текущий предел» .

Как проверить текущий лимит?

В этом разделе объясняется, как проверить, что свойство HTTPResponse.line.limit обновлено новым значением в процессорах сообщений.

1. На компьютере с процессором сообщений найдите свойство HTTPResponse.line.limit в каталоге /opt/apigee/edge-message-processor/conf и проверьте, какое значение было установлено, как показано ниже:

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

2. Пример результата выполнения приведенной выше команды выглядит следующим образом:

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

3. Обратите внимание, что в приведенном выше примере для свойства HTTPResponse.line.limit установлено значение 2k в http.properties .

   Это означает, что ограничение размера строки ответа, настроенное в Apigee для частного облака, составляет 2 КБ.

Если вам по-прежнему нужна помощь со стороны службы поддержки Apigee, перейдите к разделу «Необходимо собрать диагностическую информацию» .

Необходимо собрать диагностическую информацию

Соберите следующую диагностическую информацию, а затем обратитесь в службу поддержки Apigee Edge :

Если вы являетесь пользователем Public Cloud , предоставьте следующую информацию:

• Название организации
• Имя среды
• Имя API-прокси
• Полная команда завитка, используемая для воспроизведения ошибки 502
• Файл трассировки запросов API

Если вы являетесь пользователем частного облака , предоставьте следующую информацию:

• Полное сообщение об ошибке, наблюдаемое для неудачных запросов
• Название организации
• Имя среды
• Пакет API-прокси
• Файл трассировки неудачных запросов API
• Полная команда curl , используемая для воспроизведения ошибки 502

• Журналы доступа NGINX /opt/apigee/var/log/edge-router/nginx/ ORG ~ ENV . PORT# _access_log

  Где: ORG , ENV и PORT# заменяются фактическими значениями.

• Системные журналы процессора сообщений /opt/apigee/var/log/edge-message-processor/logs/system.log