503 পরিষেবা উপলভ্য নেই - ব্যাকএন্ড সার্ভার

ট্রেস টুল

1. ট্রেস সেশন চালু করুন, এবং সমস্যাটি আবার তৈরি করতে API কল করুন - 503 পরিষেবা উপলভ্য নেই।
2. কাজ না করা অনুরোধগুলির মধ্যে একটি বেছে নিন এবং ট্রেস পরীক্ষা করুন।
3. ট্রেসের বিভিন্ন ফেজ নেভিগেট করুন এবং কোথায় সমস্যা হয়েছে তা খুঁজে বের করুন।
4. আপনি যদি দেখেন যে টার্গেট সার্ভার থেকে উত্তর হিসেবে 503 সমস্যা ফেরত এসেছে, তাহলে 503 সমস্যার কারণ হল টার্গেট সার্ভার।

   এখানে একটি স্যাম্পেল ট্রেস স্ক্রিনশট দেওয়া হল যেখানে টার্গেট সার্ভার থেকে পাওয়া 503 Service Unavailable উত্তর দেখানো হয়েছে:

   
5. টার্গেট সার্ভার থেকে পাওয়া উত্তর ফেজে ক্লিক করুন এবং উত্তর শীর্ষক ও উত্তর কন্টেন্ট বিভাগগুলি দেখুন যে সেগুলিতে কোনও সহায়ক তথ্য আছে কিনা:
   • উত্তরের হেডারে সার্ভার হেডার থাকতে পারে, যা থেকে বোঝা যায় সমস্যা সংক্রান্ত উত্তরটি কোথা থেকে পাঠানো হয়েছে।
   • টার্গেট সার্ভার কেন 503 রেসপন্স কোড পাঠিয়েছে সেই সম্পর্কে উত্তরের কন্টেন্টে অতিরিক্ত তথ্য থাকতে পারে।
   
6. নিচে দেওয়া ধাপগুলি অনুসরণ করে ট্রেসে AX (Analytics ডেটা রেকর্ড করা) ফেজে X-Apigee-fault-source এবং X-Apigee-fault-code-এর ভ্যালু চেক করে নিশ্চিত করুন যে টার্গেট সার্ভার থেকেই ৫০৩ সমস্যাটি আসছে:
   1. নিচের স্ক্রিনশটে দেখানো AX (Analytics ডেটা রেকর্ড করা হয়েছে) ফেজে ক্লিক করুন:
   2. ফেজ বিবরণ থেকে স্ক্রল করে রেসপন্স হেডার বিভাগে যান এবং নিচে দেখানো X-Apigee-fault-code ও X-Apigee-fault-source-এর ভ্যালু নির্ধারণ করুন:
   3. X-Apigee-fault-source এবং X-Apigee-fault-code-এর ভ্যালু নিচের টেবিলে দেখানো ভ্যালুর সাথে ম্যাচ করলে, আপনি কনফার্ম করতে পারবেন যে 503 সমস্যাটি টার্গেট সার্ভার থেকে আসছে:

      রেসপন্স হেডার	মান
      X-Apigee-fault-source	target
      X-Apigee-fault-code	messaging.adaptors.http.flow.ErrorResponseCode

7. আপনি প্রক্সি চেইনিং ব্যবহার করছেন কিনা তা চেক করুন, অর্থাৎ টার্গেট সার্ভার/টার্গেট এন্ডপয়েন্ট Apigee-তে অন্য কোনও প্রক্সি ইনভোক করছে কিনা। এটি নির্ধারণ করতে:
   1. টার্গেট সার্ভারে পাঠানো অনুরোধ ধাপে ফিরে যান এবং Curl দেখুন বোতামে ক্লিক করে টার্গেট সার্ভার হোস্টের ছদ্মনাম নির্ধারণ করুন।
   2. টার্গেট সার্ভার হোস্ট অ্যালিয়াস যদি ভার্চুয়াল হোস্ট অ্যালিয়াসের দিকে পয়েন্ট করে, তাহলে এটি প্রক্সি চেইনিং। এই ক্ষেত্রে, 503 পরিষেবা উপলভ্য নয় সংক্রান্ত সমস্যার আসল কারণ না বোঝা পর্যন্ত আপনাকে চেইন করা প্রক্সির জন্য উপরের সব ধাপ রিপিট করতে হবে। এইসব ক্ষেত্রে, অন্যান্য ধাপেও অন্যান্য চেইন করা প্রক্সিতে 503 পরিষেবা উপলভ্য নেই সমস্যা হতে পারে, যা এই প্লেবুক ব্যবহার করে ডায়াগনসিস করা যেতে পারে।
   3. টার্গেট সার্ভার হোস্টের ছদ্মনাম আপনার ব্যাকএন্ড সার্ভারের দিকে পয়েন্ট করলে, সমাধান বিভাগে যান।

NGINX অ্যাক্সেস লগ

এছাড়াও, ব্যাকএন্ড সার্ভার 503 স্ট্যাটাস কোড পাঠিয়েছে কিনা তা নির্ধারণ করতে আপনি NGINX অ্যাক্সেস লগ দেখতে পারেন। অতীতে সমস্যা হয়ে থাকলে অথবা সমস্যাটি মাঝে মাঝে হলে এবং আপনি UI-তে ট্রেস ক্যাপচার করতে না পারলে এটি বিশেষভাবে উপযোগী। NGINX অ্যাক্সেস লগ থেকে এই তথ্য নির্ধারণ করতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:

1. NGINX অ্যাক্সেস লগ চেক করুন।

   /opt/apigee/var/log/edge-router/nginx/<org>~<env>.<port#>_access_log

2. নির্দিষ্ট সময়সীমার মধ্যে নির্দিষ্ট API প্রক্সির জন্য কোনও 503 সমস্যা সার্চ করুন (যদি সমস্যাটি আগে ঘটে থাকে) অথবা এখনও 503 সমস্যার কারণে ব্যর্থ হওয়া কোনও অনুরোধের জন্য সার্চ করুন।
3. 503 সমস্যা হলে, ব্যাকএন্ড সার্ভার থেকে সমস্যা হচ্ছে কিনা তা চেক করুন। X-Apigee-fault-source এবং X-Apigee-fault-code-এর ভ্যালু যদি নিচে দেওয়া টেবিলে দেখানো ভ্যালুর সাথে ম্যাচ করে, তাহলে বুঝতে হবে 503 সমস্যাটি ব্যাকএন্ড সার্ভার থেকে আসছে:

   রেসপন্স হেডার	মান
   X-Apigee-fault-source	target
   X-Apigee-fault-code	messaging.adaptors.http.flow.ErrorResponseCode

   টার্গেট সার্ভারের কারণে হওয়া 503 সমস্যার একটি নমুনা এন্ট্রি এখানে দেওয়া হল:

   
4. নির্দিষ্ট API প্রক্সি পর্যালোচনা করুন এবং নিশ্চিত করুন যে আপনি প্রক্সি চেইনিং ব্যবহার করছেন, অর্থাৎ যদি টার্গেট সার্ভার/টার্গেট এন্ডপয়েন্ট Apigee-তে অন্য কোনও প্রক্সি ইনভোক না করে। আপনি যদি প্রক্সি চেইনিং ব্যবহার করেন, তাহলে চেইন করা প্রক্সির জন্য উপরে উল্লেখ করা সব ধাপ আপনাকে আবার করতে হবে, যতক্ষণ না আপনি নির্ধারণ করতে পারছেন যে আসলে কোন কারণে 503 পরিষেবা উপলভ্য নেই সংক্রান্ত সমস্যা হচ্ছে। এইসব ক্ষেত্রে, 503 Service Unavailable অন্যান্য স্টেজেও অন্যান্য চেইন করা প্রক্সিতে হতে পারে, যা আপনি এই প্লেবুক ব্যবহার করে ডায়াগনসিস করতে পারবেন।
5. আপনি যদি কনফার্ম করেন যে আপনি প্রক্সি চেইনিং ব্যবহার করছেন না এবং 503 সমস্যাটি আপনার ব্যাকএন্ড সার্ভার থেকে আসছে, তাহলে সমাধান বিভাগে যান।

ব্যাকএন্ড সার্ভারে কল করা

আপনি ব্যাকএন্ড সার্ভারে সরাসরি কল করতে পারেন এবং যাচাই করে দেখতে পারেন যে Apigee Edge-এর মাধ্যমে অনুরোধ করার সময় আপনি একই 503 পরিষেবা অনুপলভ্য উত্তর পেয়েছেন।

1. অনুরোধের অংশ হিসেবে ব্যাকএন্ড সার্ভারে পাস করতে হবে এমন সব প্রয়োজনীয় হেডার, কোয়েরি প্যারামিটার ও যেকোনও ক্রেডেনশিয়াল আপনার কাছে আছে কিনা তা নিশ্চিত করুন।
2. ব্যাকএন্ড পরিষেবা সর্বজনীনভাবে অ্যাক্সেস করা গেলে, আপনি curl কমান্ড, Postman বা অন্য কোনও REST ক্লায়েন্ট ব্যবহার করতে এবং সরাসরি ব্যাকএন্ড সার্ভার API ইনভোক করতে পারবেন।
3. ব্যাকএন্ড সার্ভার শুধুমাত্র মেসেজ প্রসেসর থেকে অ্যাক্সেস করা গেলে, আপনি curl কমান্ড, Postman বা অন্য কোনও REST ক্লায়েন্ট ব্যবহার করতে এবং মেসেজ প্রসেসর থেকে সরাসরি ব্যাকএন্ড সার্ভার API ইনভোক করতে পারবেন।
4. ব্যাকএন্ড পরিষেবা থেকে সত্যিই 503 পরিষেবা উপলভ্য নেই সংক্রান্ত সমস্যা দেখানো হচ্ছে কিনা তা যাচাই করুন।