503 পরিষেবা উপলভ্য নেই

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

ভিডিও

503 সমস্যার ব্যাপারে আরও তথ্য পেতে, নিম্নলিখিত ভিডিও দেখুন:

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

API প্রক্সি কলের পরে ক্লায়েন্ট অ্যাপ্লিকেশন পরিষেবা উপলভ্য নেই মেসেজ সহ 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 পরিষেবা উপলভ্য নেই দেখা যায়।

503 পরিষেবা উপলভ্য নেই উত্তরের সম্ভাব্য কারণগুলি হল:

সাধারণ ডায়াগনসিস ধাপ

অনুরোধটি কেন সম্পূর্ণ করা যায়নি তা মেসেজ আইডি থেকে বোঝা

ভুল DNS রেজোলিউশনের কারণে কানেকশন সংক্রান্ত সমস্যা

ডায়াগনসিস

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

   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 ত্রুটিতে সমাধান করা IP অ্যাড্রেসটি নোট করুন এবং IP অ্যাড্রেসটি আপনার ব্যাকএন্ড সার্ভারের জন্য বৈধ কিনা তা চেক করুন। IP অ্যাড্রেস সঠিক হলে, কানেকশন সংক্রান্ত সমস্যা লিঙ্কে যান।
4. IP অ্যাড্রেসটি ভুল হলে, DNS রেজোলিউশন সংক্রান্ত সমস্যার কারণে এটি হতে পারে।
5. আরও কয়েকটি এপিআই অনুরোধ ব্যর্থ হলে ৩ ও ৪ নম্বর ধাপ আবার অনুসরণ করুন এবং আপনি একই বা অন্য কোনও অবৈধ IP অ্যাড্রেস দেখতে পাচ্ছেন কিনা তা যাচাই করুন।
6. Message Processor লগ (/opt/apigee/var/log/edge-message-processor/logs/system.log)-এ DNS Refresh কীওয়ার্ড সহ মেসেজ সার্চ করুন। মাঝে মাঝে মেসেজ প্রসেসরের DNS ক্যাশে ভুল বা অবৈধ IP অ্যাড্রেস যোগ করা হচ্ছে কিনা তা চেক করুন।

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

রেজোলিউশন

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

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

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

Apigee Edge মেসেজ প্রসেসর কোনও ব্যাকএন্ড সার্ভারের সাথে কানেক্ট করার চেষ্টা করলে এবং এইসব সমস্যার মধ্যে কোনও একটি হলে কানেকশন সংক্রান্ত সমস্যা হয়:

• প্রিসেট করা কানেকশন টাইম-আউট পিরিয়ডের মধ্যে মেসেজ প্রসেসর কানেক্ট করতে পারছে না। (ডিফল্ট: ৩ সেকেন্ড)
• ব্যাকএন্ড সার্ভার কানেকশন প্রত্যাখ্যান করে।

ডায়াগনসিস

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: কানেকশন প্রত্যাখ্যান করা হয়েছে সমস্যাটি থেকে বোঝা যায় যে ব্যাকএন্ড সার্ভার কানেকশন প্রত্যাখ্যান করেছে।

      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. ব্যাকএন্ড সার্ভার যদি একটি IP অ্যাড্রেসে সমাধান করে, তাহলে নিম্নলিখিত কমান্ড ব্যবহার করুন:

      telnet BackendServer-IPaddress 443
                

   2. ব্যাকএন্ড সার্ভার একাধিক IP অ্যাড্রেস সমাধান করলে, telnet কমান্ডে ব্যাকএন্ড সার্ভারের হোস্টনেম ব্যবহার করুন, যেমন নিচে দেখানো হয়েছে:

      telnet BackendServer-HostName 443
                

4. আপনি ব্যাকএন্ড সার্ভারের সাথে কানেক্ট করতে পারলে, Connected to backend-server-এর মতো মেসেজ দেখতে পেতে পারেন। আপনি ব্যাকএন্ড সার্ভারের সাথে কানেক্ট করতে না পারলে, এর কারণ হতে পারে যে নির্দিষ্ট ব্যাকএন্ড সার্ভারে মেসেজ প্রসেসরের IP অ্যাড্রেস অ্যালাও লিস্টে নেই।

রেজোলিউশন

Edge Message Processor থেকে আপনার ব্যাকএন্ড সার্ভার অ্যাক্সেস করার জন্য নির্দিষ্ট ব্যাকএন্ড সার্ভারে Message Processor-এর IP অ্যাড্রেস অ্যাক্সেস করার অনুমতি দিন। যেমন, Linux-এ, আপনি মেসেজ প্রসেসরের IP অ্যাড্রেস থেকে আসা ট্রাফিককে ব্যাকএন্ড সার্ভারে অনুমতি দেওয়ার জন্য iptables ব্যবহার করতে পারেন।

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

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

ডায়াগনসিস

টার্গেট সার্ভারে উল্লেখ করা হোস্টের নাম ভুল হলে, আপনি সমস্যার কোড messaging.adaptors.http.flow.ServiceUnavailable. সহ 503 পরিষেবা উপলভ্য নেই উত্তর পেতে পারেন

রেজোলিউশন

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

SSL হ্যান্ডশেক সংক্রান্ত সমস্যা

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

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

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

উত্তরমুখী ও দক্ষিণমুখী কানেকশন বোঝা

Edge-এ, ইনকামিং বা আউটগোয়িং কানেকশনে আপনি 503 পরিষেবা উপলভ্য নেই সমস্যার মেসেজ পেতে পারেন:

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

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

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

503 পরিষেবা উপলভ্য নেই সমস্যাটি কোথায় হয়েছে তা নির্ধারণ করা

503 পরিষেবা উপলভ্য নয় সংক্রান্ত সমস্যাটি উত্তরমুখী বা দক্ষিণমুখী কানেকশনে হয়েছে কিনা তা নির্ধারণ করতে নিম্নলিখিত পদ্ধতিগুলির মধ্যে একটি ব্যবহার করুন।