502 ভুল গেটওয়ে টাইমআউট সমস্যা

আপনি Apigee Edge ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন দেখুন।
তথ্য

সমস্যার উপসর্গ

ক্লায়েন্ট অ্যাপ্লিকেশন 502 ভুল গেটওয়ে সমস্যা সংক্রান্ত মেসেজ পায়। ব্যাকএন্ড সার্ভার থেকে কোনও উত্তর না পেলে মেসেজ প্রসেসর ক্লায়েন্ট অ্যাপ্লিকেশনকে এই সমস্যাটি জানায়।

সমস্যা সংক্রান্ত মেসেজ

ক্লায়েন্ট অ্যাপ্লিকেশন নিম্নলিখিত রেসপন্স কোড পায়:

HTTP/1.1 502 Bad Gateway

এছাড়াও, আপনি নিম্নলিখিত সমস্যার মেসেজ দেখতে পেতে পারেন:

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

সম্ভাব্য কারণ

এই সমস্যার সম্ভাব্য কারণগুলি নিম্নলিখিত টেবিলে তালিকাভুক্ত করা হয়েছে:

কারণ বিবরণ সমস্যার সমাধানকারী ধাপগুলি এগুলির মাধ্যমে করা যেতে পারে
TLS/SSL হ্যান্ডশেক টাইম-আউট মেসেজ প্রসেসর ও ব্যাকএন্ড সার্ভারের মধ্যে TLS/SSL হ্যান্ডশেক চলাকালীন টাইম-আউট হয়ে যায়। Edge প্রাইভেট ও পাবলিক ক্লাউড ব্যবহারকারী

কারণ: TLS/SSL হ্যান্ডশেক টাইম-আউট

Apigee Edge-এ, Edge মেসেজ প্রসেসর ও ব্যাকএন্ড সার্ভারের মধ্যে TLS কমিউনিকেশন চালু করতে, আপনি ব্যাকএন্ড সার্ভারের সাথে TLS/SSL কানেকশন সেট-আপ করতে পারেন।

TLS/SSL হ্যান্ডশেক একাধিক ধাপের মাধ্যমে সম্পন্ন হয়। এই সমস্যাটি সাধারণত তখন হয় যখন মেসেজ প্রসেসর ও ব্যাকএন্ড সার্ভারের মধ্যে TLS/SSL হ্যান্ডশেক টাইম-আউট হয়ে যায়।

ডায়াগনসিস

এই বিভাগে TLS/SSL হ্যান্ডশেক টাইম-আউট সঠিকভাবে কীভাবে ডায়াগনসিস করতে হয় তা ব্যাখ্যা করা হয়েছে। Edge Private Cloud এবং Public Cloud-এর জন্য নির্দেশাবলী তালিকাভুক্ত করা আছে।

Trace সেশন আউটপুট তদন্ত করা

Apigee Edge Trace টুল ব্যবহার করে কীভাবে সমস্যার প্রাথমিক ডায়াগনোসিস করবেন তা নিম্নলিখিত ধাপগুলি থেকে জানতে পারবেন।

  1. Edge UI-তে, প্রভাবিত API প্রক্সির জন্য ট্রেস সেশন চালু করুন।
  2. API অনুরোধ ব্যর্থ হওয়ার ট্রেস যদি নিম্নলিখিত তথ্য দেখায়, তাহলে সম্ভবত TLS/SSL হ্যান্ডশেক টাইম-আউট সংক্রান্ত সমস্যা হয়েছে। সম্ভাব্য কারণ হল, ব্যাকএন্ড সার্ভার ফায়ারওয়াল Apigee থেকে আসা ট্রাফিক ব্লক করছে।

    1. ৫৫ সেকেন্ড পরে 502 ভুল গেটওয়ে সমস্যা হচ্ছে কিনা তা নির্ধারণ করুন, যা মেসেজ প্রসেসরে সেট করা ডিফল্ট টাইম-আউট পিরিয়ড। আপনি যদি দেখেন যে ৫৫ সেকেন্ড পরে সমস্যা হয়েছে, তাহলে এটি থেকে বোঝা যায় যে টাইম-আউটই সমস্যার সম্ভাব্য কারণ।
    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 প্রাইভেট ও পাবলিক ক্লাউড ব্যবহারকারীদের জন্য আরও ডায়াগনস্টিক ধাপ

সমস্যাটি আরও নির্দিষ্টভাবে চিহ্নিত করতে, TLS/SSL হ্যান্ডশেক চলাকালীন কোনও টাইম-আউট হয়েছে কিনা তা কনফার্ম করতে, আপনি TCP/IP প্যাকেট বিশ্লেষণ করার জন্য tcpdump টুল ব্যবহার করতে পারেন।

  1. আপনি প্রাইভেট ক্লাউড ব্যবহারকারী হলে, আপনি ব্যাকএন্ড সার্ভার বা মেসেজ প্রসেসরে TCP/IP প্যাকেট ক্যাপচার করতে পারবেন। পছন্দমতো, ব্যাকএন্ড সার্ভারে সেগুলি ক্যাপচার করুন, কারণ ব্যাকএন্ড সার্ভারে প্যাকেট ডিক্রিপ্ট করা হয়।
  2. আপনি পাবলিক ক্লাউড ব্যবহারকারী হলে, আপনার কাছে Message Processor-এর অ্যাক্সেস নেই; তবে, ব্যাকএন্ড সার্ভারে TCP/IP প্যাকেট ক্যাপচার করলে সমস্যাটি চিহ্নিত করতে সাহায্য করতে পারে।
  3. TCP/IP প্যাকেট কোথায় ক্যাপচার করবেন তা ঠিক করার পরে, TCP/IP প্যাকেট ক্যাপচার করতে, নিম্নলিখিত tcpdump কমান্ড ব্যবহার করুন।

    tcpdump -i any -s 0 host <IP address> -w <File name>
    
    • আপনি যদি ব্যাকএন্ড সার্ভারে TCP/IP প্যাকেট নিচ্ছেন, তাহলে tcpdump কমান্ডে মেসেজ প্রসেসরের পাবলিক IP অ্যাড্রেস ব্যবহার করুন। ব্যাকএন্ড সার্ভার ট্রাফিক পরীক্ষা করার জন্য কমান্ড ব্যবহার করার ব্যাপারে সাহায্য পেতে, tcpdump দেখুন।

    • আপনি যদি মেসেজ প্রসেসরে TCP/IP প্যাকেট নিচ্ছেন, তাহলে tcpdump কমান্ডে ব্যাকএন্ড সার্ভারের পাবলিক IP অ্যাড্রেস ব্যবহার করুন। Message Processor ট্রাফিক পরীক্ষা করার জন্য কমান্ড ব্যবহার করার ব্যাপারে সাহায্য পেতে tcpdump দেখুন।

    • ব্যাকএন্ড সার্ভার/মেসেজ প্রসেসরের জন্য একাধিক IP অ্যাড্রেস থাকলে, আপনাকে অন্য tcpdump কমান্ড ব্যবহার করে দেখতে হবে। এই টুল এবং এই কমান্ডের অন্যান্য ভেরিয়েন্ট সম্পর্কে আরও তথ্যের জন্য tcpdump দেখুন।

  4. Wireshark টুল বা এই ধরনের কোনও টুল ব্যবহার করে TCP/IP প্যাকেট বিশ্লেষণ করুন। নিচের স্ক্রিনশটে Wireshark-এ TCP/IP প্যাকেট দেখানো হয়েছে।

  5. Wireshark আউটপুটে লক্ষ্য করুন যে প্রথম ৩টি প্যাকেটে থ্রি-ওয়ে TCP হ্যান্ডশেক সফলভাবে সম্পূর্ণ হয়েছে।

  6. তারপরে, মেসেজ প্রসেসর প্যাকেট #৪-এ "ক্লায়েন্ট হ্যালো" মেসেজ পাঠায়।

  7. ব্যাকএন্ড সার্ভার থেকে কোনও স্বীকৃতি না পাওয়ার কারণে, Message Processor আগে থেকে নির্ধারিত সময়সীমা অপেক্ষা করার পরে, প্যাকেট ৫, ৬ ও ৭-এ একাধিকবার "Client Hello" মেসেজ আবার ট্রান্সমিট করে।

  8. মেসেজ প্রসেসর ৩ বার আবার চেষ্টা করার পরেও কোনও স্বীকৃতি না পেলে, ব্যাকএন্ড সার্ভারে FIN, ACK মেসেজ পাঠিয়ে দেয় যাতে এটি বোঝানো যায় যে কানেকশন বন্ধ করা হচ্ছে।

  9. আপনি Wireshark সেশনে যেমন দেখিয়েছেন, ব্যাকএন্ডের সাথে কানেকশন সফল হয়েছে (ধাপ #১), তবে SSL হ্যান্ডশেক টাইম-আউট হয়ে গেছে কারণ ব্যাকএন্ড সার্ভার কোনও উত্তর দেয়নি।

আপনি যদি এই প্লেবুকে সমস্যা সমাধানের ধাপগুলি সম্পাদন করে থাকেন এবং এটি নির্ধারণ করেন যে একটি টাইমআউট TLS/SSL হ্যান্ডশেক ত্রুটির কারণ, তাহলে সমাধান বিভাগে যান।

সমস্যা শনাক্ত করতে API মনিটরিং ব্যবহার করা

API মনিটরিং আপনাকে সমস্যাযুক্ত জায়গা আলাদা করে দেখতে সাহায্য করে, যাতে আপনি সমস্যা, পারফর্ম্যান্স ও লেটেন্সি সংক্রান্ত সমস্যা এবং সেগুলির সোর্স ডায়াগনসিস করতে পারেন, যেমন ডেভেলপার অ্যাপ, API প্রক্সি, ব্যাক-এন্ড টার্গেট বা API প্ল্যাটফর্ম।

API মনিটরিং ব্যবহার করে আপনার API-তে 5xx সমস্যা কীভাবে সমাধান করতে হয় তা দেখানোর জন্যএকটি নমুনা পরিস্থিতি দেখুন । যেমন, আপনি এমন একটি সতর্কতা সেট-আপ করতে পারেন যাতে messaging.adaptors.http.BadGateway সংক্রান্ত সমস্যার সংখ্যা একটি নির্দিষ্ট থ্রেশহোল্ড অতিক্রম করলে আপনাকে বিজ্ঞপ্তি পাঠানো হয়।

রেজোলিউশন

সাধারণত, SSL হ্যান্ডশেক টাইমআউট হওয়ার কারণ হল ব্যাকএন্ড সার্ভারে ফায়ারওয়ালের বিধিনিষেধ যা Apigee Edge থেকে ট্রাফিক ব্লক করে। আপনি যদি ডায়াগনস্টিক ধাপগুলি অনুসরণ করে থাকেন এবং হ্যান্ডশেক সংক্রান্ত সমস্যার কারণ যে একটি টাইম-আউট তা নির্ধারণ করে থাকেন, তাহলে আপনাকে কারণ শনাক্ত করতে এবং ফায়ারওয়াল সংক্রান্ত বিধিনিষেধ সমাধান করতে আপনার নেটওয়ার্ক টিমের সাথে যোগাযোগ করতে হবে।

মনে রাখবেন, বিভিন্ন নেটওয়ার্ক লেভেলে ফায়ারওয়াল সংক্রান্ত বিধিনিষেধ আরোপ করা হতে পারে। Apigee Edge ও ব্যাকএন্ড সার্ভারের মধ্যে ট্রাফিক যাতে মসৃণভাবে ফ্লো করতে পারে তা নিশ্চিত করতে, মেসেজ প্রসেসর IP-এর সাথে সম্পর্কিত সমস্ত নেটওয়ার্ক লেয়ারে বিধিনিষেধ সরিয়ে দেওয়া হয়েছে কিনা তা নিশ্চিত করা গুরুত্বপূর্ণ।

ফায়ারওয়াল সংক্রান্ত কোনও বিধিনিষেধ না থাকলে এবং/অথবা সমস্যাটি এখনও বজায় থাকলে, অবশ্যই সংগ্রহ করতে হবে এমন ডায়াগনস্টিক তথ্য বিকল্পে যান।

ডায়াগনস্টিক তথ্য সংগ্রহ করতে হবে

উপরে উল্লেখ করা নির্দেশাবলী অনুসরণ করার পরেও সমস্যার সমাধান না হলে, নিম্নলিখিত ডায়াগনস্টিক তথ্য সংগ্রহ করুন। Apigee Edge সহায়তা টিমের সাথে যোগাযোগ করে তাদের সাথে শেয়ার করুন:

  1. আপনি পাবলিক ক্লাউড ব্যবহারকারী হলে, নিম্নলিখিত তথ্য প্রদান করুন:
    1. সংস্থার নাম
    2. পরিবেশের নাম
    3. API প্রক্সির নাম
    4. সমস্যাটি আবার তৈরি করতে curl কমান্ড সম্পূর্ণ করুন
    5. সমস্যা দেখানো ট্রেস ফাইল
    6. ব্যাকএন্ড সার্ভারে ক্যাপচার করা TCP/IP প্যাকেট
  2. আপনি Private Cloud ব্যবহারকারী হলে, নিম্নলিখিত তথ্য দিন:
    1. সম্পূর্ণ সমস্যার মেসেজ যা দেখা গেছে
    2. API Proxy বান্ডেল
    3. সমস্যা দেখানো ট্রেস ফাইল
    4. Message Processor লগ /opt/apigee/var/log/edge-message-processor/logs/system.log
    5. ব্যাকএন্ড সার্ভার বা মেসেজ প্রসেসরে ক্যাপচার করা TCP/IP প্যাকেট।
  3. এই প্লেবুকের কোন কোন বিভাগ আপনি চেষ্টা করেছেন এবং অন্য কোনও ইনসাইট যা এই সমস্যার সমাধান দ্রুত করতে আমাদের সাহায্য করবে সেই সম্পর্কিত বিবরণ।