‫۵۰۲ دروازه نادرست - 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. [ Body ]

«خط پاسخ» از سه بخش تشکیل شده است: نسخه پروتکل و پس‌از آن کد وضعیت عددی و عبارت نوشتاری مرتبط آن، همان‌طور که در زیر نشان داده شده است:

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 ارسال‌شده توسط سرور هدف/پشتیبان از ۲۰۴۸ بایت فراتر رفته است.

درک «خط پاسخ» بزرگ

طبق تعریف خط وضعیت (که در اینجا به آن خط پاسخ گفته می‌شود) و درخواست‌ها و پاسخ‌های معمول HTTP، اندازه بسیار کوچک‌تر از حد مجاز پیش‌فرض تعریف‌شده ۲ کیلوبایت در Apigee Edge خواهد بود، بنابراین ممکن است به حد مجاز نرسیم. بااین‌حال، در اینجا چند سناریو احتمالی وجود دارد که ممکن است از این حد فراتر بروید:

1. سرور هدف/زیرینه سیستم HTTP نیست. ممکن است با پاسخی غیر از HTTP پاسخ دهد.
2. سرور هدف/زیرینه مشکل دارد و «خط پاسخ» طولانی را به‌عنوان بخشی از پاسخ HTTP ارسال می‌کند.

درباره این موضوع در دریافت خطای protocol.http.TooBigLine،‏ «اندازه خط پاسخ از ۲٬۰۴۸ فراتر رفته است» بیشتر بخوانید.

در اینجا دلایل احتمالی این خطا آورده شده است:

مراحل متداول تشخیص خرابی

برای تشخیص این خطا، از یکی از ابزارها/تکنیک‌های زیر استفاده کنید:

دلیل: اندازه «خط پاسخ» از حد مجاز بیشتر است

تشخیص

1. کد خطا و منبع خطا را برای خطای مشاهده‌شده بااستفاده از API Monitoring، ابزار Trace، یا گزارش‌های دسترسی NGINX همان‌طور که در مراحل تشخیص متداول توضیح داده شده است تعیین کنید.
2. اگر منبع خطا مقدار target را داشته باشد، این نشان می‌دهد که اندازه «خط پاسخ» ارسال‌شده توسط برنامه سرور هدف/زیرینه به Apigee بزرگ‌تر از حد مجاز در Apigee Edge است.

3. می‌توانید بااستفاده از یکی از روش‌های زیر تأیید کنید که اندازه «خط پاسخ» از حد مجاز ۲ کیلوبایت فراتر رفته است:

   پیام خطا

   برای راستی‌آزمایی بااستفاده از پیام خطا:

   اگر به پیام خطای کامل دریافتی از Apigee Edge دسترسی دارید، به faultstring مراجعه کنید.

   پیام خطای نمونه:

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

   faultstring بالا نشان می‌دهد که اندازه «خط پاسخ» از حد مجاز ۲ کیلوبایت فراتر رفته است.

   درخواست واقعی

   برای اعتبارسنجی بااستفاده از درخواست واقعی:

   اگر به درخواست واقعی که به برنامه سرور هدف/زیرینه ارسال شده است دسترسی دارید، مراحل زیر را انجام دهید:

   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 بزرگ‌تر از ۲ کیلوبایت است، یعنی بیشتر از ۲ هزار نویسه ASCII دارد.

      اگر از کارخواه دیگری استفاده می‌کنید، می‌توانید گزارش‌های کارخواه را مرور کنید و اندازه «خط پاسخ» ارسال‌شده به Apigee Edge را پیدا کنید.

   گزارش‌های «پردازشگر پیام»

   برای اعتبارسنجی بااستفاده از گزارش‌های «پردازشگر پیام»:

   اگر کاربر «ابر خصوصی» هستید، می‌توانید از گزارش‌های «پردازشگر پیام» برای اعتبارسنجی اینکه آیا اندازه «خط پاسخ» از حد مجاز در Apigee Edge فراتر رفته است یا نه استفاده کنید.

   1. شناسه پیام درخواست ناموفق را بااستفاده از «پایش میانای برنامه‌سازی کاربردی»، ابزار «ردیابی»، یا گزارش‌های دسترسی 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 در پیام خطای بالا نشان می‌دهد که اندازه «خط پاسخ» بیش‌از ۲ کیلوبایت است. بنابراین، Apigee Edge استثنا را ایجاد می‌کند و کد وضعیت 502 را با کد خطای protocol.http.TooBigline به برنامه‌های مشتری برمی‌گرداند.

وضوح

محدودیت‌ها

‫Apigee انتظار دارد که برنامه کارخواه و سرور پشتیبان «خطوط درخواست/پاسخ» با اندازه‌های بزرگ‌تر از حد مجاز را که در محدودیت خط درخواست/پاسخ در محدودیت‌های Apigee Edge مستند شده است ارسال نکنند.

1. اگر کاربر «ابر عمومی» هستید، حداکثر محدودیت برای اندازه «خط درخواست و پاسخ» همان‌طور که برای اندازه «خط درخواست/پاسخ» در محدودیت‌های Apigee Edge مستند شده است.
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 برای Private Cloud ۲ کیلوبایت است.

اگر هنوز به کمک «پشتیبانی Apigee» نیاز دارید، به باید اطلاعات تشخیصی را جمع‌آوری کنید بروید.

باید اطلاعات تشخیص خرابی را جمع‌آوری کند

اطلاعات تشخیص خرابی زیر را جمع‌آوری کنید و سپس با پشتیبانی Apigee Edge تماس بگیرید:

اگر کاربر «ابر عمومی» هستید، اطلاعات زیر را ارائه دهید:

• نام سازمان
• نام محیط
• نام پراکسی میانای برنامه‌سازی کاربردی
• فرمان curl کامل استفاده‌شده برای بازتولید خطای 502
• فایل ردیابی برای درخواست‌های 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