503 পরিষেবা অনুপলব্ধ৷

আপনি Apigee Edge-এর ডকুমেন্টেশন দেখছেন।
Apigee X ডকুমেন্টেশন .info- তে যান।

ভিডিও

503 ত্রুটি সম্পর্কে আরও তথ্যের জন্য নিম্নলিখিত ভিডিওগুলি দেখুন:

লক্ষণ

একটি এপিআই প্রক্সি কলের পর ক্লায়েন্ট অ্যাপ্লিকেশনটি 'Service Unavailable' বার্তা সহ একটি HTTP প্রতিক্রিয়া স্ট্যাটাস 503 পায়।

ত্রুটির বার্তা

আপনি নিম্নলিখিত ত্রুটি বার্তাটি দেখতে পাবেন:

HTTP/1.1 503 Service Unavailable
      

আপনি HTTP রেসপন্সে নিম্নলিখিত এরর মেসেজটিও দেখতে পারেন:

পরিষেবা অনুপলব্ধ

{
   "fault": {
      "faultstring": "The Service is temporarily unavailable",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.ServiceUnavailable"
       }
    }
}
      

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

ব্যাকএন্ড সার্ভারের সাথে যোগাযোগের সময় কানেকশন টাইম আউট, ভুল হোস্ট নেম, বা SSL হ্যান্ডশেক ব্যর্থতার কারণে Apigee Edge-এর মেসেজ প্রসেসরে কোনো ত্রুটি দেখা দিলে, messaging.adaptors.http.flow.ServiceUnavailable এরর কোড সহ HTTP রেসপন্স 503 Service Unavailable প্রদর্শিত হয়।

503 সার্ভিস আনঅ্যাভেইলেবল রেসপন্সটির সম্ভাব্য কারণগুলো হলো:

সাধারণ রোগ নির্ণয়ের পদক্ষেপ

ব্যর্থ অনুরোধটির মেসেজ আইডি নির্ধারণ করুন।

ভুল ডিএনএস রেজোলিউশনের কারণে সংযোগ ত্রুটি

রোগ নির্ণয়

1. ব্যর্থ হওয়া অনুরোধটির মেসেজ আইডি নির্ণয় করুন।
2. মেসেজ প্রসেসর লগে ( /opt/apigee/var/log/edge-message-processor/logs/system.log ) নির্দিষ্ট অনুরোধ বার্তা আইডিটি অনুসন্ধান করুন। আপনি নিম্নলিখিত ত্রুটিগুলি দেখতে পারেন:
   
   একটি onConnectTimeout ত্রুটি নির্দেশ করে যে মেসেজ প্রসেসর পূর্বনির্ধারিত সংযোগ সময়সীমার (ডিফল্ট: ৩ সেকেন্ড) মধ্যে ব্যাকএন্ড সার্ভারের সাথে সংযোগ স্থাপন করতে পারেনি।

   2019-08-14 09:11:49,314 org:myorg env:prod api:Employees rev:1 messageid:mo-96cf6757a-9401-21-1 NIOThread@0 ERROR HTTP.CLIENT - HTTPClient$Context.onTimeout() : ClientChannel[Connected:]@164162 useCount=1 bytesRead=0 bytesWritten=0 age=3001ms lastIO=3001ms .onConnectTimeout connectAddress=www.abc.com/11.11.11.11  resolvedAddress=www.abc.com/22.22.22.22
   
   2019-08-14 09:11:49,333 org:myorg env:prod api:Employees rev:1 messageid:mo-96cf6757a-9401-21-1 NIOThread@0 ERROR ADAPTORS.HTTP.FLOW - RequestWriteListener.onTimeout() : RequestWriteListener.onTimeout(HTTPRequest@6b393600)
         

3. onConnectTimeout ত্রুটিতে প্রাপ্ত আইপি ঠিকানাটি নোট করুন এবং যাচাই করুন যে আইপি ঠিকানাটি আপনার ব্যাকএন্ড সার্ভারের জন্য বৈধ কিনা। যদি আইপি ঠিকানাটি বৈধ হয়, তাহলে Connection Errors- এ যান।
4. যদি আইপি অ্যাড্রেসটি অবৈধ হয়, তাহলে এর প্রধান কারণ হতে পারে ডিএনএস রেজোলিউশন সংক্রান্ত সমস্যা।
5. আরও কয়েকটি ব্যর্থ API অনুরোধের জন্য ধাপ ৩ এবং ধাপ ৪ পুনরাবৃত্তি করুন এবং যাচাই করুন যে আপনি একই বা অন্য কোনো অবৈধ IP ঠিকানা দেখতে পাচ্ছেন কিনা।
6. মেসেজ প্রসেসর লগ ( /opt/apigee/var/log/edge-message-processor/logs/system.log ) -এ 'DNS Refresh' কীওয়ার্ডযুক্ত মেসেজগুলো খুঁজুন। মাঝে মাঝে মেসেজ প্রসেসরের ডিএনএস ক্যাশে কোনো ভুল বা অবৈধ আইপি অ্যাড্রেস যুক্ত হচ্ছে কি না, তা পরীক্ষা করুন।

   2019-08-14 09:11:49,314 org:myorg env:prod api:Employees rev:1 messageid:mo-96cf6757a-9401-21-1 NIOThread@0 INFO c.a.p.h.d.DNSCachedAddress - DNSCachedAddress.reportDifferences() : DNS Refresh for host: apitarget-uat.schemeweb.co.uk:4436. Added 2 IPs [www.abc.com/22.22.22.22, www.abc.com/33.33.33.33] Removed 1 IPs [www.abc.com/11.11.11.11]
         

7. /etc/resolv.conf এ কনফিগার করা অথরিটেটিভ ডিএনএস সার্ভার বা নেম সার্ভারগুলোতে কোনো সমস্যা থাকলে এই সমস্যাটি হতে পারে।
   
   সাধারণত, ডিএনএস রেজোলিউশন সম্পাদনের জন্য এক বা একাধিক কর্তৃত্বপূর্ণ ডিএনএস সার্ভার কনফিগার করা থাকতে পারে। যদি কোনো কর্তৃত্বপূর্ণ ডিএনএস সার্ভার না থাকে, তাহলে এটি /etc/resolv.conf এ সেট করা কনফিগারেশনে ফিরে যাবে এবং যথাযথভাবে ডিএনএস রেজোলিউশন সম্পাদন করবে। উদাহরণস্বরূপ: যদি /etc/resolv.conf নির্দিষ্ট নেম সার্ভার ব্যবহার করার জন্য কনফিগার করা থাকে, তাহলে ডিএনএস রেজোলিউশন সম্পাদনের জন্য সেই নেম সার্ভারগুলোই ব্যবহৃত হবে।
8. যদি /etc/resolv.conf এ উল্লেখিত কর্তৃত্বপূর্ণ DNS সার্ভার বা নেম সার্ভারগুলিতে কোনো সমস্যা থাকে, তাহলে ব্যাকএন্ড সার্ভারের হোস্টনেমগুলি ভুল/অবৈধ IP অ্যাড্রেসে রিজলভ হয়ে যাবে। এরপর এই ভুল/অবৈধ IP অ্যাড্রেসগুলি মেসেজ প্রসেসরের DNS ক্যাশে সংরক্ষিত হবে।
   1. যদি /etc/resolv.conf এ উল্লেখিত অথরিটেটিভ ডিএনএস সার্ভার বা নেম সার্ভারগুলির সমস্যাটি ক্রমাগত হতে থাকে, তাহলে ত্রুটিপূর্ণ/অবৈধ আইপি অ্যাড্রেসগুলি মেসেজ প্রসেসরের ডিএনএস ক্যাশে থেকে যাবে। যতক্ষণ পর্যন্ত এই ত্রুটিপূর্ণ আইপি অ্যাড্রেসগুলি মেসেজ প্রসেসরের ডিএনএস ক্যাশে সংরক্ষিত থাকবে, ততক্ষণ পর্যন্ত নির্দিষ্ট ব্যাকএন্ড সার্ভার ব্যবহারকারী সমস্ত এপিআই-এর অনুরোধগুলি 503 এরর দেখিয়ে ব্যর্থ হবে।
   2. যদি /etc/resolv.conf এ উল্লেখিত কর্তৃত্বপূর্ণ DNS সার্ভার বা নেম সার্ভার নিয়ে সমস্যাটি মাঝে মাঝে হয়, তাহলে DNS ক্যাশে ভালো এবং খারাপ IP অ্যাড্রেসগুলো মাঝে মাঝে জমা হতে থাকবে। এই ক্ষেত্রে, আপনি নির্দিষ্ট ব্যাকএন্ড সার্ভারটি ব্যবহারকারী সমস্ত API-এর জন্য মাঝে মাঝে 503 এরর দেখতে পাবেন।
9. যদি ডিএনএস সার্ভারের সমস্যাটি দীর্ঘস্থায়ী হয়, তাহলে আপনি ক্রমাগত ব্যর্থতা দেখতে পাবেন। যদি ডিএনএস সার্ভারের সমস্যাটি মাঝে মাঝে হয়, তাহলে আপনি মাঝে মাঝে ব্যর্থতা দেখতে পাবেন। অর্থাৎ, যখনই ব্যাকএন্ড সার্ভারের হোস্টনেম ভুল আইপি অ্যাড্রেসে রিজলভ হয়, তখনই আপনি ৫০৩ এরর দেখতে পাবেন। আর যখন ব্যাকএন্ড সার্ভারের হোস্টনেমগুলো সঠিক আইপি অ্যাড্রেসে রিজলভ হয়, তখন আপনি সফল রেসপন্স দেখতে পাবেন।

সমাধান

অনুগ্রহ করে আপনার অপারেটিং সিস্টেম অ্যাডমিনিস্ট্রেটরের সাথে কাজ করে ডিএনএস সার্ভারগুলোর সমস্যাগুলো সমাধান করুন।

1. যদি আপনার /etc/resolv.conf এ উল্লেখিত অথরিটেটিভ ডিএনএস সার্ভার বা নেম সার্ভার নিয়ে কোনো সমস্যা থাকে, তাহলে এই সমস্যাটির সমাধান করতে উপযুক্ত সার্ভারটি ঠিক করুন।
2. যেসব সিস্টেমে মেসেজ প্রসেসর আছে, সেগুলোর /etc/resolv.conf ফাইলের কনফিগারেশনে কোনো সমস্যা থাকলে, সেই সমস্যাটি সমাধান করুন।

সংযোগ ত্রুটি

যখন একটি Apigee Edge Message Processor কোনো ব্যাকএন্ড সার্ভারের সাথে সংযোগ করার চেষ্টা করে এবং নিম্নলিখিত সমস্যাগুলির মধ্যে একটি ঘটে, তখন একটি সংযোগ ত্রুটি দেখা দেয়:

• মেসেজ প্রসেসর পূর্বনির্ধারিত সংযোগ সময়সীমার মধ্যে সংযোগ স্থাপন করতে পারছে না। (ডিফল্ট: ৩ সেকেন্ড)
• ব্যাকএন্ড সার্ভার সংযোগটি প্রত্যাখ্যান করছে।

রোগ নির্ণয়

1. ব্যর্থ হওয়া অনুরোধটির মেসেজ আইডি নির্ণয় করুন।
2. মেসেজ প্রসেসর লগে ( /opt/apigee/var/log/edge-message-processor/logs/system.log ) নির্দিষ্ট অনুরোধ বার্তা আইডিটি অনুসন্ধান করুন। আপনি নিম্নলিখিত ত্রুটিগুলি দেখতে পারেন:
   1. একটি onConnectTimeout ত্রুটি নির্দেশ করে যে মেসেজ প্রসেসর পূর্বনির্ধারিত সংযোগ সময়সীমার মধ্যে ব্যাকএন্ড সার্ভারের সাথে সংযোগ স্থাপন করতে পারেনি।

      2016-06-23 09:11:49,314 org:myorg env:prod api:Employees rev:1 messageid:mo-96cf6757a-9401-21-1 NIOThread@2 ERROR HTTP.CLIENT - HTTPClient$Context.onTimeout() : ClientChannel[C:]@10 useCount=1 bytesRead=0 bytesWritten=0 age=3001ms lastIO=3001ms .onConnectTimeout connectAddress=www.abc.com/11.11.11.11:80 resolvedAddress=www.abc.com/11.11.11.11
      2016-06-23 09:11:49,333 org:myorg env:prod api:Employees rev:1 messageid:mo-96cf6757a-9401-21-1 NIOThread@2 ERROR ADAPTORS.HTTP.FLOW - RequestWriteListener.onTimeout() : RequestWriteListener.onTimeout(HTTPRequest@6b393600)

   2. একটি java.net.ConnectException: Connection refused ত্রুটি নির্দেশ করে যে ব্যাকএন্ড সার্ভার সংযোগটি প্রত্যাখ্যান করেছে।

      14:40:16.531 +0530
      2016-06-17 09:10:16,531 org:myorg env:prod api:www.abc.com rev:1 rrt07eadn-22739-40983870-15 NIOThread@2 ERROR HTTP.CLIENT - HTTPClient$Context.onConnectFailure() : connect to www.abc.com:11.11.11.11:443 failed with exception {}
      java.net.ConnectException: Connection refused
      at sun.nio.ch.SocketChannelImpl.checkConnect(Native Method) ~[na:1.7.0_75]
      at sun.nio.ch.SocketChannelImpl.finishConnect(SocketChannelImpl.java:739) ~[na:1.7.0_75]
      at com.apigee.nio.ClientChannel.finishConnect(ClientChannel.java:121) ~[nio-1.0.0.jar:na]
      at com.apigee.nio.handlers.NIOThread.run(NIOThread.java:108) ~[nio-1.0.0.jar:na]

3. প্রতিটি মেসেজ প্রসেসর থেকে telnet কমান্ড ব্যবহার করে সরাসরি নির্দিষ্ট ব্যাকএন্ড সার্ভারে সংযোগ করতে পারছেন কিনা তা পরীক্ষা করুন:
   1. যদি ব্যাকএন্ড সার্ভারটি একটিমাত্র আইপি অ্যাড্রেসে রিজলভ হয়, তাহলে নিম্নলিখিত কমান্ডটি ব্যবহার করুন:

      telnet BackendServer-IPaddress 443
                

   2. যদি ব্যাকএন্ড সার্ভারটি একাধিক আইপি অ্যাড্রেসে রিজলভ হয়, তাহলে নিচে দেখানো অনুযায়ী telnet কমান্ডে ব্যাকএন্ড সার্ভারের হোস্টনেম ব্যবহার করুন:

      telnet BackendServer-HostName 443
                

4. আপনি যদি ব্যাকএন্ড সার্ভারে সংযোগ করতে পারেন, তাহলে আপনি Connected to backend-server মতো একটি বার্তা দেখতে পারেন। আপনি যদি ব্যাকএন্ড সার্ভারে সংযোগ করতে না পারেন, তবে এর কারণ হতে পারে যে নির্দিষ্ট ব্যাকএন্ড সার্ভারে মেসেজ প্রসেসরগুলোর আইপি অ্যাড্রেস অনুমোদিত তালিকায় (allowlisted) নেই।

সমাধান

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

যদি সমস্যাটি অব্যাহত থাকে, তবে সমস্যাটি চিহ্নিত ও সমাধান করার জন্য আপনার নেটওয়ার্ক অ্যাডমিনিস্ট্রেটরের সাথে কাজ করুন। Apigee-এর কাছ থেকে আপনার আরও কোনো সহায়তার প্রয়োজন হলে, Apigee Support-এর সাথে যোগাযোগ করুন।

ভুল টার্গেট সার্ভার হোস্ট নাম

রোগ নির্ণয়

টার্গেট সার্ভারে নির্দিষ্ট করা হোস্ট নেম ভুল হলে, আপনি messaging.adaptors.http.flow.ServiceUnavailable. এরর কোড সহ 503 Service Unavailable রেসপন্স পেতে পারেন।

সমাধান

1. নিশ্চিত করুন যে টার্গেট এন্ডপয়েন্ট কনফিগারেশনে বা টার্গেট সার্ভার ডেফিনিশনে উল্লেখিত টার্গেট সার্ভার হোস্টনেমটি সঠিক এবং এতে কোনো অনাকাঙ্ক্ষিত স্পেস বা বিশেষ অক্ষর নেই।
2. যদি আপনি টার্গেট সার্ভার হোস্টনেম ডাইনামিকভাবে তৈরি করার জন্য কোনো AssignMessage/JavaScript পলিসি ব্যবহার করেন, তাহলে পলিসির সংজ্ঞা এবং কোডটি খতিয়ে দেখুন এবং নিশ্চিত করুন যে টার্গেট সার্ভার হোস্টনেমটি সঠিকভাবে তৈরি হচ্ছে।

SSL হ্যান্ডশেক ব্যর্থতা

TLS/SSL হ্যান্ডশেক ত্রুটি সমাধানের জন্য একটি সম্পূর্ণ ট্রাবলশুটিং প্লেবুক রয়েছে। SSL হ্যান্ডশেক ব্যর্থতা দেখুন।

সমস্যার উৎস নির্ধারণ করা

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

উত্তরমুখী এবং দক্ষিণমুখী সংযোগগুলি বোঝা

Edge ব্রাউজারে, ইনকামিং বা আউটগোয়িং উভয় কানেকশনেই আপনি 503 Service Unavailable এরর-এর সম্মুখীন হতে পারেন:

• ইনকামিং (বা নর্থবাউন্ড) কানেকশন - ক্লায়েন্ট অ্যাপ্লিকেশন এবং এজ রাউটারের মধ্যকার সংযোগ। রাউটার হলো Apigee Edge-এর সেই অংশ যা সিস্টেমে আসা ইনকামিং রিকোয়েস্টগুলো পরিচালনা করে।
• বহির্গামী (বা দক্ষিণমুখী) সংযোগ - এজ মেসেজ প্রসেসর এবং ব্যাকএন্ড সার্ভারের মধ্যকার সংযোগ। মেসেজ প্রসেসর হলো Apigee Edge-এর একটি উপাদান যা API অনুরোধগুলোকে ব্যাকএন্ড টার্গেট সার্ভারগুলোতে প্রক্সি করে।

আপনি যদি একজন এজ পাবলিক ক্লাউড ব্যবহারকারী হন, তাহলে আপনি সম্ভবত রাউটার বা মেসেজ প্রসেসরের মতো অভ্যন্তরীণ উপাদানগুলো সম্পর্কে অবগত নন। এই অভ্যন্তরীণ উপাদানগুলো পাবলিক ক্লাউড ব্যবহারকারীদের কাছে দৃশ্যমান বা প্রবেশযোগ্য নয়। যেখানে সম্ভব, আমরা সমস্যাটি খতিয়ে দেখার জন্য এমন বিকল্প উপায় সরবরাহ করি, যার জন্য এই উপাদানগুলোতে সরাসরি প্রবেশের প্রয়োজন হয় না।

নিম্নোক্ত চিত্রে Apigee Edge-এর উত্তরমুখী ও দক্ষিণমুখী সংযোগগুলো দেখানো হয়েছে।

503 সার্ভিস আনঅ্যাভেইলেবল ত্রুটিটি কোথায় ঘটেছে তা নির্ধারণ করা

503 সার্ভিস আনঅ্যাভেইলেবল ত্রুটিটি উত্তরমুখী নাকি দক্ষিণমুখী সংযোগস্থলে ঘটেছে তা নির্ধারণ করতে নিম্নলিখিত পদ্ধতিগুলোর মধ্যে একটি ব্যবহার করুন।