502 খারাপ গেটওয়ে - TooBigLine

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

লক্ষণ

ক্লায়েন্ট অ্যাপ্লিকেশনটি এপিআই কলের প্রতিক্রিয়া হিসেবে 502 Bad Gateway HTTP স্ট্যাটাস কোড এবং protocol.http.TooBigLine এরর কোড পায়।

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

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

HTTP/1.1 502 Bad Gateway

এছাড়াও, আপনি নিম্নলিখিত ত্রুটি বার্তাটি দেখতে পারেন:

{
   "fault":{
      "faultstring":"response line size exceeding 2,048",
      "detail":{
         "errorcode":"protocol.http.TooBigLine"
      }
   }
}

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

টার্গেট/ব্যাকএন্ড সার্ভার থেকে HTTP রেসপন্সের অংশ হিসেবে Apigee Edge-এ পাঠানো Response-Line-এর সাইজ যদি Apigee Edge-এ অনুমোদিত সর্বোচ্চ সীমার চেয়ে বেশি হয়, তাহলে এই ত্রুটিটি ঘটে।

এই ত্রুটির সম্ভাব্য কারণগুলো দেখার আগে, চলুন জেনে নিই Response-Line বলতে কী বোঝায় এবং এর আকার কীভাবে পরীক্ষা করতে হয়।

রেসপন্স-লাইন বোঝা

একটি সাধারণ HTTP প্রতিক্রিয়া তিনটি অংশ নিয়ে গঠিত:

1. স্ট্যাটাস-লাইন (Apigee-তে যা রেসপন্স-লাইন নামে পরিচিত)
2. HTTP হেডারসমূহের সেট
3. [ দেহ ]

রেসপন্স-লাইনটি তিনটি অংশ নিয়ে গঠিত: প্রোটোকল সংস্করণ, এরপরে একটি সাংখ্যিক স্ট্যাটাস কোড এবং এর সাথে সম্পর্কিত পাঠ্য বাক্যাংশ, যা নিচে দেখানো হলো:

Response-Line   = <HTTP-Version> <Status-Code> <Reason-Phrase>

যখন টার্গেট/ব্যাকএন্ড সার্ভার অ্যাপ্লিকেশন থেকে একটি HTTP রেসপন্স পাঠানো হয়, তখন পাঠানো প্রথম লাইনটি উপরে বর্ণিত রেসপন্স-লাইনকে নির্দেশ করে। এর পরে হেডার এবং রেসপন্স বডি/পে-লোড থাকে। নিচের নমুনা স্ক্রিনশটটিতে একটি সাধারণ curl রিকোয়েস্ট, তার রিকোয়েস্ট অংশ এবং রেসপন্স অংশ (রেসপন্স-লাইন সহ) দেখানো হয়েছে।

রেসপন্স-লাইন সাইজ বোঝা

1. উপরে আলোচিত নমুনাটিতে, প্রতিক্রিয়ার প্রারম্ভিক রেখা (প্রথম রেখা), যা রেসপন্স-লাইন নামেও পরিচিত, তা নিম্নরূপ:

   HTTP/1.1 200 OK

   এই রেসপন্স-লাইনটির আকার প্রায় ~15 bytes কারণ এতে 15 ASCII characters রয়েছে। যেহেতু এটি Apigee Edge-এর অনুমোদিত সীমার মধ্যে, তাই Apigee Edge কোনো ত্রুটি ছাড়াই রেসপন্সটি ক্লায়েন্টের কাছে ফেরত পাঠিয়ে দেয়।

2. একইভাবে, আপনি যদি উপরে দেখানো ত্রুটির বার্তার faultstring দেখেন, তাহলে দেখবেন তাতে "response line size exceeding 2,048" লেখা আছে। এটি নির্দেশ করে যে টার্গেট/ব্যাকএন্ড সার্ভার দ্বারা প্রেরিত HTTP রেসপন্সের রেসপন্স-লাইনটি ২,০৪৮ বাইট অতিক্রম করেছে।

বৃহৎ প্রতিক্রিয়া-লাইন বোঝা

স্ট্যাটাস-লাইন (এখানে রেসপন্স-লাইন হিসাবে উল্লেখিত) এবং সাধারণ HTTP অনুরোধ ও প্রতিক্রিয়ার সংজ্ঞা অনুসারে, এর আকার Apigee Edge-এ নির্ধারিত ২ কিলোবাইট ডিফল্ট সীমার চেয়ে অনেক ছোট হবে, তাই আমরা হয়তো এই সীমায় পৌঁছাব না। তবে, এখানে কিছু সম্ভাব্য পরিস্থিতি উল্লেখ করা হলো যেখানে আপনি এই সীমা অতিক্রম করতে পারেন:

1. টার্গেট/ব্যাকএন্ড সার্ভারটি কোনো HTTP সিস্টেম নয়। এটি HTTP-বহির্ভূত কোনো প্রতিক্রিয়া জানাতে পারে।
2. টার্গেট/ব্যাকএন্ড সার্ভারে সমস্যা হওয়ায় এটি HTTP রেসপন্সের অংশ হিসেবে একটি দীর্ঘ রেসপন্স-লাইন পাঠাচ্ছে।

এই সম্পর্কে আরও পড়ুন " getting error protocol.http.TooBigLine, "response line size exceeding 2,048 " অংশে।

ত্রুটিটির সম্ভাব্য কারণগুলো নিচে দেওয়া হলো:

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

এই ত্রুটি নির্ণয় করতে নিম্নলিখিত সরঞ্জাম/কৌশলগুলোর মধ্যে যেকোনো একটি ব্যবহার করুন:

কারণ: রেসপন্স-লাইনের আকার অনুমোদিত সীমার চেয়ে বড়

রোগ নির্ণয়

1. সাধারণ রোগ নির্ণয়ের ধাপগুলিতে ব্যাখ্যা করা অনুযায়ী API মনিটরিং, ট্রেস টুল বা NGINX অ্যাক্সেস লগ ব্যবহার করে পরিলক্ষিত ত্রুটির জন্য ফল্ট কোড এবং ফল্ট সোর্স নির্ধারণ করুন।
2. যদি ফল্ট সোর্সের মান ' target হয়, তাহলে এটি নির্দেশ করে যে টার্গেট/ব্যাকএন্ড সার্ভার অ্যাপ্লিকেশন থেকে Apigee-তে পাঠানো রেসপন্স-লাইনের আকার Apigee Edge-এ অনুমোদিত সীমার চেয়ে বড়।

3. নিম্নলিখিত পদ্ধতিগুলোর যেকোনো একটি ব্যবহার করে আপনি যাচাই করতে পারেন যে রেসপন্স-লাইনের আকার ২ কিলোবাইট অনুমোদিত সীমা অতিক্রম করেছে কিনা:

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

   ত্রুটির বার্তা ব্যবহার করে যাচাই করতে:

   আপনার কাছে যদি Apigee Edge থেকে প্রাপ্ত সম্পূর্ণ এরর মেসেজটি থাকে, তাহলে faultstring টি দেখুন।

   নমুনা ত্রুটি বার্তা:

   "faultstring":"response line size exceeding 2,048"

   উপরোক্ত faultstring নির্দেশ করে যে রেসপন্স-লাইনের আকার ২ কিলোবাইটের অনুমোদিত সীমা অতিক্রম করেছে।

   প্রকৃত অনুরোধ

   প্রকৃত অনুরোধ ব্যবহার করে যাচাই করতে:

   টার্গেট/ব্যাকএন্ড সার্ভার অ্যাপ্লিকেশনে করা প্রকৃত অনুরোধটি যদি আপনার কাছে থাকে, তাহলে নিম্নলিখিত ধাপগুলো অনুসরণ করুন:

   1. রেসপন্স-লাইনের আকার যাচাই করুন
   2. Apigee Edge-এ যদি আপনি দেখেন যে URI-এর আকার অনুমোদিত সীমার চেয়ে বেশি, তাহলে সেটাই সমস্যার কারণ।

      টার্গেট/ব্যাকএন্ড সার্ভার থেকে প্রাপ্ত নমুনা প্রতিক্রিয়া:

      curl -v http://HOSTALIAS/test
      

      *   Trying 3.2.1.4...
      * TCP_NODELAY set
      * Connected to <hostalias> (3.2.1.4) port 80 (#0)
      > GET /test HTTP/1.1
      > Host: HOSTALIAS
      > User-Agent: curl/7.64.1
      > Accept: */*
      >
      < HTTP/1.1 200 1111…<trimmed>...11111111
      < Date: Mon, 26 Jul 2021 07:07:18 GMT
      < Content-Type: application/json
      < Content-Length: 269
      < Connection: keep-alive
      < Server: gunicorn/19.9.0
      < Access-Control-Allow-Origin: *
      < Access-Control-Allow-Credentials: true
      <
      {
      <Response Body>
      }
      * Connection #0 to host <hostalias> left intact
      * Closing connection 0

      উপরের ক্ষেত্রে, Response-Line HTTP/1.1 200 1111…<trimmed>...11111111 2 KB-এর চেয়ে বড়, অর্থাৎ, এতে 2 K-এর বেশি ASCII ক্যারেক্টার রয়েছে।

      আপনি যদি অন্য কোনো ক্লায়েন্ট ব্যবহার করেন, তাহলে ক্লায়েন্ট লগগুলো পর্যালোচনা করে Apigee Edge-এ পাঠানো Response-Line-এর আকার খুঁজে বের করার চেষ্টা করতে পারেন।

   মেসেজ প্রসেসর লগ

   মেসেজ প্রসেসর লগ ব্যবহার করে যাচাই করতে:

   আপনি যদি একজন প্রাইভেট ক্লাউড ব্যবহারকারী হন, তাহলে Apigee Edge-এ Response-Line-এর আকার অনুমোদিত সীমা অতিক্রম করেছে কিনা তা যাচাই করতে Message Processor লগ ব্যবহার করতে পারেন।

   1. সাধারণ রোগ নির্ণয়ের ধাপগুলিতে যেমন ব্যাখ্যা করা হয়েছে, সেই অনুযায়ী এপিআই মনিটরিং, ট্রেস টুল বা এনজিআইএনএক্স অ্যাক্সেস লগ ব্যবহার করে ব্যর্থ হওয়া অনুরোধটির মেসেজ আইডি নির্ধারণ করুন।

   2. মেসেজ প্রসেসর লগে মেসেজ আইডিটি অনুসন্ধান করুন:

      /opt/apigee/var/log/edge-message-processor/logs/system.log

   3. আপনি system.log এ নিম্নলিখিতগুলির মতো লাইন খুঁজে পাবেন:

      2021-07-26 06:45:41,451 org:myorg env:prod api:testtoobigline rev:1 messageid:r-5110240-1
      NIOThread@1 ERROR HTTP.CLIENT - HTTPClient$Context$3.onException() :
      ClientChannel[Connected: Remote:3.2.1.2:80 Local:192.168.205.251:44398]@20592
      useCount=1 bytesRead=0 bytesWritten=201 age=144ms  lastIO=0ms  isOpen=true.onExceptionRead
      exception: {}
      com.apigee.errors.http.server.BadGateway: response line size exceeding 2,048
      at <snipped>
      
      2021-07-26 06:45:41,451 org:myorg env:prod api:testtoobigline rev:1
      messageid:r-5110240-1  NIOThread@1 ERROR ADAPTORS.HTTP.FLOW -
      AbstractResponseListener.onException() : AbstractResponseListener.onError
      (HTTPResponse@6a5d6c33, response line size exceeding 2,048)

      উপরের এরর মেসেজে থাকা message = response line size exceeding 2,048 নির্দেশ করে যে রেসপন্স-লাইনের সাইজ ২ কিলোবাইটের বেশি। তাই, Apigee Edge একটি এক্সেপশন থ্রো করে এবং ক্লায়েন্ট অ্যাপ্লিকেশনগুলোতে protocol.http.TooBigline ফল্ট কোডসহ একটি 502 স্ট্যাটাস কোড রিটার্ন করে।

সমাধান

সীমা

Apigee আশা করে যে ক্লায়েন্ট অ্যাপ্লিকেশন এবং ব্যাকএন্ড সার্ভার এমন কোনো Request/Response-Line পাঠাবে না, যার আকার Apigee Edge Limits- এ নথিভুক্ত Request/Response Line Limit-এর জন্য নির্ধারিত অনুমোদিত সীমার চেয়ে বড়।

1. আপনি যদি একজন পাবলিক ক্লাউড ব্যবহারকারী হন, তাহলে রিকোয়েস্ট এবং রেসপন্স লাইনের আকারের সর্বোচ্চ সীমা Apigee Edge Limits- এ উল্লেখিত নিয়ম অনুযায়ী হবে।
2. আপনি যদি একজন প্রাইভেট ক্লাউড ব্যবহারকারী হন, তাহলে আপনি হয়তো রিকোয়েস্ট এবং রেসপন্স-লাইন সাইজের ডিফল্ট সর্বোচ্চ সীমা পরিবর্তন করে থাকতে পারেন (যদিও এটি একটি অনুচিত কাজ)। ‘বর্তমান সীমা কীভাবে পরীক্ষা করবেন’ অংশে দেওয়া নির্দেশাবলী অনুসরণ করে আপনি রেসপন্স-লাইন সাইজের সর্বোচ্চ সীমা নির্ধারণ করতে পারেন।

বর্তমান সীমা কীভাবে পরীক্ষা করবেন?

এই অংশে ব্যাখ্যা করা হয়েছে কিভাবে যাচাই করতে হয় যে মেসেজ প্রসেসরগুলিতে HTTPResponse.line.limit প্রপার্টিটি একটি নতুন মান দ্বারা আপডেট করা হয়েছে।

1. মেসেজ প্রসেসর মেশিনে, /opt/apigee/edge-message-processor/conf ডিরেক্টরিতে HTTPResponse.line.limit প্রপার্টিটি খুঁজুন এবং নিচে দেখানো অনুযায়ী কী মান সেট করা হয়েছে তা পরীক্ষা করে দেখুন:

   grep -ri "HTTPResponse.line.limit" /opt/apigee/edge-message-processor/conf
   

2. উপরোক্ত কমান্ড থেকে প্রাপ্ত নমুনা ফলাফলটি নিম্নরূপ:

   /opt/apigee/edge-message-processor/conf/http.properties:HTTPResponse.line.limit=2k

3. উপরের উদাহরণ আউটপুটে লক্ষ্য করুন যে, http.properties ফাইলে HTTPResponse.line.limit প্রপার্টিটির মান 2k সেট করা হয়েছে।

   এর থেকে বোঝা যায় যে, Apigee for Private Cloud-এ কনফিগার করা Response-Line সাইজের সীমা হলো ২ কিলোবাইট।

আপনার যদি এখনও Apigee Support-এর কাছ থেকে কোনো সাহায্যের প্রয়োজন হয়, তাহলে Must gather diagnostic information- এ যান।

রোগ নির্ণয়ের তথ্য অবশ্যই সংগ্রহ করতে হবে

নিম্নলিখিত ডায়াগনস্টিক তথ্য সংগ্রহ করুন, এবং তারপর Apigee Edge Support-এর সাথে যোগাযোগ করুন:

আপনি যদি পাবলিক ক্লাউড ব্যবহারকারী হন, তাহলে নিম্নলিখিত তথ্যগুলো প্রদান করুন:

• সংস্থার নাম
• পরিবেশের নাম
• এপিআই প্রক্সি নাম
• 502 ত্রুটিটি পুনরুৎপাদন করতে ব্যবহৃত সম্পূর্ণ কার্ল কমান্ড।
• এপিআই অনুরোধগুলির ট্রেস ফাইল

আপনি যদি একজন প্রাইভেট ক্লাউড ব্যবহারকারী হন, তাহলে নিম্নলিখিত তথ্যগুলো প্রদান করুন:

• ব্যর্থ অনুরোধগুলির জন্য সম্পূর্ণ ত্রুটি বার্তা পরিলক্ষিত হয়েছে।
• সংস্থার নাম
• পরিবেশের নাম
• এপিআই প্রক্সি বান্ডেল
• ব্যর্থ হওয়া এপিআই অনুরোধগুলির ট্রেস ফাইল
• 502 ত্রুটিটি পুনরুৎপাদন করতে ব্যবহৃত সম্পূর্ণ curl কমান্ড।

• NGINX অ্যাক্সেস লগ /opt/apigee/var/log/edge-router/nginx/ ORG ~ ENV . PORT# _access_log

  যেখানে: ORG , ENV এবং PORT# প্রকৃত মান দ্বারা প্রতিস্থাপিত হয়।

• মেসেজ প্রসেসর সিস্টেম লগ /opt/apigee/var/log/edge-message-processor/logs/system.log