درحال مشاهده اسناد Apigee Edge هستید.
به
اسناد Apigee X بروید. اطلاعات
نشانه
برنامه مشتری کد وضعیت HTTP 413 Request Entity Too Large
با کد خطای protocol.http.TooBigBody را بهعنوان پاسخ برای فراخوانیهای API دریافت میکند.
پیام خطا
برنامه کارخواه کد پاسخ زیر را دریافت میکند:
HTTP/1.1 413 Request Entity Too Large
علاوهبراین، ممکن است پیام خطای زیر را مشاهده کنید:
{
"fault":{
"faultstring":"Body buffer overflow",
"detail":{
"errorcode":"protocol.http.TooBigBody"
}
}
}علل احتمالی
این خطا زمانی رخ میدهد که اندازه پایهبار ارسالشده توسط برنامه مشتری به Apigee Edge بهعنوان بخشی از درخواست HTTP از حد مجاز در Apigee Edge بیشتر باشد .
در اینجا دلایل احتمالی این خطا آورده شده است :
| علت | شرح | دستورالعملهای عیبیابی برای موارد زیر قابلاجرا است |
|---|---|---|
| اندازه پایهبار درخواست از حد مجاز بیشتر است | اندازه پایهبار ارسالشده توسط برنامه کارخواه بهعنوان بخشی از درخواست HTTP به Apigee Edge بیشتر از حد مجاز در Apigee Edge است. | کاربران «فضای ابری خصوصی و عمومی لبهای» |
| اندازه پایهبار درخواست پساز فشردهسازی از حد مجاز فراتر رفته است | اندازه پایهبار ارسالشده در قالب فشرده توسط برنامه کارخواه بهعنوان بخشی از درخواست HTTP به Apigee Edge، پساز باز شدن فشردهسازی توسط Apigee Edge، از حد مجاز بیشتر است. | کاربران «فضای ابری خصوصی و عمومی لبهای» |
مراحل متداول تشخیص خرابی
برای تشخیص این خطا، از یکی از ابزارها/تکنیکهای زیر استفاده کنید:
پایش میانای برنامهسازی کاربردی
برای تشخیص خطا بااستفاده از «پایش API»:
- بهعنوان کاربری با نقش مناسب به سیستم Apigee Edge UI وارد شوید.
به سازمانی که میخواهید مشکل را در آن بررسی کنید بروید
- به صفحه تجزیهوتحلیل > پایش API > بررسی پیمایش کنید.
- بازه زمانی خاصی را که در آن خطاها را مشاهده کردهاید انتخاب کنید.
- میتوانید فیلتر پراکسی را انتخاب کنید تا کد خطا را محدود کنید.
- رسم کد خطا دربرابر زمان.
سلولی را که دارای کد خطا
protocol.http.TooBigBodyو کد وضعیت413است، همانطور که در زیر نشان داده شده است، انتخاب کنید:
اطلاعات مربوط به کد خطا
protocol.http.TooBigBodyبهصورت زیر نمایش داده میشود:
- روی مشاهده گزارشها کلیک کنید و ردیف درخواست ناموفق را ازهم باز کنید. سپس از پنجره
گزارشها، جزئیات را همانطور که در زیر نشان داده شده است یادداشت کنید :
فشردهنشده
سناریو شماره ۱: «بار داده درخواست» در قالب فشردهنشده ارسال میشود
از پنجره «گزارشها»، جزئیات زیر را یادداشت کنید:
- کد وضعیت:
413 - منبع خطا:
proxy - کد خطا:
protocol.http.TooBigBody. - طول درخواست(بایت):
15360440(~۱۵ مگابایت)
اگر منبع خطا مقدار
proxyرا داشته باشد، کد خطا مقدارprotocol.http.TooBigBodyرا داشته باشد، و طول درخواست بیشتر از ۱۰ مگابایت باشد، نشان میدهد که درخواست HTTP از مشتری دارای اندازه بار درخواست بزرگتر از حد مجاز در Apigee است.فشرده شد
سناریو شماره ۲: «بار داده درخواست» در قالب فشرده ارسال شده است
از پنجره گزارشها، جزئیات زیر را یادداشت کنید:
- کد وضعیت:
413 - منبع خطا:
proxy - کد خطا:
protocol.http.TooBigBody. - طول درخواست(بایت):
15264(~۱۵ کیلوبایت)
اگر منبع خطا مقدار
proxyرا داشته باشد، کد خطا مقدارprotocol.http.TooBigBodyرا داشته باشد، و طول درخواست کمتر از ۱۰ مگابایت باشد، نشان میدهد که درخواست HTTP از مشتری دارای اندازه بار درخواست کمتر از حد مجاز در قالب فشرده است، اما اندازه بار پساز فشردهسازی توسط Apigee از حد مجاز بیشتر است. - کد وضعیت:
ردیابی
برای تشخیص خرابی بااستفاده از ابزار «ردیابی»:
- جلسه ردیابی و یکی از این موارد را فعال کنید
- منتظر بمانید تا خطای
413 Request Entity Too Largeرخ دهد یا - اگر میتوانید مشکل را بازتولید کنید، فراخوانی API را انجام دهید و
413 Request Entity Too Largeخطا را بازتولید کنید
- منتظر بمانید تا خطای
مطمئن شوید نمایش همه اطلاعات جریان فعال باشد.
- یکی از درخواستهای ناموفق را انتخاب کنید و ردیابی را بررسی کنید.
- به مرحله درخواست دریافتشده از کارخواه پیمایش کنید.
فشردهنشده
سناریو شماره ۱: «بار داده درخواست» در قالب فشردهنشده ارسال میشود
اطلاعات زیر را درنظر داشته باشید:
- Content-Encoding: وجود ندارد
- Content-Length:
15360204
فشرده شد
سناریو شماره ۲: «بار داده درخواست» در قالب فشرده ارسال شده است
اطلاعات زیر را درنظر داشته باشید:
- Content-Encoding:
gzip - Content-Length:
14969 - Content-Type:
application/x-gzip
- در مراحل مختلف ردیابی پیمایش کنید و مکان وقوع خطا را پیدا کنید.
معمولاً خطا را در جریانی پساز مرحله درخواست دریافتی از کارخواه پیدا خواهید کرد، همانطور که در زیر نشان داده شده است:
- مقدار خطا را از ردیابی یادداشت کنید. ردیابی نمونه بالا نشان میدهد:
- خطا:
Body buffer overflow - error.class:
com.apigee.errors.http.user.RequestTooLarge
- خطا:
به پاسخ ارسالشده به کارخواه بروید و مقادیر خطا را از پیگیری یادداشت کنید. ردیابی نمونه زیر نشان میدهد:
- خطا:
413 Request Entity Too Large - محتوای خطا:
{"fault":{"faultstring":"Body buffer overflow","detail":{"errorcode":"protocol.http.TooBigBody"}}}
- خطا:
- به فاز AX (دادههای Analytics ضبطشده) در ردیابی بروید و روی آن کلیک کنید.
در بخش جزئیات فاز، به پایین پیمایش کنید تا به متغیرهای خواندهشده برسید.
- مقدار متغیر client.received.content.length را تعیین کنید که نشاندهنده موارد زیر است:
- اندازه واقعی بار درخواست وقتی در قالب فشردهنشده ارسال میشود و
- اندازه بار درخواست پساز باز کردن فشردهسازی توسط Apigee، زمانی که بار در قالب فشرده ارسال میشود. در این سناریو، همیشه با مقدار حد مجاز (۱۰ مگابایت) یکسان خواهد بود.
فشردهنشده
سناریو شماره ۱: درخواست پایهبار در قالب فشردهنشده
متغیر client.received.content.length:
15360204فشرده شد
سناریو شماره ۲: محتوای درخواست در قالب فشرده
متغیر client.received.content.length:
10489856 - جدول زیر توضیح میدهد که چرا خطای
413تحت دو سناریو براساس مقدار متغیر client.received.content.length توسط Apigee برگردانده میشود:سناریو مقدار client.received.content.length دلیل عدم موفقیت پایهبار درخواست در قالب فشردهنشده ~۱۵ مگابایت اندازه > حد مجاز ۱۰ مگابایت. درخواست پایهبار در قالب فشرده ~۱۰ مگابایت پساز فشردهسازی، از حد مجاز اندازه فراتر رفت
NGINX
برای تشخیص خطا بااستفاده از گزارشهای دسترسی NGINX:
- اگر کاربر «ابر خصوصی» هستید، میتوانید از گزارشهای دسترسی NGINX برای تعیین
اطلاعات کلیدی درباره خطاهای
413HTTP استفاده کنید. گزارشهای دسترسی NGINX را بررسی کنید:
/opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log- جستجو کنید تا ببینید آیا درطول مدت مشخصی خطاهای
413وجود دارد (اگر مشکل در گذشته رخ داده است) یا اینکه آیا درخواستهایی هنوز با413ناموفق هستند یا نه. - اگر خطاهای
413را با X-Apigee-fault-code مطابقت با مقدارprotocol.http.TooBigBodyپیدا کردید، مقدار X-Apigee-fault-source را تعیین کنید.فشردهنشده
سناریو شماره ۱ : اندازه بار داده درخواست در قالب فشردهنشده
ورودی نمونه بالا از گزارش دسترسی NGINX مقادیر زیر را برای X-Apigee-fault-code و X-Apigee-fault-source: دارد
سرایندهای پاسخ مقدار X-Apigee-fault-code protocol.http.TooBigBodyX-Apigee-fault-sourc policyبه طول درخواست:
15360440(۱۴٫۶ مگابایت > حد مجاز) توجه کنیدفشرده شد
سناریو شماره ۲ : اندازه بار داده درخواست در قالب فشرده
ورودی نمونه بالا از گزارش دسترسی NGINX مقادیر زیر را برای X-Apigee-fault-code و X-Apigee-fault-source: دارد:
سرایندهای پاسخ مقدار X-Apigee-fault-code protocol.http.TooBigBodyX-Apigee-fault-source policyبه طول درخواست:
15264(۱۴٫۹ هزار < حد مجاز) توجه کنیددر این سناریو، Apigee Edge کد
413را برمیگرداند، حتی اگر طول درخواست کمتر از حد مجاز باشد، زیرا ممکن است درخواست در قالب فشرده ارسال شده باشد و اندازه بار محموله پساز باز کردن فشردهسازی توسط Apigee Edge از حد مجاز فراتر رود.
دلیل: اندازه پایهبار درخواست از حد مجاز بیشتر است
تشخیص
- کد خطا، منبع خطا، و اندازه بار درخواست را برای خطای مشاهدهشده بااستفاده از «پایش میانای برنامهسازی کاربردی»، «ابزار ردیابی»، یا گزارشهای دسترسی NGINX که در مراحل تشخیص خرابی متداول با «سناریو ۱» (فشردهنشده) توضیح داده شده است تعیین کنید.
- اگر منبع خطا مقدار
policyیاproxyداشته باشد، این یعنی اندازه بار درخواست ارسالی ازسوی برنامه مشتری به Apigee بزرگتر از حد مجاز در Apigee Edge است. - اندازه بار داده درخواست را که در مرحله ۱ تعیین شده است درستیسنجی کنید.
- اگر اندازه پایهبار > حد مجاز ۱۰ مگابایت باشد، دلیل خطا همین است.
- اگر اندازه پایهبار کمتر از حد مجاز ۱۰ مگابایت باشد، ممکن است پایهبار درخواست در قالب فشرده ارسال شود. به اینجا بروید دلیل: اندازه پایهبار درخواست پساز باز کردن فشرده از حد مجاز بیشتر است
- همچنین میتوانید با بررسی درخواست واقعی بااستفاده از مراحل زیر، تأیید کنید که اندازه بار داده درخواست واقعاً بیشتر از حد مجاز ۱۰ مگابایت است:
- اگر به درخواست واقعی که برنامه مشتری ارسال کرده است دسترسی ندارید، به Resolution (حلوفصل) بروید.
- اگر به درخواست واقعی که توسط برنامه مشتری ایجاد شده است دسترسی دارید، مراحل زیر را انجام دهید:
- اندازه پایهبار ارسالشده در درخواست را بهتأیید برسانید.
- اگر متوجه شدید که اندازه پایهبار از حد مجاز در Apigee Edge بیشتر است، این دلیل مشکل است.
درخواست نمونه:
curl http://<hostalias>/testtoobigbody -k -X POST -F file=@test15mbfile -v
در مورد بالا، فایل
test15mbfileحدود ۱۵ مگابایت است. اگر از کارخواه دیگری استفاده میکنید، گزارشهای کارخواه را دریافت کنید تا اندازه دادهبر ارسالی را پیدا کنید.
وضوح
به وضوح بروید.
دلیل: اندازه پایهبار درخواست پساز فشردهسازی از حد مجاز بیشتر است
اگر بار درخواست در قالب فشرده ارسال شود و سرایند درخواست
Content-Encoding روی gzip, تنظیم شود، Apigee بار درخواست را
ازفشرده میکند. اگر Apigee درطول فرایند فشردهسازی متوجه شود اندازه بار از
۱۰ مگابایت،
حد مجاز، بیشتر است، فشردهسازی را متوقف میکند و
بلافاصله با 413 Request Entity Too Large با کد خطای
protocol.http.TooBigBody پاسخ میدهد.
تشخیص
- کد خطا، منبع خطا، و اندازه بار درخواست را برای خطای مشاهدهشده بااستفاده از «پایش میانای برنامهسازی کاربردی»، «ابزار ردیابی»، یا گزارشهای «دسترسی NGINX» همانطور که در مراحل تشخیص خرابی رایج با «سناریو ۲» (فشرده) توضیح داده شده است تعیین کنید.
- اگر منبع خطا مقدار
policyیاproxyداشته باشد، این نشان میدهد که اندازه بار درخواست ارسالی ازسوی برنامه کلاینت به Apigee بزرگتر از حد مجاز در Apigee Edge است. - اندازه بار داده درخواست را که از مرحله ۱ تعیین شده است درستیسنجی کنید.
- اگر اندازه پایهبار > حد مجاز ۱۰ مگابایت باشد، دلیل خطا همین است.
- اگر اندازه پایهبار کمتر از حد مجاز ۱۰ مگابایت باشد، ممکن است پایهبار درخواست در قالب فشرده ارسال شود. در این مورد، اندازه فشردهنشده بار درخواست فشرده را بررسی کنید.
- میتوانید بااستفاده از یکی از روشهای زیر، تأیید کنید که درخواست از مشتری در قالب فشرده ارسال شده است و اندازه فشردهنشده از حد مجاز بیشتر است:
ردیابی
برای راستیآزمایی بااستفاده از ابزار «ردیابی»:
- اگر ردیابی برای درخواست ناموفق ضبط کردهاید، به مراحل شرحدادهشده در
ردیابی و
- مقدار متغیر client.received.content.length را تعیین کنید
- بررسی کنید که آیا درخواست مشتری حاوی Content-Encoding:
gzipسرصفحه بوده است یا نه
- اگر مقدار متغیر client.received.content.length بزرگتر از
۱۰ مگابایت،
حد مجاز باشد، و سرایند درخواست Content-Encoding:
gzip, باشد، دراینصورت این دلیل بروز این خطا است.
درخواست واقعی
برای اعتبارسنجی بااستفاده از درخواست واقعی:
- اگر به درخواست واقعی که برنامه مشتری ایجاد کرده است دسترسی ندارید، به Resolution (حلوفصل) بروید.
- اگر به درخواست واقعی که توسط برنامه مشتری ایجاد شده است دسترسی دارید، مراحل زیر را انجام دهید:
- اندازه دادهبر ارسالی در درخواست را بههمراه
سرصفحه
Content-Encodingارسالشده در درخواست درستیسنجی کنید. بررسی کنید که آیا اندازه فشردهنشده پایهبار از حد مجاز در Apigee Edge بیشتر است یا نه
درخواست نمونه:
curl https://<hostalias>/testtoobigbody -k -X POST -F file=@test15mbfile.gz -H "Content-Encoding: gzip" -v
در مورد بالا، فایل
test15mbfile.gzکمتر از حد مجاز است؛ بااینحال، اندازه فایل فشردهنشدهtest15mbfileحدود ۱۵ مگابایت است و سرصفحهContent-Encodinggzipاست.اگر از کارخواه دیگری استفاده میکنید، گزارشهای کارخواه را دریافت کنید تا اندازه دادهبر ارسالشده و اینکه آیا سرایند
Content-Encodingرویgzipتنظیم شده است یا نه را متوجه شوید.
- اندازه دادهبر ارسالی در درخواست را بههمراه
سرصفحه
گزارشهای «پردازشگر پیام»
برای اعتبارسنجی بااستفاده از گزارشهای «پردازشگر پیام»:
- اگر کاربر «ابر خصوصی» هستید، میتوانید از گزارشهای «پردازشگر پیام» برای تعیین اطلاعات کلیدی درباره خطاهای HTTP
413استفاده کنید. گزارشهای «پردازشگر پیام» را بررسی کنید:
/opt/apigee/var/log/edge-message-processor/logs/system.logجستجو کنید تا ببینید آیا درطول مدت مشخصی خطاهای
413وجود دارد (اگر مشکل در گذشته رخ داده است) یا اینکه آیا هنوز درخواستهایی با413ناموفق هستند.میتوانید از رشتههای جستجوی زیر استفاده کنید:
grep -ri "chunkCount"
grep -ri "RequestTooLarge"
- خطوطی از
system.logمشابه با موارد زیر پیدا خواهید کرد (TotalReadوchunkCountممکن است در مورد شما متفاوت باشد):2021-07-06 13:29:57,544 NIOThread@1 ERROR HTTP.SERVICE - TrackingInputChannel.checkMessageBodyTooLarge() : Message is too large. TotalRead 10489856 chunkCount 2570 2021-07-06 13:29:57,545 NIOThread@1 INFO HTTP.SERVICE - ExceptionHandler.handleException() : Exception trace: com.apigee.errors.http.user.RequestTooLarge : Body buffer overflow
- درطول فرایند فشردهسازی، بهمحض اینکه «پردازنده پیام» تشخیص دهد مجموع بایتهای خواندهشده بیشتر از ۱۰ مگابایت است، متوقف میشود و خط زیر را چاپ میکند:
Message is too large. TotalRead 10489856 chunkCount 2570
این یعنی اندازه بار داده درخواست بیشتر از ۱۰ مگابایت است و Apigee وقتی اندازه از حد مجاز ۱۰ مگابایت فراتر میرود خطای
RequestTooLargeرا با کد خطایprotocol.http.TooBigBodyبرمیگرداند
- اگر ردیابی برای درخواست ناموفق ضبط کردهاید، به مراحل شرحدادهشده در
ردیابی و
وضوح
اندازه ثابت
گزینه ۱ [توصیهشده]: برنامه مشتری را اصلاح کنید تا اندازه پایهبار بزرگتر از حد مجاز ارسال نکند
- دلیل ارسال درخواست / اندازه پایهبار بیشتر از حد مجاز توسط مشتری خاص را طبق تعریف در حدود تجزیهوتحلیل کنید.
اگر مطلوب نیست، برنامه کلاینت خود را اصلاح کنید تا اندازه درخواست / بار آن کمتر از حد مجاز باشد.
در مثال بالا، میتوانید با ارسال فایل با اندازه کوچکتر، مثلاً
test5mbfile(با اندازه ۵ مگابایت) بار را همانطور که در زیر نشان داده شده است، مشکل را برطرف کنید:curl https://<host>/testtoobigbody -k -X POST -F file=@test5mbfile -v
- اگر مطلوب است و میخواهید درخواست/دادهبرداری را بیشاز حد مجاز ارسال کنید، به گزینههای بعدی بروید.
الگوی نشانی وب امضاشده
گزینه شماره ۲ [توصیهشده]: استفاده از الگوی نشانیهای وب امضاشده در Apigee JavaCallout
برای پیامهای با بار بزرگتر از ۱۰ مگابایت، Apigee توصیه میکند از الگوی نشانیهای وب امضاشده در Apigee JavaCallout استفاده کنید، همانطور که در مثال «پیامواره Edge: تولیدکننده نشانی وب امضاشده» در GitHub نشان داده شده است.
جاریسازی
گزینه شماره ۳ : استفاده از جاریسازی
اگر کارگزار نیابتی API شما باید درخواستها و/یا پاسخهای بسیار بزرگ را مدیریت کند، میتوانید جاریسازی را در Apigee فعال کنید.
CwC
گزینه شماره ۴ : استفاده از دارایی CwC برای افزایش حد میانگیری
این گزینه فقط باید زمانی استفاده شود که نتوانید از هیچیک از گزینههای توصیهشده استفاده کنید، زیرا اگر اندازه پیشفرض افزایش یابد ممکن است مشکلات عملکردی بهوجود آید.
Apigee دارایی CwC را ارائه میدهد که به آن امکان میدهد حد اندازه پایهبار درخواست و پاسخ را افزایش دهد. برای جزئیات، به تنظیم محدودیت اندازه پیام در «رهیاب» یا «پردازشگر پیام» مراجعه کنید
محدودیتها
Apigee انتظار دارد که برنامه مشتری و سرور پشتیبان اندازههای پایهبار بزرگتر از
حد مجاز را که در Request/response size در
محدودیتهای Apigee Edge مستند شده است ارسال نکنند.
- اگر کاربر «ابر عمومی» هستید، حداکثر حد اندازه بار داده درخواست و پاسخ همانطور که برای
Request/response sizeدر محدودیتهای Apigee Edge مستند شده است. - اگر کاربر «ابر خصوصی» هستید، ممکن است حد پیشفرض اندازه بار داده درخواست و پاسخ را تغییر داده باشید (اگرچه این کار توصیه نمیشود). با دنبال کردن دستورالعملهای نحوه بررسی حد فعلی میتوانید حد حداکثر اندازه پایهبار درخواست را تعیین کنید.
چگونه حد فعلی را بررسی کنیم؟
این بخش توضیح میدهد که چگونه درستیسنجی کنید دارایی HTTPRequest.body.buffer.limit
با مقدار جدیدی در «پردازشگرهای پیام» بهروز شده است.
- در دستگاه «پردازشگر پیام»، دارایی
HTTPRequest.body.buffer.limitرا در دایرکتوری/opt/apigee/edge-message- processor/confجستجو کنید و بااستفاده از دستور زیر بررسی کنید چه مقداری تنظیم شده است:grep -ri "HTTPRequest.body.buffer.limit" /opt/apigee/edge-message-processor/conf
- نتیجه نمونه از فرمان بالا به این صورت است:
/opt/apigee/edge-message-processor/conf/http.properties:HTTPRequest.body.buffer.limit=10m
در برونداد مثال بالا، توجه کنید که دارایی
HTTPRequest.body.buffer.limitبا مقدار10mدرhttp.propertiesتنظیم شده است.این نشان میدهد که حد مجاز اندازه بار درخواست پیکربندیشده در Apigee برای Private Cloud ۱۰ مگابایت است.
اگر هنوز به کمک «پشتیبانی Apigee» نیاز دارید، به باید اطلاعات تشخیصی را جمعآوری کنید بروید.
باید اطلاعات تشخیص خرابی را جمعآوری کند
اطلاعات تشخیص خرابی زیر را جمعآوری کنید و سپس با پشتیبانی Apigee Edge تماس بگیرید:
اگر کاربر «ابر عمومی» هستید، اطلاعات زیر را ارائه دهید:
- نام سازمان
- نام محیط
- نام پراکسی میانای برنامهسازی کاربردی
- فرمان curl کامل استفادهشده برای بازتولید خطای
413 - فایل ردیابی برای درخواستهای API
اگر کاربر «ابر خصوصی» هستید، اطلاعات زیر را ارائه دهید:
- پیام خطای کامل مشاهدهشده برای درخواستهای ناموفق
- نام سازمان
- نام محیط
- دسته «پراکسی میانای برنامهسازی کاربردی»
- فایل ردیابی برای درخواستهای ناموفق میانای برنامهسازی کاربردی
- فرمان curl کامل استفادهشده برای بازتولید خطای
413 گزارشهای دسترسی 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