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

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

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

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

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

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

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

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

আমি কখন স্ট্রিমিং সক্ষম করব?

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

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

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

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

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

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

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

10 MB-এর থেকে বড় পেলোডের জন্য, Apigee একটি Apigee JavaCallout-এর মধ্যে একটি স্বাক্ষরিত URL প্যাটার্ন ব্যবহার করার পরামর্শ দেয়, এজ কলআউট দ্বারা চিত্রিত: GitHub-এ স্বাক্ষরিত URL জেনারেটর উদাহরণ৷

ব্যক্তিগত ক্লাউড স্থাপনার জন্য এজ-এ, আপনি অ-স্ট্রীমড অনুরোধ/প্রতিক্রিয়া আকারের সীমা পরিবর্তন করতে পারেন। উত্পাদনে পরিবর্তন স্থাপন করার আগে পরীক্ষা করতে ভুলবেন না।

প্রাইভেট ক্লাউডের জন্য এজ 4.16.01 এর আগের রিলিজের জন্য:

সমস্ত মেসেজ প্রসেসরে, HTTPResponse.body.buffer.limit প্যারামিটারে সীমা বাড়ানোর জন্য http.properties ফাইলটি সম্পাদনা করুন এবং তারপর মেসেজ প্রসেসর পুনরায় চালু করুন।
এজ ফর প্রাইভেট ক্লাউড রিলিজ 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 রিস্টার্ট
4. সমস্ত বার্তা প্রসেসরের জন্য পুনরাবৃত্তি করুন।

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

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

অনুরোধ স্ট্রিমিং সক্ষম করতে আপনাকে প্রক্সি বান্ডেলে 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 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>

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