درحال مشاهده اسناد Apigee Edge هستید.
به
اسناد Apigee X بروید. اطلاعات
نشانه
برنامه کارخواه پساز فراخوانی کارگزار API، وضعیت پاسخ HTTP 503 را با پیام
Service Unavailable دریافت میکند.
پیام خطا
برنامه کارخواه کد پاسخ زیر را دریافت میکند:
HTTP/1.1 503 Service Unavailable
علاوهبراین، ممکن است پیام خطای زیر را مشاهده کنید:
{
"fault": {
"faultstring": "The Service is temporarily unavailable",
"detail": {
"errorcode": "messaging.adaptors.http.flow.ServiceUnavailable"
}
}
}علل احتمالی
| علت | شرح | دستورالعملهای عیبیابی برای موارد زیر قابلاجرا است |
|---|---|---|
| سرور هدف اتصال را زودتر ازموعد میبندد | سرور مقصد اتصال را زودتر از موعد پایان میدهد درحالیکه «پردازشگر پیام» هنوز درحال ارسال بار درخواست است. | کاربران «فضای ابری خصوصی و عمومی لبهای» |
مراحل متداول تشخیص خرابی
شناسه پیام درخواست ناموفق را تعیین کنید
ابزار ردیابی
برای تعیین شناسه پیام درخواست ناموفق بااستفاده از ابزار «ردیابی»:
- اگر مشکل همچنان فعال است، جلسه ردیابی را برای میانای برنامهسازی کاربردی تحتتأثیر قرارگرفته فعال کنید.
- فراخوانی API را انجام دهید و مشکل را بازتولید کنید -
503 Service Unavailableبا کد خطایmessaging.adaptors.http.flow.ServiceUnavailable. - یکی از درخواستهای ناموفق را انتخاب کنید.
- به فاز AX پیمایش کنید و با پیمایش به پایین در بخش
جزئیات فاز، شناسه پیام درخواست (
X-Apigee.Message-ID) را تعیین کنید، همانطور که در شکل زیر نشان داده شده است.
گزارشهای دسترسی NGINX
برای تعیین شناسه پیام درخواست ناموفق بااستفاده از گزارشهای دسترسی NGINX:
همچنین میتوانید به گزارشهای NGINX Access مراجعه کنید تا شناسه پیام را برای خطاهای 503 تعیین کنید.
این ویژگی بهویژه درصورتی مفید است که مشکل در گذشته رخ داده باشد یا مشکل متناوب باشد و نتوانید ردگیری را در واسط کاربر ضبط کنید. برای تعیین این اطلاعات از گزارشهای دسترسی NGINX، از مراحل زیر استفاده کنید:
- گزارشهای دسترسی NGINX را بررسی کنید: (
/opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log) - جستجو کنید تا ببینید آیا درطول مدت مشخصی برای پراکسی API خاصی خطای
503وجود دارد یا نه (اگر مشکل در گذشته رخ داده است) یا اینکه آیا هنوز درخواستهایی با خطای503وجود دارد یا نه. - اگر
503خطا در X-Apigee-fault-code messaging.adaptors.http.flow.ServiceUnavailable وجود دارد، شناسه پیام را برای یک یا چند درخواست ازایندست که در مثال زیر نشان داده شده است یادداشت کنید:نمونه ورودی که خطای
503را نشان میدهد
دلیل: سرور مقصد اتصال را زودتر از موعد میبندد
تشخیص
- اگر کاربر فضای ابری عمومی یا فضای ابری خصوصی هستید:
- از ابزار «ردیابی» (همانطور که در مراحل تشخیص خرابی رایج توضیح داده شده است)
استفاده کنید و تأیید کنید که هر دو مورد زیر را در قاب دادههای Analytics ضبطشده تنظیم کردهاید:
- X-Apigee.fault-code:
messaging.adaptors.http.flow.ServiceUnavailable - X-Apigee.fault-source:
target

- X-Apigee.fault-code:
- از ابزار «ردیابی» (همانطور که در مراحل تشخیص خرابی رایج توضیح داده شده است) استفاده کنید
و تأیید کنید که هر دو مورد زیر را در قاب خطا بلافاصله پساز
دارایی
TARGET_REQ_FLOWوضعیت تنظیم کردهاید:- error.class:
com.apigee.errors.http.server.ServiceUnavailableException - error.cause:
Broken pipe

- error.class:
- برای بررسی بیشتر، به استفاده از tcpdump بروید.
- از ابزار «ردیابی» (همانطور که در مراحل تشخیص خرابی رایج توضیح داده شده است)
استفاده کنید و تأیید کنید که هر دو مورد زیر را در قاب دادههای Analytics ضبطشده تنظیم کردهاید:
- اگر کاربر فضای ابری خصوصی هستید:
- شناسه پیام درخواست ناموفق را تعیین کنید.
- شناسه پیام را در گزارش «پردازشگر پیام»
(
/opt/apigee/var/log/edge-message-processor/logs/system.log) جستجو کنید. - یکی از استثنائات زیر را خواهید دید:
استثنا شماره ۱: java.io.IOException: هنگام نوشتن در کانال ClientOutputChannel، خطای لوله شکسته رخ داد
2021-01-30 15:31:14,693 org:anotherorg env:prod api:myproxy rev:1 messageid:myorg-opdk-test-1-30312-13747-1 NIOThread@1 INFO HTTP.SERVICE - ExceptionHandler.handleException() : Exception java.io.IOException: Broken pipe occurred while writing to channel ClientOutputChannel(ClientChannel[Connected: Remote:IP:PORT Local:0.0.0.0:42828]@8380 useCount=1 bytesRead=0 bytesWritten=76295 age=2012ms lastIO=2ms isOpen=false)
یا
استثنا شماره ۲: استثنا در onExceptionWrite: {}
java.io.IOException: Broken pipe (لوله شکسته)2021-01-31 15:29:37,438 org:anotherorg env:prod api:503-test rev:1 messageid:leonyoung-opdk-test-1-18604-13978-1 NIOThread@0 ERROR HTTP.CLIENT - HTTPClient$Context$2.onException() : ClientChannel[Connected: Remote:IP:PORT Local:0.0.0.0:57880]@8569 useCount=1 bytesRead=0 bytesWritten=76295 age=3180ms lastIO=2 ms isOpen=false.onExceptionWrite exception: {} java.io.IOException: Broken pipe
- هر دوی این استثناها نشان میدهند که درحالیکه «پردازشگر پیام» هنوز درحال نوشتن بار پیام درخواست به سرور زیرینه بوده است، سرور زیرینه اتصال را زودتر ازموعد بسته است. بنابراین، «پردازشگر پیام» استثنای
java.io.IOException: Broken pipeرا ایجاد میکند. Remote:IP:PORTنشانی IP و شماره درگاه سرور پشتیبان حلوفصلشده را نشان میدهد.- ویژگی
bytesWritten=76295در پیام خطای بالا نشان میدهد که «پردازنده پیام» بار دادهای بهاندازه76295بایت به سرور زیرینه ارسال کرده است، درحالیکه اتصال زودتر از موعد بسته شده است. - مشخصه
bytesRead=0نشان میدهد که «پردازنده پیام» هیچ دادهای (پاسخی) از سرور زیرینه دریافت نکرده است. - برای بررسی بیشتر این مشکل،
tcpdumpرا در سرور پشتیبان یا «پردازشگر پیام» جمعآوری کنید و آن را همانطور که در زیر توضیح داده شده است تجزیهوتحلیل کنید.
استفاده از tcpdump
-
با فرمانهای زیر،
tcpdumpرا در سرور زیرینه یا «پردازنده پیام» ضبط کنید:فرمان جمعآوری
tcpdumpدر سرور زیرینه:tcpdump -i any -s 0 host MP_IP_ADDRESS -w FILE_NAME
دستور جمعآوری
tcpdumpدر «پردازشگر پیام»:tcpdump -i any -s 0 host BACKEND_HOSTNAME -w FILE_NAME
-
tcpdumpضبطشده را تجزیهوتحلیل کنید:برونداد نمونه tcpdump (جمعآوریشده در «پردازشگر پیام»):

در
tcpdumpبالا، میتوانید موارد زیر را ببینید:- در بسته
4، «پردازشگر پیام» درخواستPOSTرا به سرور زیرینه ارسال کرد. - در بسته
5،8،9،10،11، «پردازشگر پیام» همچنان محتوای درخواست را به سرور زیرینه ارسال میکرد. - در بسته
6و7، سرور زیرینه باACKبرای بخشی از محتوای درخواست دریافتی از «پردازشگر پیام» پاسخ داد. - بااینحال، در بسته
12، بهجای پاسخ دادن باACKبرای بستههای داده برنامه دریافتی و سپس پاسخ دادن با داده بار پاسخ، سرور زیرینه درعوض باFIN ACKپاسخ میدهد که باعث بسته شدن اتصال میشود. - این نشان میدهد که سرور پشتیبان اتصال را زودتر ازموعد بسته است درحالیکه «پردازشگر پیام» هنوز درحال ارسال بار درخواست بوده است.
- این امر باعث میشود «پردازشگر پیام» خطایی را ثبت کند و
IOException: Broken Pipe503را به مشتری برگرداند
- در بسته
وضوح
- با تیمهای برنامه و شبکه خود همکاری کنید تا مشکل قطع ارتباطهای زودرس در سمت سرور زیرینه را تجزیهوتحلیل و برطرف کنید.
- مطمئن شوید که برنامه سرور پشتیبان قبلاز دریافت کل بار درخواست، اتصال را بازنشانی یا زمانبندی نمیکند.
- اگر بین Apigee و سرور پشتیبان دستگاه یا لایه شبکه واسطهای دارید، مطمئن شوید که قبلاز دریافت کل بار درخواست، زمان آنها بهپایان نرسد.
اگر مشکل همچنان ادامه داشت، به باید اطلاعات تشخیصی را جمعآوری کنید بروید.
باید اطلاعات تشخیص خرابی را جمعآوری کند
اگر مشکل حتی پساز دنبال کردن دستورالعملهای بالا ادامه داشت، اطلاعات تشخیصی زیر را جمعآوری کنید و سپس با پشتیبانی Apigee Edge تماس بگیرید:
اگر کاربر «ابر عمومی» هستید، اطلاعات زیر را ارائه دهید:
- نام سازمان
- نام محیط
- نام پراکسی میانای برنامهسازی کاربردی
- برای بازتولید خطای
503، فرمانcurlرا تکمیل کنید - فایل ردیابی حاوی درخواست با خطای
503 Service Unavailable - اگر خطاهای
503درحالحاضر رخ نمیدهد، دوره زمانی را با اطلاعات منطقه زمانی که خطاهای503در گذشته رخ داده است ارائه دهید.
اگر کاربر «ابر خصوصی» هستید، اطلاعات زیر را ارائه دهید:
- پیام خطای کامل مشاهدهشده برای درخواستهای ناموفق
- نام سازمان، نام محیط، و نام «پراکسی API» که برای آن
503خطا مشاهده میکنید - دسته «پراکسی میانای برنامهسازی کاربردی»
- فایل ردیابی حاوی درخواستهای دارای خطای
503 Service Unavailable - گزارشهای دسترسی NGINX
/opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log - گزارشهای «پردازشگر پیام»
/opt/apigee/var/log/edge-message-processor/logs/system.log - دوره زمانی با اطلاعات منطقه زمانی که خطاهای
503رخ داده است Tcpdumpsدر «پردازندههای پیام» و سرور زیرینه هنگام وقوع خطا جمعآوری شد