503 পরিষেবা অনুপলব্ধ - ব্যাকএন্ড সার্ভার

ট্রেস টুল

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

   এখানে একটি নমুনা ট্রেস স্ক্রিনশট দেওয়া হলো, যেখানে টার্গেট সার্ভার থেকে প্রাপ্ত 503 সার্ভিস আনঅ্যাভেইলেবল রেসপন্সটি দেখানো হয়েছে:

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

      প্রতিক্রিয়া হেডার	মূল্য
      এক্স-এপিজি-ফল্ট-সোর্স	লক্ষ্য
      এক্স-এপিজি-ফল্ট-কোড	messaging.adaptors.http.flow.ErrorResponseCode

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

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

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

1. NGINX অ্যাক্সেস লগগুলো পরীক্ষা করুন।

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

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

   প্রতিক্রিয়া হেডার	মূল্য
   এক্স-এপিজি-ফল্ট-সোর্স	লক্ষ্য
   এক্স-এপিজি-ফল্ট-কোড	messaging.adaptors.http.flow.ErrorResponseCode

   টার্গেট সার্ভারের কারণে সৃষ্ট 503 এররটি দেখানো হলো:

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

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

আপনি সরাসরি ব্যাকএন্ড সার্ভারে কল করে যাচাই করতে পারেন যে, Apigee Edge-এর মাধ্যমে অনুরোধটি করার সময় প্রাপ্ত 503 Service Unavailable রেসপন্সটির মতোই একই রেসপন্স পাচ্ছেন কিনা।

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