এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

স্ট্রিমিং অনুরোধ এবং প্রতিক্রিয়া

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

এই বিষয়ে আপনি যা শিখবেন

এই বিষয়টি পড়ার পর আপনি জানতে পারবেন:

Apigee Edge-এ অনুরোধ এবং প্রতিক্রিয়া স্ট্রিমিং কী
কখন অনুরোধ এবং প্রতিক্রিয়া স্ট্রিমিং ব্যবহার করবেন
অনুরোধ এবং প্রতিক্রিয়া স্ট্রিমিং কীভাবে সক্রিয় করবেন

অনুরোধ এবং প্রতিক্রিয়া স্ট্রিমিং কী?

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

কখন স্ট্রিমিং চালু করা উচিত?

যদি আপনার এপিআই প্রক্সি খুব বড় আকারের অনুরোধ এবং/অথবা প্রতিক্রিয়া পরিচালনা করে (আকারের সীমা জানতে, নিচে ‘স্ট্রিমিং সম্পর্কে আমার আর কী জানা উচিত ’ দেখুন), তাহলে আপনি স্ট্রিমিং চালু করতে চাইতে পারেন।

দ্রষ্টব্য: আপনার API যদি বিপুল পরিমাণ ডেটা অনুরোধ করে বা ফেরত দেয়, তাহলে আপনি এই HTTP ত্রুটিটি দেখতে পারেন:

{"fault":"{\"detail\":{\"errorcode\":\"protocol.http.TooBigBody\"},\"faultstring\":\"Body buffer overflow\"}"}

আপনি যদি এই ত্রুটিটি দেখতে পান, তাহলে আমরা আপনাকে স্ট্রিমিং চালু করার পরামর্শ দিই। স্ট্রিমিং চালু করার পরেও যদি আপনি ত্রুটিটি দেখতে থাকেন, তবে অনুরোধ বা প্রতিক্রিয়ার পেলোডে অ্যাক্সেসের প্রয়োজন এমন যেকোনো পলিসি সরিয়ে ফেলার কথা বিবেচনা করুন। আরও তথ্যের জন্য, এপিআই প্রক্সি ডিজাইন এবং ডেভেলপমেন্টের সেরা অনুশীলন -এর "মেসেজ পেলোড সাইজ" অংশটি দেখুন।

স্ট্রিমিং সম্পর্কে আমার আর কী জানা উচিত?

এজ ক্লাউড এবং প্রাইভেট ক্লাউডে, স্ট্রিমিং চালু থাকলেও মেসেজ পেলোড সাইজ ১০ মেগাবাইটে সীমাবদ্ধ। নন-স্ট্রিমড রিকোয়েস্ট এবং রেসপন্সের ক্ষেত্রে, এই সাইজ অতিক্রম করলে একটি protocol.http.TooBigBody এরর দেখা দেয়।

যদিও স্ট্রিমিং আপনাকে প্রোডাক্ট দ্বারা আরোপিত ১০ মেগাবাইট রিকোয়েস্ট/রেসপন্স সাইজের সীমাবদ্ধতা এড়াতে সাহায্য করতে পারে, Apigee স্ট্রিমিং করার সময় সেই সীমা অতিক্রম করার পরামর্শ দেয় না এবং এই সীমা অতিক্রম করার ফলে উদ্ভূত সমস্যা, যেমন পারফরম্যান্স সমস্যা, টাইমআউট ইত্যাদিতে সহায়তা করতে পারে না। আপনি যদি টাইমআউট বা গেটওয়ে এরর পান, তাহলে সম্ভাব্য সমস্যা সমাধানের ধাপগুলোর জন্য এরর মেসেজ রেফারেন্স দেখুন।

১০ মেগাবাইটের চেয়ে বড় পেলোডের জন্য, Apigee একটি Apigee JavaCallout-এর মধ্যে signed URLs প্যাটার্ন ব্যবহার করার পরামর্শ দেয়, যা GitHub-এ থাকা Edge Callout: Signed URL Generator উদাহরণটিতে দেখানো হয়েছে।

Edge for Private Cloud ডেপ্লয়মেন্টে, আপনি নন-স্ট্রিমড রিকোয়েস্ট/রেসপন্স সাইজের সীমা পরিবর্তন করতে পারেন। প্রোডাকশনে পরিবর্তনটি ডেপ্লয় করার আগে অবশ্যই পরীক্ষা করে নিন।

Edge for Private Cloud-এর 4.16.01-এর পূর্ববর্তী রিলিজগুলোর জন্য:

সমস্ত মেসেজ প্রসেসরে, http.properties ফাইলটি সম্পাদনা করে HTTPResponse.body.buffer.limit প্যারামিটারের সীমা বাড়িয়ে দিন এবং তারপর মেসেজ প্রসেসরটি পুনরায় চালু করুন।
Edge for Private Cloud রিলিজ 4.16.01 এবং পরবর্তী সংস্করণগুলোর জন্য:
1. /<inst_root>/apigee/customer/application/message-processor.properties ফাইলটি সম্পাদনা করুন। ফাইলটি না থাকলে, এটি তৈরি করুন।
2. message-processor.properties ফাইলে conf_http_HTTPResponse.body.buffer.limit প্রপার্টিটি সেট করুন। উদাহরণস্বরূপ:
  conf_http_HTTPResponse.body.buffer.limit=5m
3. মেসেজ প্রসেসরটি পুনরায় চালু করুন:
  /<inst_root>/apigee/apigee-service/bin/apigee-service edge-message-processor restart
4. সকল মেসেজ প্রসেসরের জন্য পুনরাবৃত্তি করুন।

স্ট্রিমিং চালু থাকলে, Apigee দৃঢ়ভাবে পরামর্শ দেয় যে আপনি এমন কোনো পলিসি সংযুক্ত করবেন না যার জন্য রিকোয়েস্ট বা রেসপন্স পেলোডে অ্যাক্সেসের প্রয়োজন হয়। এই ধরনের পলিসিগুলো হয় এরর সৃষ্টি করবে অথবা এপিআই প্রক্সিতে বাফারিং চালু করবে, যা পেলোডের আকারকে উপরে উল্লিখিত সংখ্যাগুলিতে সীমাবদ্ধ করে দেয় এবং বড় পেলোড হ্যান্ডেল করার জন্য স্ট্রিমিং চালু করার উদ্দেশ্যকেই ব্যর্থ করে দেয়। আপনি এমন পলিসি সংযুক্ত করতে পারেন যা রিকোয়েস্ট/রেসপন্স বডির সাথে ইন্টারঅ্যাক্ট করে না, যেমন অথেনটিকেশন বা মেসেজ লগিং পলিসি।

অনুরোধ এবং প্রতিক্রিয়া স্ট্রিমিং কীভাবে সক্রিয় করবেন

রিকোয়েস্ট স্ট্রিমিং চালু করতে, আপনাকে প্রক্সি বান্ডেলের মধ্যে থাকা ProxyEndpoint এবং TargetEndpoint ডেফিনিশনে request.streaming.enabled প্রপার্টিটি যোগ করতে হবে এবং এর মান true সেট করতে হবে। একইভাবে, রেসপন্স স্ট্রিমিং চালু করার জন্য response.streaming.enabled প্রপার্টিটি সেট করুন।

আপনি আপনার প্রক্সির জন্য ম্যানেজমেন্ট UI-এর ডেভেলপ ভিউতে এই কনফিগারেশন ফাইলগুলো খুঁজে পেতে পারেন। আপনি যদি স্থানীয়ভাবে ডেভেলপ করেন, তাহলে এই ডেফিনিশন ফাইলগুলো apiproxy/proxies এবং apiproxy/targets এ থাকে।

এই নমুনাটি দেখায় কিভাবে TargetEndpoint সংজ্ঞায় অনুরোধ এবং প্রতিক্রিয়া উভয় স্ট্রিমিং সক্রিয় করতে হয়।

<TargetEndpoint name="default">
  <HTTPTargetConnection>
    <URL>http://mocktarget.apigee.net</URL>
    <Properties>
      <Property name="response.streaming.enabled">true</Property>
      <Property name="request.streaming.enabled">true</Property>
      <Property name="supports.http10">true</Property>
      <Property name="request.retain.headers">User-Agent,Referer,Accept-Language</Property>
      <Property name="retain.queryparams">apikey</Property>
    </Properties>
  </HTTPTargetConnection>
</TargetEndpoint>

এই উদাহরণটি দেখায় কিভাবে ProxyEndpoint সংজ্ঞায় প্রতিক্রিয়া এবং অনুরোধ স্ট্রিমিং সক্ষম করতে হয়:

<ProxyEndpoint name="default">
  <HTTPProxyConnection>
    <BasePath>/v1/weather</BasePath>
    <Properties>
      <Property name="allow.http10">true</Property>
      <Property name="response.streaming.enabled">true</Property>
      <Property name="request.streaming.enabled">true</Property>
    </Properties>
  </HTTPProxyConnection>
</ProxyEndpoint>

এন্ডপয়েন্ট ডেফিনিশন কনফিগার করার বিষয়ে আরও তথ্যের জন্য, এন্ডপয়েন্ট প্রোপার্টি রেফারেন্স দেখুন।