502 ভুল গেটওয়ে

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

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

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

HTTP স্ট্যাটাস কোড 502-এর অর্থ হল, ক্লায়েন্ট ব্যাকএন্ড সার্ভার থেকে সঠিক উত্তর পাচ্ছে না যা আসলে অনুরোধটি পূরণ করার কথা।

সমস্যার মেসেজ

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

HTTP/1.1 502 Bad Gateway

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

<html>
<head>
<title>Error</title>
<style>
body {
width: 35em;
margin: 0 auto;
font-family: Tahoma, Verdana, Arial, sans-serif;
}
</style>
</head>
<body>
<h1>An error occurred.</h1>
<p>Sorry, the page you are looking for is currently unavailable.<br/>
Please try again later.</p>
</body>
</html>

ব্যাকএন্ড সার্ভার থেকে সমস্যা হলে, আপনি এই ধরনের কিছু দেখতে পেতে পারেন। ব্যাকএন্ড থেকে পাওয়া সমস্যার মেসেজ সম্পূর্ণভাবে এর প্রয়োগের উপর নির্ভর করে।

<html>
<head><title>502 Bad Gateway</title></head>
<body bgcolor="white">
<center><h1>502 Bad Gateway</h1></center>
</body>
</html>

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

Apigee Edge-এর মাধ্যমে যাওয়া API-এর ক্ষেত্রে 502 ভুল গেটওয়ে সমস্যার সম্ভাব্য কারণগুলি এখানে দেওয়া হল:

কারণ বিবরণ সমস্যা সমাধানের নির্দেশাবলী এগুলির জন্য প্রযোজ্য
পুলটিতে কোনও MP উপলভ্য নেই পুল থেকে সব MP উপলভ্য না থাকলে, অর্থাৎ সেগুলি বন্ধ থাকলে বা ব্যস্ত থাকলে এবং সেই কারণে উত্তর না দিলে এই সমস্যা দেখা যায়। Edge Private Cloud ব্যবহারকারী
রাউটার ও MP-র মধ্যে ভুল SSL কনফিগারেশন ক্লায়েন্টের CA সই করা মূল সার্টিফিকেট Edge-এর রাউটারের ট্রাস্টস্টোরে না থাকলে এই সমস্যা দেখা দেয়। Edge Private Cloud ব্যবহারকারী
ব্যাকএন্ড সার্ভারে সমস্যা ব্যাকএন্ড সার্ভার কাজ না করলে এবং এই উত্তর পাঠালে এই সমস্যা দেখা যাবে। Edge পাবলিক ও প্রাইভেট ক্লাউড ব্যবহারকারী

কারণ: পুলে কোনও MP উপলভ্য নেই

রাউটার যদি দেখে যে কোনও নির্দিষ্ট অঞ্চল/ডেটা সেন্টারের সমস্ত মেসেজ প্রসেসর উপলভ্য নেই (যেমন, সেগুলি সব বন্ধ হয়ে গেছে), তাহলে এই সমস্যাটি হবে।

Apigee Edge এমনভাবে কনফিগার করা হয় যে কোনও নির্দিষ্ট অঞ্চল/ডেটা সেন্টারে ইনকামিং API ট্রাফিক (অনুরোধ) সর্বদা একই অঞ্চল/ডেটা সেন্টারে রাউটার থেকে মেসেজ প্রসেসর (MP)-এ রুট করা হয়। কিছু ক্ষেত্রে, Apigee Edge কম্পোনেন্ট শুধুমাত্র একটি অঞ্চল/ডেটা সেন্টারে সেট-আপ করা হতে পারে এবং কিছু ক্ষেত্রে, সেগুলি একাধিক অঞ্চল/ডেটা সেন্টারে সেট-আপ করা হতে পারে। প্রতিটি অঞ্চল/ডেটা সেন্টারে দুই বা তার বেশি রাউটার ও মেসেজ প্রসেসর কনফিগার করা থাকবে।

ডায়াগনসিস

  1. একাধিক অঞ্চল/ডেটা সেন্টার থাকলে, 502 ভুল গেটওয়ে সমস্যার কারণে API অনুরোধ কোন অঞ্চল/ডেটা সেন্টারে ব্যর্থ হচ্ছে তা নির্ধারণ করুন। ব্যবহারকারীরা যে অঞ্চলে 502 সমস্যা দেখতে পাচ্ছেন সেটি শনাক্ত করে অথবা বিভিন্ন অঞ্চলের প্রতিটি রাউটারে /opt/apigee/var/log/edge-router/nginx/ ডিরেক্টরিতে NGINX অ্যাক্সেস লগ চেক করে আপনি এটি খুঁজে পেতে পারেন।
  2. আপনি NGINX সমস্যার লগে (/opt/apigee/var/log/edge-router/nginx/ORG-Env._error_log) নিম্নলিখিত সমস্যা দেখতে পাবেন
    2019/06/24 15:26:00 [error] 4796#4796: *56357443 no live upstreams while connecting to upstream, client: <Router_IP_address>, server: <HostAlias>, request: "PUT <BasePath> HTTP/1.1", upstream: "http://<ListOfMP-IP_R-MP-Port>/<BasePath>", host: "<HostAlias>"

পরিস্থিতি ১: সব মেসেজ প্রসেসর কাজ করছে না

  1. নির্দিষ্ট অঞ্চল/ডেটা সেন্টারে মেসেজ প্রসেসর চালু আছে কিনা তা চেক করুন।
  2. সব মেসেজ প্রসেসর বন্ধ হয়ে গেলে, সেগুলি রিস্টার্ট করুন।

রেজোলিউশন

নিম্নলিখিত কমান্ড ব্যবহার করে সব মেসেজ প্রসেসর রিস্টার্ট করুন:

/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart

পরিস্থিতি ২: সব মেসেজ প্রসেসর চলমান অনুরোধ প্রসেস করতে ব্যস্ত

রাউটার যদি দেখে যে কোনও নির্দিষ্ট অঞ্চল/ডেটা সেন্টারের সমস্ত মেসেজ প্রসেসর উপলভ্য নেই কারণ সেগুলি সবকটিই চলমান অনুরোধ প্রসেস করতে ব্যস্ত, তাহলে এই সমস্যাটি ঘটবে।

  1. নির্দিষ্ট অঞ্চল/ডেটা সেন্টারে মেসেজ প্রসেসর চালু আছে কিনা তা চেক করুন।
  2. সব মেসেজ প্রসেসর চালু ও অ্যাক্টিভ থাকলে, মেসেজ প্রসেসর(গুলি) বেশি সিপিইউ ব্যবহার করছে কিনা তা চেক করুন, তাহলে নিম্নলিখিত কমান্ড ব্যবহার করে প্রতি ৩০ সেকেন্ডে তিনটি থ্রেড ডাম্প তৈরি করুন:
    <JAVA_HOME>/bin/jstack -l <pid> > <filename>
  3. মেসেজ প্রসেসর(গুলি) যদি খুব বেশি মেমরি ব্যবহার করে থাকে, তাহলে নিম্নলিখিত কমান্ড ব্যবহার করে একটি হিপ ডাম্প তৈরি করুন:
    sudo -u apigee /bin/jmap -dump:live,format=b,file= 
  4. নিচের কমান্ড ব্যবহার করে মেসেজ প্রসেসর রিস্টার্ট করুন। এটি সিপিইউ ও মেমরি ব্যবহার কমিয়ে দেবে:
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
  5. সমস্যাটি এখনও আছে কিনা তা নিশ্চিত করতে API কল মনিটর করুন।
  6. Apigee সহায়তা টিমের সাথে যোগাযোগ করুন এবং বেশি CPU/মেমরি ব্যবহারের কারণ তদন্ত করতে থ্রেড ডাম্প, হিপ ডাম্প এবং মেসেজ প্রসেসর লগ (/opt/apigee/var/log/edge-message-processor/logs/system.log) প্রদান করুন।

কারণ: রাউটার ও MP-র মধ্যে ভুল SSL কনফিগারেশন

ডায়াগনসিস

  1. NGINX অ্যাক্সেস লগ (/opt/apigee/var/log/edge-router/nginx/ORG-Env._access_log) চেক করুন। আপনি নিচে দেখানো 502 রেসপন্স দেখতে পাবেন:
        2019-07-23T12:13:42+03:00	sc-10-254-226-23	10.X.X.X:53634	10.X.X.X:8998	0.000	-	-	502	502	189	344	GET <path> curl/7.19.7 (x86_64-redhat-linux-gnu) libcurl/7.19.7 NSS/3.27.1 zlib/1.2.3 libidn/1.18 libssh2/1.4.2	<host alias>	mp-10-254-226-23-23706-8552529-1	10.129.107.101	-	-	-1	-	-	dc-2	gateway-2	green	-	gateway-2	dc-2	op	pilot	http	-
  2. NGINX সমস্যার লগ (/opt/apigee/var/log/edge-router/nginx/ORG-Env._error_log) চেক করুন। আপনি এই ধরনের সমস্যা দেখতে পাবেন:
    	2019/07/30 17:02:24 [error] 7691#7691: *11753633 peer closed connection in SSL handshake while SSL handshaking to upstream, client: X.X.X.X, server: <HostAlias>, request: "GET /no-target HTTP/1.1", upstream: "https://X.X.X.X:8998/no-target", host: "<HostAlias>"
  3. এটি রাউটার ও মেসেজ প্রসেসরের মধ্যে SSL হ্যান্ডশেক ব্যর্থ হয়েছে বলে দেখায়।
  4. আপনি যদি #১ এবং #২ ধাপে সমস্যার মেসেজটি ভালভাবে লক্ষ্য করেন, তাহলে দেখতে পাবেন যে মেসেজ প্রসেসরের সাথে যোগাযোগ করার জন্য ব্যবহৃত পোর্ট # হল ৮৯৯৮, এটি একটি সুরক্ষিত পোর্ট নয়, তবে প্রোটোকলটি হল SSL (https)। সাধারণত, সুরক্ষিত পোর্ট # হিসেবে ৮৪৪৩ ব্যবহার করা হয়। সুরক্ষিত যোগাযোগের জন্য যেহেতু সুরক্ষিত নয় এমন পোর্ট ব্যবহার করা হয়, তাই এটি SSL হ্যান্ডশেক ব্যর্থতার কারণ হয়।
  5. রাউটার ও মেসেজ প্রসেসরের মধ্যে SSL কনফিগার করার সময় কোনও ধাপ বাদ দিলে বা ভুল মান সেট করলে সাধারণত এটি হতে পারে। এখানে উল্লেখ করা ধাপগুলি দেখুন।
    যেমন, এই সমস্যাটি হতে পারে যদি
    1. /opt/apigee/customer/application/message-processor.properties as shown below
      -এ পোর্ট # ৮৪৪৩-এর পরিবর্তে ৮৯৯৮ হিসেবে উল্লেখ করা হয়েছে
              conf/message-processor-communication.properties+local.http.port=8998
    2. SSL কনফিগারেশন করার সময় /opt/nginx/conf.d/* ডিরেক্টরির অধীনে থাকা রাউটার কনফিগারেশন ফাইল মুছে ফেলা হয়নি এবং রাউটার রিস্টার্ট করা হয়নি। এই পরিস্থিতিতে, আপনি লক্ষ্য করতে পারবেন যে কনফিগারেশন ফাইলে মেসেজ প্রসেসরের পোর্ট# ৮৯৯৮ হিসেবেই থেকে যাবে।

রেজোলিউশন

  1. রাউটার ও মেসেজ প্রসেসরের মধ্যে TLS কনফিগার করা লিঙ্কে দেওয়া সব ধাপ সঠিকভাবে অনুসরণ করা হয়েছে কিনা তা নিশ্চিত করুন।
  2. সমস্যার সমাধান না হলে, ডায়াগনস্টিক তথ্য সংগ্রহ করুন বিকল্পে যান।

কারণ: ব্যাকএন্ড সার্ভারে সমস্যা

ডায়াগনসিস

  1. প্রতিবার সমস্যা হলে, ব্যর্থ অনুরোধের জন্য UI ট্রেস ক্যাপচার করতে পারবেন। কাজ না করা অনুরোধ বেছে নিন এবং ট্রেসে বিভিন্ন ফেজ নেভিগেট করুন। আপনি যদি লক্ষ্য করেন যে ব্যাকএন্ড সার্ভার থেকে "502 Bad Gateway" মেসেজ পাচ্ছেন, তাহলে ব্যাকএন্ড সার্ভারে কোনও সমস্যার কারণে এটি হতে পারে।
    ব্যাকএন্ড সার্ভার থেকে 502 ভুল গেটওয়ে আসছে বলে ট্রেস দেখাচ্ছে
  2. সমস্যাটি মাঝে মাঝে হলে এবং আপনি ট্রেস ক্যাপচার করতে না পারলে,
    1. আপনি পাবলিক ক্লাউড ব্যবহারকারী হলে, API মনিটরিং ব্যবহার করতে পারেন এবং 502 সমস্যার বিবরণ চেক করতে পারেন।
      1. আপনি যদি দেখেন যে সমস্যার কোড messaging.adaptors.http.flow.ErrorResponseCode এবং সমস্যার সোর্স target, তাহলে বুঝতে হবে যে ব্যাকএন্ড সার্ভারের কারণে সমস্যা হয়েছে।
    2. আপনি প্রাইভেট ক্লাউড ব্যবহারকারী হলে, NGINX অ্যাক্সেস লগ বিশ্লেষণ করতে পারবেন
      /opt/apigee/var/log/edge-router/nginx/ORG-Env._access_log.
      আপনি ব্যর্থ অনুরোধের এন্ট্রি নিম্নলিখিতভাবে দেখতে পাবেন:
      2017-02-24T14:42:12+00:00	rt-01	192.8.155.2:18118	192.168.84.166:8998	10.225	-	-	502	502	440	0	GET /adv-eadlg-test/documents?type=doctype HTTP/1.1	rt-02efawae234-1234	Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/56.0.2924.87 Safari/537.36	myorg-dev.apigee.net	 rt-02efawae234-1234	6	-	false	target	messaging.adaptors.http.flow.ErrorResponseCode	null/null	-	/organizations/myorg/environments/dev/apiproxies/api123
      1. আপনি যদি দেখেন যে সমস্যার কোড messaging.adaptors.http.flow.ErrorResponseCode এবং সমস্যার সোর্স target, তাহলে বুঝতে হবে যে ব্যাকএন্ড সার্ভারের কারণে সমস্যা হয়েছে।

রেজোলিউশন

  1. ব্যাক-এন্ডে এই সমস্যার সমাধান করতে আপনার ব্যাক-এন্ড সার্ভার টিমের সাথে কাজ করুন।

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

  1. NGINX অ্যাক্সেস লগ
    (/opt/apigee/var/log/edge-router/nginx/ORG-Env._access_log)
    এবং সমস্যার লগ
    (/opt/apigee/var/log/edge-router/nginx/ORG-Env._error_log)।
  2. মেসেজ প্রসেসর লগ
    (/opt/apigee/var/log/edge-message-processor/logs/system.log)।