স্পাইক অ্যারেস্ট নীতি

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

স্পাইক অ্যারেস্ট নীতি <Rate> উপাদান দিয়ে ট্রাফিক বৃদ্ধির বিরুদ্ধে সুরক্ষা দেয়। এই উপাদানটি একটি API প্রক্সি দ্বারা প্রসেস করা অনুরোধের সংখ্যাকে থ্রোটল করে এবং একটি ব্যাকএন্ডে পাঠানো হয়, কর্মক্ষমতা ল্যাগ এবং ডাউনটাইম থেকে রক্ষা করে।

<SpikeArrest> উপাদান

স্পাইক অ্যারেস্ট নীতি নির্ধারণ করে।

<SpikeArrest
  continueOnError="[false|true]"
  enabled="[true|false]"
  name="policy_name"
>
  <DisplayName>display_name</DisplayName>
  <Properties/>
  <Identifier ref="flow_variable"/>
  <MessageWeight ref="flow_variable"/>
  <Rate ref="flow_variable">rate[pm|ps]</Rate>
  <UseEffectiveCount>[false|true]</UseEffectiveCount>
</SpikeArrest>

<SpikeArrest async="false" continueOnError="false" enabled="true" name="Spike-Arrest-1">
  <DisplayName>Spike Arrest-1</DisplayName>
  <Properties/>
  <Identifier ref="request.header.some-header-name"/>
  <MessageWeight ref="request.header.weight"/>
  <Rate>30ps</Rate>
  <UseEffectiveCount>true</UseEffectiveCount>
</SpikeArrest>

This element has the following attributes that are common to all policies:

উদাহরণ

নিম্নলিখিত উদাহরণগুলি কিছু উপায় দেখায় যাতে আপনি স্পাইক অ্যারেস্ট নীতি ব্যবহার করতে পারেন:

<SpikeArrest name="Spike-Arrest-1">
  <Rate>5ps</Rate>
</SpikeArrest>

<SpikeArrest async="false" continueOnError="false" enabled="true" name="SpikeArreast">
  <DisplayName>SpikeArreast</DisplayName>
  <Rate>300pm</Rate>
</SpikeArrest>

<SpikeArrest name="Spike-Arrest-1">
  <Rate>12pm</Rate>
  <Identifier ref="client_id" />
  <MessageWeight ref="request.header.weight" />
</SpikeArrest>

<SpikeArrest name="Spike-Arrest-1">
  <Rate ref="request.header.runtime_rate" />
</SpikeArrest>

curl http://myorg-myenv.apigee.net/price -H 'runtime_rate:30ps'

শিশু উপাদান রেফারেন্স

এই বিভাগে <SpikeArrest> এর চাইল্ড উপাদানগুলি বর্ণনা করা হয়েছে।

<DisplayName>

Use in addition to the name attribute to label the policy in the management UI proxy editor with a different, more natural-sounding name.

The <DisplayName> element is common to all policies.

The <DisplayName> element uses the following syntax:

<PolicyElement>
  <DisplayName>policy_display_name</DisplayName>
  ...
</PolicyElement>

<PolicyElement>
  <DisplayName>My Validation Policy</DisplayName>
</PolicyElement>

The <DisplayName> element has no attributes or child elements.

<Identifier>

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

অনুরোধ থ্রটলিং এর উপর আরো সূক্ষ্ম নিয়ন্ত্রণের জন্য <MessageWeight> উপাদানের সাথে ব্যবহার করুন।

আপনি যদি <Identifier> উপাদানটি খালি রাখেন, তাহলে সেই API প্রক্সিতে সমস্ত অনুরোধের জন্য একটি হারের সীমা বলবৎ করা হয়।

<SpikeArrest
  continueOnError="[false|true]"
  enabled="[true|false]"
  name="policy_name"
>
  <Identifier ref="flow_variable"/>
</SpikeArrest>
        

<SpikeArrest name="Spike-Arrest-1">
  <Identifier ref="developer.id"/>
  <Rate>42pm</Rate/>
</SpikeArrest>

নিম্নলিখিত সারণী <Identifier> এর বৈশিষ্ট্যগুলি বর্ণনা করে:

এই উপাদানটি নিম্নলিখিত Apigee কমিউনিটি পোস্টেও আলোচনা করা হয়েছে: http://community.apigee.com/questions/2807/how-does-the-edge-quota-policy-work-when-no-identi.html ।

<MessageWeight>

প্রতিটি বার্তার জন্য সংজ্ঞায়িত ওজন নির্দিষ্ট করে। মেসেজের ওজন স্পাইক অ্যারেস্ট রেট গণনার উপর একটি একক অনুরোধের প্রভাবকে পরিবর্তন করে। বার্তার ওজন যেকোনো ফ্লো ভেরিয়েবল হতে পারে, যেমন একটি HTTP হেডার, ক্যোয়ারী প্যারামিটার, ফর্ম প্যারামিটার, বা মেসেজের বডি কন্টেন্ট। এছাড়াও আপনি JavaScript নীতি বা AssignMessage নীতি ব্যবহার করে কাস্টম ভেরিয়েবল ব্যবহার করতে পারেন।

নির্দিষ্ট ক্লায়েন্ট বা অ্যাপ্লিকেশানগুলির দ্বারা আরও থ্রোটল অনুরোধের জন্য <Identifier> এর সাথে ব্যবহার করুন।

উদাহরণস্বরূপ, যদি স্পাইক অ্যারেস্ট <Rate> হয় 10pm , এবং একটি অ্যাপ 2 এর ওজন সহ অনুরোধ জমা দেয়, তাহলে সেই ক্লায়েন্টের কাছ থেকে প্রতি মিনিটে শুধুমাত্র পাঁচটি বার্তা অনুমোদিত কারণ প্রতিটি অনুরোধ 2 হিসাবে গণনা করা হয়।

<SpikeArrest
  continueOnError="[false|true]"
  enabled="[true|false]"
  name="policy_name"
>
  <MessageWeight ref="flow_variable"/>
</SpikeArrest>

<SpikeArrest name="Spike-Arrest-1">
  <Rate>12pm</Rate>
  <Identifier ref="client_id" />
  <MessageWeight ref="request.header.weight" />
</SpikeArrest>

নিম্নলিখিত সারণী <MessageWeight> -এর গুণাবলী বর্ণনা করে:

<Rate>

প্রতি মিনিটে বা প্রতি সেকেন্ডের ব্যবধানে অনুমোদিত অনুরোধের সংখ্যা সেট করে ট্র্যাফিক স্পাইক (বা বিস্ফোরণ) সীমিত করার হার নির্দিষ্ট করে৷ আপনি ক্লায়েন্টের কাছ থেকে মান গ্রহণ করে রানটাইমে ট্র্যাফিককে মসৃণভাবে থ্রোটল করতে <Identifier> এবং <MessageWeight> এর সাথে একত্রে এই উপাদানটি ব্যবহার করতে পারেন।

<SpikeArrest
  continueOnError="[false|true]"
  enabled="[true|false]"
  name="policy_name"
>
  <Rate ref="flow_variable">rate[pm|ps]</Rate>
</SpikeArrest>

<SpikeArrest name="Spike-Arrest-1">
  <Rate>5ps</Rate>
</SpikeArrest>

<SpikeArrest async="false" continueOnError="false" enabled="true" name="SpikeArreast">
  <DisplayName>SpikeArreast</DisplayName>
  <Rate>300pm</Rate>
</SpikeArrest>

নিম্নলিখিত সারণী <Rate> এর বৈশিষ্ট্যগুলি বর্ণনা করে:

<Rate ref="request.header.custom_rate">1pm</Rate>

<UseEffectiveCount>

অটো-স্কেলিং গ্রুপ ব্যবহার করার সময় আপনার স্পাইক অ্যারেস্ট গণনা মেসেজ প্রসেসর (এমপি) জুড়ে বিতরণ করে।

<SpikeArrest
  continueOnError="[false|true]"
  enabled="[true|false]"
  name="policy_name"
>
  <UseEffectiveCount>[false|true]</UseEffectiveCount>
</SpikeArrest>

<SpikeArrest name='Spike-Arrest-1'>
  <Rate>40ps</Rate>
  <UseEffectiveCount>true</UseEffectiveCount>
</SpikeArrest>

<UseEffectiveCount> উপাদানটি ঐচ্ছিক। আপনার স্পাইক অ্যারেস্ট নীতি থেকে উপাদানটি বাদ দিলে ডিফল্ট মানটি false ।

নিচের টেবিলটি <UseEffectiveCount> উপাদানের বৈশিষ্ট্য বর্ণনা করে:

<UseEffectiveCount> এর প্রভাব এর মানের উপর নির্ভর করে:

• true : একজন এমপির স্পাইক রেট সীমা হল একই পডে বর্তমান এমপিদের সংখ্যা দ্বারা ভাগ করা <Rate> । সমষ্টিগত সীমা হল <Rate> এর মান। যখন এমপিদের গতিশীলভাবে যুক্ত করা হয় (বা সরানো হয়), তখন তাদের স্বতন্ত্র স্পাইক রেট সীমা বাড়বে (বা কমবে), কিন্তু সামগ্রিক সীমা একই থাকবে।
• false : প্রতিটি এমপির স্পাইক রেট লিমিট হল তার <Rate> এর মান। সমষ্টিগত সীমা হল সকল এমপির হারের সমষ্টি। যখন এমপিদের যোগ করা হয় (বা সরানো হয়), তখন তাদের স্বতন্ত্র স্পাইক রেট সীমা একই থাকবে, কিন্তু সামগ্রিক সীমা বাড়বে (বা কমবে)।

স্পাইকঅ্যারেস্ট নীতি একটি " টোকেন বাকেট " অ্যালগরিদম ব্যবহার করে যা ট্র্যাফিক স্পাইকগুলিকে মসৃণ করে রেট সীমাকে বিভক্ত করে যা আপনি ছোট ব্যবধানে নির্দিষ্ট করেন৷ এই পদ্ধতির একটি অপূর্ণতা হল যে স্বল্প সময়ের ব্যবধানে আসা একাধিক বৈধ অনুরোধ সম্ভাব্যভাবে অস্বীকার করা যেতে পারে।

উদাহরণস্বরূপ, বলুন আপনি 30pm (প্রতি মিনিটে 30 অনুরোধ) একটি হার লিখুন। পরীক্ষায়, আপনি ভাবতে পারেন যে আপনি 1 সেকেন্ডে 30টি অনুরোধ পাঠাতে পারেন, যতক্ষণ না সেগুলি এক মিনিটের মধ্যে আসে। কিন্তু নীতিটি সেটিংটি কীভাবে প্রয়োগ করে তা নয়। আপনি যদি এটি সম্পর্কে চিন্তা করেন, 1-সেকেন্ড সময়ের মধ্যে 30টি অনুরোধ কিছু পরিবেশে একটি ছোট স্পাইক হিসাবে বিবেচিত হতে পারে।

• প্রতি মিনিটের হার সেকেন্ডের ব্যবধানে অনুমোদিত সম্পূর্ণ অনুরোধে মসৃণ হয়ে যায়।
  

  উদাহরণস্বরূপ, 30pm এভাবে মসৃণ হয়:
  60 সেকেন্ড (1 মিনিট) / 30pm = 2-সেকেন্ডের ব্যবধান, বা প্রতি 2 সেকেন্ডে 1টি অনুরোধ অনুমোদিত৷ 2 সেকেন্ডের মধ্যে একটি দ্বিতীয় অনুরোধ ব্যর্থ হবে। এছাড়াও, এক মিনিটের মধ্যে একটি 31তম অনুরোধ ব্যর্থ হবে।

• প্রতি-সেকেন্ডের হার মিলিসেকেন্ডের ব্যবধানে অনুমোদিত সম্পূর্ণ অনুরোধে মসৃণ হয়ে যায়।

  উদাহরণস্বরূপ, 10ps এভাবে মসৃণ হয়:
  1000 মিলিসেকেন্ড (1 সেকেন্ড) / 10ps = 100-মিলিসেকেন্ড ব্যবধান, বা প্রতি 100 মিলিসেকেন্ডে 1টি অনুরোধ অনুমোদিত৷ 100ms এর মধ্যে একটি দ্বিতীয় অনুরোধ ব্যর্থ হবে। এছাড়াও, এক সেকেন্ডের মধ্যে একটি 11 তম অনুরোধ ব্যর্থ হবে।

নিম্নলিখিত টেবিলটি প্রতিটি এমপির কার্যকর হার সীমার উপর <UseEffectiveCount> এর প্রভাব দেখায়:

এই উদাহরণে, লক্ষ্য করুন যে যখন এমপির সংখ্যা 4 থেকে কমে 2 হয় এবং <UseEffectiveCount> false হয়, তখন প্রতি এমপি কার্যকরী হার একই থাকে (10 এ)। কিন্তু যখন <UseEffectiveCount> true হয়, এমপির সংখ্যা 4 থেকে 2 তে কমে গেলে প্রতি এমপি কার্যকরী হার 10 থেকে 20 হয়ে যায়।

ফ্লো ভেরিয়েবল

যখন একটি স্পাইক অ্যারেস্ট নীতি কার্যকর হয়, তখন নিম্নলিখিত ফ্লো ভেরিয়েবলটি পপুলেট করা হয়:

আরও তথ্যের জন্য, ফ্লো ভেরিয়েবল রেফারেন্স দেখুন।

ত্রুটি উল্লেখ

এই বিভাগটি ফল্ট কোড এবং ত্রুটি বার্তাগুলি বর্ণনা করে যেগুলি ফেরত দেওয়া হয় এবং ত্রুটি ভেরিয়েবলগুলি যেগুলি এজ দ্বারা সেট করা হয় যখন এই নীতিটি একটি ত্রুটি ট্রিগার করে৷ এই তথ্যটি জানা গুরুত্বপূর্ণ যে আপনি ত্রুটিগুলি পরিচালনা করার জন্য ত্রুটির নিয়ম তৈরি করছেন কিনা। আরও জানতে, নীতিগত ত্রুটি এবং হ্যান্ডলিং ফল্ট সম্পর্কে আপনার যা জানা দরকার তা দেখুন৷

রানটাইম ত্রুটি

নীতি কার্যকর করার সময় এই ত্রুটিগুলি ঘটতে পারে৷

স্থাপনার ত্রুটি

আপনি যখন এই নীতি সম্বলিত একটি প্রক্সি স্থাপন করেন তখন এই ত্রুটিগুলি ঘটতে পারে৷

ফল্ট ভেরিয়েবল

রানটাইম ত্রুটি ঘটলে এই ভেরিয়েবলগুলি সেট করা হয়। আরও তথ্যের জন্য, নীতি ত্রুটি সম্পর্কে আপনার যা জানা দরকার তা দেখুন।

উদাহরণ ত্রুটি প্রতিক্রিয়া

নীচে একটি উদাহরণ ত্রুটি প্রতিক্রিয়া দেখানো হয়েছে:

{  
   "fault":{  
      "detail":{  
         "errorcode":"policies.ratelimit.SpikeArrestViolation"
      },
      "faultstring":"Spike arrest violation. Allowed rate : 10ps"
   }
}

উদাহরণ দোষ নিয়ম

SpikeArrestViolation লঙ্ঘন ফল্ট পরিচালনা করার জন্য একটি উদাহরণ ফল্ট নিয়ম নীচে দেখানো হয়েছে:

<FaultRules>
    <FaultRule name="Spike Arrest Errors">
        <Step>
            <Name>JavaScript-1</Name>
            <Condition>(fault.name Matches "SpikeArrestViolation") </Condition>
        </Step>
        <Condition>ratelimit.Spike-Arrest-1.failed=true</Condition>
    </FaultRule>
</FaultRules>

কোটা বা স্পাইক অ্যারেস্ট নীতি দ্বারা নির্ধারিত হারের সীমা অতিক্রম করার জন্য বর্তমান HTTP স্ট্যাটাস কোড হল 429 (অনেক অনুরোধ)। HTTP স্থিতি কোডকে 500 (অভ্যন্তরীণ সার্ভার ত্রুটি) এ পরিবর্তন করতে, আপডেট সংস্থা বৈশিষ্ট্য API ব্যবহার করে features.isHTTPStatusTooManyRequestEnabled .isHTTPStatusTooManyRequestEnabled প্রপার্টিটিকে false সেট করুন।

যেমন:

curl -u email:password -X POST -H "Content-type:application/xml" http://api.enterprise.apigee.com/v1/organizations/myorg -d \
"<Organization type="trial" name="MyOrganization">
    <Properties>
        <Property name="features.isHTTPStatusTooManyRequestEnabled">true</Property>
        . . .
    </Properties>
</Organization>"

স্কিমাস

প্রতিটি নীতির ধরন একটি XML স্কিমা ( .xsd ) দ্বারা সংজ্ঞায়িত করা হয়। রেফারেন্সের জন্য, নীতি স্কিমা GitHub এ উপলব্ধ।

সম্পর্কিত বিষয়

• কোটা নীতি : পৃথক ক্লায়েন্টদের উপর ট্রাফিক সীমিত করার জন্য কোটা নীতি
• একটি হার সীমিত ওভারভিউ জন্য হার-সীমাবদ্ধতা
• কোটা এবং স্পাইক অ্যারেস্ট নীতির তুলনা করা
• API প্রক্সিগুলির কাজের নমুনা