خطای اتمام مهلت زمانی دروازه نادرست ۵۰۲

درحال مشاهده اسناد Apigee Edge هستید.
به اسناد Apigee X بروید.
اطلاعات

نشانه

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

پیام خطا

برنامه کارخواه کد پاسخ زیر را دریافت می‌کند:

HTTP/1.1 502 Bad Gateway

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

{
 "fault": {
    "faultstring":"Bad Gateway",
    "detail":{
        "errorcode":"messaging.adaptors.http.flow.BadGateway"
    }
 }
}

علت احتمالی

علت احتمالی این مشکل در جدول زیر فهرست شده است:

علت شرح مراحل عیب‌یابی را می‌توان توسط
مهلت دست‌دهی TLS/SSL درطول «دست‌دهی TLS/SSL» بین «پردازشگر پیام» و سرور زیرینه، زمان‌بندی پایان می‌یابد. کاربران «ابر خصوصی» و «ابر عمومی» لبه

علت: زمان‌بندی دست‌دهی TLS/SSL به‌پایان رسید

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

دست دادن TLS/SSL شامل چندین مرحله است. این خطا معمولاً زمانی رخ می‌دهد که دست‌دهی TLS/SSL بین «پردازشگر پیام» و سرور پشتیبان زمان‌بندی شود.

تشخیص

این بخش توضیح می‌دهد که چگونه مهلت اتمام دست‌دهی TLS/SSL را به‌درستی تشخیص دهید. دستورالعمل‌های مربوط به «ابر خصوصی Edge» و «ابر عمومی» فهرست شده است.

بررسی خروجی جلسه «ردیابی»

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

  1. در «واسط کاربر Edge»، یک جلسه ردیابی برای پراکسی API تحت‌تأثیرقرارگرفته فعال کنید.
  2. اگر ردیابی درخواست ناموفق API موارد زیر را نشان دهد، احتمالاً خطای مهلت اتمام دست‌دهی TLS/SSL رخ داده است. دلیل احتمالی این خطا این است که دیوار آتش سرور زیرینه ترافیک Apigee را مسدود می‌کند.

    1. تعیین کنید که آیا خطای 502 Bad Gateway پس‌از ۵۵ ثانیه، که دوره مهلت زمانی پیش‌فرض تنظیم‌شده در «پردازنده پیام» است، رخ می‌دهد یا نه. اگر می‌بینید که خطا پس‌از ۵۵ ثانیه رخ داده است، این نشان می‌دهد که احتمالاً علت مشکل اتمام زمان بوده است.
    2. تعیین کنید که آیا خطا messaging.adaptors.http.BadGateway را نشان می‌دهد یا نه. باز هم، این خطا معمولاً نشان‌دهنده وقوع یک زمان‌بندی است.
    3. اگر از Edge Private Cloud استفاده می‌کنید، مقدار فیلد X-Apigee.Message-ID را در برونداد ردیابی همان‌طور که در زیر نشان داده شده است یادداشت کنید. کاربر «ابر خصوصی» می‌تواند از این مقدار شناسه برای عیب‌یابی بیشتر استفاده کند، همان‌طور که در ادامه توضیح داده شده است.

      1. روی نماد داده‌های Analytics ضبط‌شده در مسیر ردپای کلیک کنید:

      2. به‌پایین پیمایش کنید و مقدار فیلدی به‌نام X-Apigee.Message-ID را یادداشت کنید.

برای تأیید اینکه زمان‌بندی اتمام «دست‌دهی TLS/SSL» دلیل خطا بوده است، بسته به اینکه در «ابر عمومی» یا «ابر خصوصی» هستید، مراحل بخش‌های زیر را دنبال کنید.

مراحل عیب‌یابی اضافی فقط برای کاربران Edge Private Cloud

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

  1. بررسی کنید که آیا می‌توانید بااستفاده از دستور telnet مستقیماً از هریک از «پردازشگرهای پیام» به سرور زیرینه خاص متصل شوید:

    1. اگر سرور پشتیبان به یک نشانی IP واحد حل‌وفصل می‌شود، از این فرمان استفاده کنید:

      telnet BackendServer-IPaddress 443
    2. اگر سرور پشتیبان به چندین نشانی IP تبدیل می‌شود، از نام میزبان سرور پشتیبان در دستور telnet استفاده کنید، همان‌طور که در زیر نشان داده شده است:

      telnet BackendServer-HostName 443

    اگر می‌توانید بدون هیچ خطایی به سرور زیرینه متصل شوید، به مرحله بعدی بروید.

    اگر دستور telnet ناموفق بود، باید با تیم شبکه خود همکاری کنید تا اتصال بین پردازشگر پیام و سرور پشتیبان را بررسی کنید.

  2. فایل گزارش «پردازشگر پیام» را برای یافتن شواهدی از عدم موفقیت در دست دادن بررسی کنید. فایل را باز کنید:

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

    و شناسه پیام یکتا را جستجو کنید (مقدار X-Apigee.Message-ID که در فایل ردیابی پیدا کردید). تعیین کنید که آیا پیام خطای دست دادن مرتبط با شناسه پیام را همان‌طور که در زیر نشان داده شده است می‌بینید یا خیر:

    org:xxx env:xxx api:xxx rev:x messageid:<MESSAGE_ID> NIOThread@1 ERROR HTTP.CLIENT -
    HTTPClient$Context.handshakeTimeout() : SSLClientChannel[Connected: Remote:X.X.X.X:443
    Local:X.X.X.X]@739028 useCount=1 bytesRead=0 bytesWritten=0 age=55221ms lastIO=55221ms
    isOpen=true handshake timeout
    

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

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

مراحل عیب‌یابی بیشتر برای کاربران Edge Private و Public Cloud

برای دقیق‌تر مشخص کردن مشکل، می‌توانید از ابزار tcpdump برای تجزیه‌وتحلیل بسته‌های TCP/IP استفاده کنید تا تأیید کنید که آیا درطول دست دادن TLS/SSL مهلت زمانی به‌پایان رسیده است یا نه.

  1. اگر کاربر «ابر خصوصی» هستید، می‌توانید بسته‌های TCP/IP را در سرور پشتیبان یا «پردازشگر پیام» ضبط کنید. ترجیحاً آن‌ها را در سرور پشتیبان ضبط کنید، زیرا بسته‌ها در سرور پشتیبان رمزگشایی می‌شوند.
  2. اگر کاربر «ابر عمومی» هستید، به «پردازنده پیام» دسترسی ندارید؛ بااین‌حال، ضبط بسته‌های TCP/IP در سرور زیرینه می‌تواند به تشخیص مشکل کمک کند.
  3. پس‌از تصمیم‌گیری درباره مکان ضبط بسته‌های TCP/IP، از فرمان tcpdump زیر برای ضبط بسته‌های TCP/IP استفاده کنید.

    tcpdump -i any -s 0 host <IP address> -w <File name>
    
    • اگر بسته‌های TCP/IP را در سرور پشتیبان می‌گیرید، از نشانی IP عمومی «پردازنده پیام» در دستور tcpdump استفاده کنید. برای دریافت راهنمایی درباره استفاده از فرمان برای بررسی ترافیک سرور زیرینه، به tcpdump مراجعه کنید.

    • اگر بسته‌های TCP/IP را در «پردازنده پیام» می‌گیرید، از نشانی IP عمومی سرور پشتیبان در فرمان tcpdump استفاده کنید. برای دریافت راهنمایی درباره استفاده از فرمان برای بررسی ترافیک «پردازشگر پیام»، به tcpdump مراجعه کنید.

    • اگر چندین نشانی IP برای سرور پشتیبان/پردازشگر پیام وجود دارد، باید از روش دیگری برای استفاده از فرمان tcpdump استفاده کنید. برای اطلاعات بیشتر درباره این ابزار و برای انواع دیگر این فرمان، به tcpdump مراجعه کنید.

  4. بسته‌های TCP/IP را بااستفاده از ابزار Wireshark یا ابزاری مشابه تجزیه‌وتحلیل کنید. نماگرفت زیر بسته‌های TCP/IP را در Wireshark نشان می‌دهد.

  5. توجه داشته باشید که در برونداد Wireshark، دست دادن سه‌طرفه TCP در ۳ بسته اول با موفقیت تکمیل می‌شود.

  6. سپس «پردازنده پیام» پیام «سلام مشتری» را در بسته شماره ۴ ارسال می‌کند.

  7. چون سرور زیرینه تأییدیه‌ای ارسال نمی‌کند، «پردازنده پیام» پس‌از انتظار برای فاصله زمانی ازپیش‌تعیین‌شده، پیام «سلام مشتری» را چندین بار در بسته‌های ۵، ۶، و ۷ بازانتقال می‌دهد.

  8. وقتی «پردازنده پیام» پس‌از ۳ تلاش مجدد هیچ تأییدیه‌ای دریافت نکند، پیام FIN, ACK را به سرور زیرینه ارسال می‌کند تا نشان دهد که اتصال را می‌بندد.

  9. همان‌طور که در جلسه Wireshark نمونه نشان دادید، اتصال به زیرینه موفقیت‌آمیز است (مرحله ۱)، اما زمان دست‌دهی SSL به‌پایان رسید زیرا سرور زیرینه هرگز پاسخ نداد.

اگر مراحل عیب‌یابی را در این کتابچه انجام دادید و متوجه شدید که مهلت زمانی باعث خطای دست دادن TLS/SSL شده است، به بخش راه‌حل بروید.

استفاده از «پایش میانای برنامه‌سازی کاربردی» برای شناسایی مشکل

پایش میانای برنامه‌سازی کاربردی به شما امکان می‌دهد تا مناطق مشکل‌دار را به‌سرعت جدا کنید تا مشکلات خطا، عملکرد، و تأخیر و منبع آن‌ها را تشخیص دهید، مثلاً برنامه‌های توسعه‌دهنده، پراکسی‌های میانای برنامه‌سازی کاربردی، هدف‌های زیرینه، یا پلاتفرم میانای برنامه‌سازی کاربردی.

گام‌به‌گام ازطریق یک سناریو نمونه که نشان می‌دهد چگونه بااستفاده از «پایش API» مشکلات ۵xx را در APIهای خود عیب‌یابی کنید. برای مثال، ممکن است بخواهید هشداری راه‌اندازی کنید تا وقتی تعداد خطاهای messaging.adaptors.http.BadGateway از آستانه خاصی فراتر رفت به شما اطلاع داده شود.

وضوح

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

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

اگر محدودیت‌های دیوار آتش وجود ندارد و/یا مشکل همچنان ادامه دارد، به باید اطلاعات تشخیصی را جمع‌آوری کنید بروید.

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

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

  1. اگر کاربر «ابر عمومی» هستید، اطلاعات زیر را ارائه دهید:
    1. Organization Name
    2. نام محیط
    3. نام پراکسی میانای برنامه‌سازی کاربردی
    4. فرمان curl را برای بازتولید خطا تکمیل کنید
    5. فایل ردیابی که خطا را نشان می‌دهد
    6. بسته‌های TCP/IP در سرور پشتیبان ضبط شد
  2. اگر کاربر «ابر خصوصی» هستید، اطلاعات زیر را ارائه دهید:
    1. پیام خطای کامل مشاهده شد
    2. دسته «پراکسی میانای برنامه‌سازی کاربردی»
    3. فایل ردیابی که خطا را نشان می‌دهد
    4. گزارش‌های «پردازشگر پیام» /opt/apigee/var/log/edge-message-processor/logs/system.log
    5. بسته‌های TCP/IP در سرور پشتیبان یا «پردازشگر پیام» ضبط شده است.
  3. جزئیاتی درباره اینکه کدام بخش‌های این «کتابچه راهنما» را امتحان کرده‌اید و هرگونه اطلاعات آماری دیگری که به ما کمک می‌کند این مشکل را سریع‌تر حل کنیم.