‫۵۰۳ سرویس دردسترس نیست - سرور زیرینه زودتر از موعد بسته شد

درحال مشاهده اسناد 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"
       }
    }
}

علل احتمالی

علت شرح دستورالعمل‌های عیب‌یابی برای موارد زیر قابل‌اجرا است
سرور هدف اتصال را زودتر ازموعد می‌بندد سرور مقصد اتصال را زودتر از موعد پایان می‌دهد درحالی‌که «پردازشگر پیام» هنوز درحال ارسال بار درخواست است. کاربران «فضای ابری خصوصی و عمومی لبه‌ای»

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

شناسه پیام درخواست ناموفق را تعیین کنید

ابزار ردیابی

برای تعیین شناسه پیام درخواست ناموفق بااستفاده از ابزار «ردیابی»:

  1. اگر مشکل همچنان فعال است، جلسه ردیابی را برای میانای برنامه‌سازی کاربردی تحت‌تأثیر قرارگرفته فعال کنید.
  2. فراخوانی API را انجام دهید و مشکل را بازتولید کنید - 503 Service Unavailable با کد خطای messaging.adaptors.http.flow.ServiceUnavailable.
  3. یکی از درخواست‌های ناموفق را انتخاب کنید.
  4. به فاز AX پیمایش کنید و با پیمایش به پایین در بخش جزئیات فاز، شناسه پیام درخواست (X-Apigee.Message-ID) را تعیین کنید، همان‌طور که در شکل زیر نشان داده شده است.

    شناسه پیام در بخش «جزئیات فاز»

گزارش‌های دسترسی NGINX

برای تعیین شناسه پیام درخواست ناموفق بااستفاده از گزارش‌های دسترسی NGINX:

همچنین می‌توانید به گزارش‌های NGINX Access مراجعه کنید تا شناسه پیام را برای خطاهای 503 تعیین کنید. این ویژگی به‌ویژه درصورتی مفید است که مشکل در گذشته رخ داده باشد یا مشکل متناوب باشد و نتوانید ردگیری را در واسط کاربر ضبط کنید. برای تعیین این اطلاعات از گزارش‌های دسترسی NGINX، از مراحل زیر استفاده کنید:

  1. گزارش‌های دسترسی NGINX را بررسی کنید: (/opt/apigee/var/log/edge-router/nginx/ORG~ENV.PORT#_access_log)
  2. جستجو کنید تا ببینید آیا درطول مدت مشخصی برای پراکسی API خاصی خطای 503 وجود دارد یا نه (اگر مشکل در گذشته رخ داده است) یا اینکه آیا هنوز درخواست‌هایی با خطای 503 وجود دارد یا نه.
  3. اگر 503 خطا در X-Apigee-fault-code messaging.adaptors.http.flow.ServiceUnavailable وجود دارد، شناسه پیام را برای یک یا چند درخواست ازاین‌دست که در مثال زیر نشان داده شده است یادداشت کنید:

    نمونه ورودی که خطای 503 را نشان می‌دهد

    ورودی نمونه که کد وضعیت، شناسه پیام، منبع خطا، و کد خطا را نشان می‌دهد

دلیل: سرور مقصد اتصال را زودتر از موعد می‌بندد

تشخیص

  1. اگر کاربر فضای ابری عمومی یا فضای ابری خصوصی هستید:
    1. از ابزار «ردیابی» (همان‌طور که در مراحل تشخیص خرابی رایج توضیح داده شده است) استفاده کنید و تأیید کنید که هر دو مورد زیر را در قاب داده‌های Analytics ضبط‌شده تنظیم کرده‌اید:
      • X-Apigee.fault-code: messaging.adaptors.http.flow.ServiceUnavailable
      • X-Apigee.fault-source: target

      alt_text

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

      alt_text

    3. برای بررسی بیشتر، به استفاده از tcpdump بروید.
  2. اگر کاربر فضای ابری خصوصی هستید:
    • شناسه پیام درخواست ناموفق را تعیین کنید.
    • شناسه پیام را در گزارش «پردازشگر پیام» (/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

  1. با فرمان‌های زیر، 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
    
  2. ‫tcpdump ضبط‌شده را تجزیه‌وتحلیل کنید:

    برونداد نمونه tcpdump (جمع‌آوری‌شده در «پردازشگر پیام»):

    alt_text

    در tcpdump بالا، می‌توانید موارد زیر را ببینید:

    1. در بسته 4، «پردازشگر پیام» درخواست POST را به سرور زیرینه ارسال کرد.
    2. در بسته 5، 8، 9، 10، 11، «پردازشگر پیام» همچنان محتوای درخواست را به سرور زیرینه ارسال می‌کرد.
    3. در بسته 6 و 7، سرور زیرینه با ACK برای بخشی از محتوای درخواست دریافتی از «پردازشگر پیام» پاسخ داد.
    4. بااین‌حال، در بسته 12، به‌جای پاسخ دادن با ACK برای بسته‌های داده برنامه دریافتی و سپس پاسخ دادن با داده بار پاسخ، سرور زیرینه درعوض با FIN ACK پاسخ می‌دهد که باعث بسته شدن اتصال می‌شود.
    5. این نشان می‌دهد که سرور پشتیبان اتصال را زودتر ازموعد بسته است درحالی‌که «پردازشگر پیام» هنوز درحال ارسال بار درخواست بوده است.
    6. این امر باعث می‌شود «پردازشگر پیام» خطایی را ثبت کند و IOException: Broken Pipe 503 را به مشتری برگرداند

وضوح

  1. با تیم‌های برنامه و شبکه خود همکاری کنید تا مشکل قطع ارتباط‌های زودرس در سمت سرور زیرینه را تجزیه‌وتحلیل و برطرف کنید.
  2. مطمئن شوید که برنامه سرور پشتیبان قبل‌از دریافت کل بار درخواست، اتصال را بازنشانی یا زمان‌بندی نمی‌کند.
  3. اگر بین 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 در «پردازنده‌های پیام» و سرور زیرینه هنگام وقوع خطا جمع‌آوری شد