سياسة SpikeArrest

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

تحمي سياسة Spike Arrest من ارتفاع عدد الزيارات المفاجئ باستخدام العنصر <Rate>. يحدّ هذا العنصر من عدد الطلبات التي يعالجها خادم وكيل لواجهة برمجة التطبيقات ويتم إرسالها إلى الخلفية، ما يساعد في الحماية من بطء الأداء وتعطّله.

العنصر <SpikeArrest>

تحدّد سياسة Spike Arrest.

<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>

يتضمن هذا العنصر السمات التالية الشائعة لجميع السياسات:

أمثلة

توضّح الأمثلة التالية بعض الطرق التي يمكنك من خلالها استخدام سياسة Spike Arrest:

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

<SpikeArrest async="false" continueOnError="false" enabled=">tru<e" name="SpikeAr<reast"
>  D<ispl>ayNam<e&>;<gtSpikeArrea>st/DisplayName
  Rate300pm/Rate
/SpikeArrest

<SpikeArrest name="Spike-Arre>st-<1&qu>ot;
<  Rat>e12<pm/Rate
  Identifier ref=&qu>ot;<client_id" /
  MessageWeight ref=">;<request.head>er.weight" /
/SpikeArrest

<SpikeArrest name="Spike-Arre>st-<1"
  Rate ref="request.header.>r<untime_rate&>quot; /
/SpikeArrest

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

مرجع العنصر الفرعي

يوضّح هذا القسم العناصر الفرعية من <SpikeArrest>.

<DisplayName>

استخدِم هذه السمة بالإضافة إلى السمة name لتصنيف السياسة في أداة تعديل وكيل واجهة مستخدم الإدارة باستخدام اسم مختلف وأكثر طبيعية.

العنصر <DisplayName> مشترك بين جميع السياسات.

يستخدم العنصر <DisplayName> البنية التالية:

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

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

لا يحتوي العنصر <DisplayName> على أي سمات أو عناصر فرعية.

<Identifier>

تتيح لك هذه السمة اختيار كيفية تجميع الطلبات حتى يمكن تطبيق سياسة Spike Arrest استنادًا إلى العميل. على سبيل المثال، يمكنك تجميع الطلبات حسب معرّف المطوّر، وفي هذه الحالة، سيتم احتساب طلبات كل مطوّر ضمن معدّل Spike Arrest الخاص به، وليس ضمن جميع الطلبات الموجّهة إلى الخادم الوكيل.

يجب استخدامها مع العنصر <MessageWeight> للتحكّم بشكل أكثر دقة في تقييد عدد الطلبات.

إذا تركت العنصر <Identifier> فارغًا، سيتم فرض حدّ واحد لعدد الطلبات على جميع الطلبات الواردة إلى خادم وكيل واجهة برمجة التطبيقات.

<SpikeArrest
  continueOnError="[false|true]"
  enabled="[true|false]"
 > na<me="policy_name"

  I>d<entifier ref>="flow_variable"/
/SpikeArrest
        

<SpikeArrest name="Spike-Arre>st-<1"
  Identifier ref=">;de<velo>per.<id&quo>t<;/
  Rate42p>m/Rate/
/SpikeArrest

يوضّح الجدول التالي سمات النوع <Identifier>:

تمت مناقشة هذا العنصر أيضًا في مشاركة "منتدى Apigee" التالية: Quota Identifier Across Different Policies.

<MessageWeight>

تحدّد هذه السمة عامل الترجيح المحدّد لكل رسالة. يعدّل وزن الرسالة تأثير طلب واحد على احتساب معدّل Spike Arrest. يمكن أن يكون وزن الرسالة أي متغير تدفق، مثل عنوان HTTP أو مَعلمة طلب بحث أو مَعلمة نموذج أو محتوى نص الرسالة. يمكنك أيضًا استخدام متغيرات مخصّصة باستخدام سياسة JavaScript أو سياسة AssignMessage.

استخدِمها مع <Identifier> لزيادة تقييد الطلبات حسب عملاء أو تطبيقات معيّنة.

على سبيل المثال، إذا كان حدّ Spike Arrest <Rate> هو 10pm، وأرسل تطبيق طلبات بوزن 2، سيتم السماح بخمس رسائل فقط في الدقيقة من هذا العميل لأنّ كل طلب يُحتسب على أنّه 2.

<SpikeArrest
  continueOnError="[false|true]"
  enabled="[true|false]"
 > na<me="policy_name"

  Mess>a<geWeight ref>="flow_variable"/
/SpikeArrest

<SpikeArrest name="Spike-Arre>st-<1&qu>ot;
<  Rat>e12<pm/Rate
  Identifier ref=&qu>ot;<client_id" /
  MessageWeight ref=">;<request.head>er.weight" /
/SpikeArrest

يوضّح الجدول التالي سمات النوع <MessageWeight>:

<Rate>

تحدّد هذه السمة معدّل الحدّ من الارتفاعات المفاجئة (أو الزيادات) في عدد الزيارات من خلال تحديد عدد الطلبات المسموح بها في فواصل زمنية مدتها دقيقة واحدة أو ثانية واحدة. يمكنك أيضًا استخدام هذا العنصر مع <Identifier> و<MessageWeight> للتحكّم بسلاسة في عدد الطلبات أثناء وقت التشغيل من خلال قبول القيم من العميل.

<SpikeArrest
  continueOnError="[false|true]"
  enabled="[true|false]"
 > na<me="policy_name&quo>t;

  Rate <ref=&>q<uot;flow_var>iable"rate[pm|ps]/Rate
/SpikeArrest

<SpikeArrest name="Spike-Arre>st-<1&qu>ot;<
  Ra>t<e5ps/Rate
/S>pikeArrest

<SpikeArrest async="false" continueOnError="false" enabled=">tru<e" name="SpikeAr<reast"
>  D<ispl>ayNam<e&>;<gtSpikeArrea>st/DisplayName
  Rate300pm/Rate
/SpikeArrest

يوضّح الجدول التالي سمات النوع <Rate>:

<Rate ref="request.header.custom_>rat<e&quo>t;1pm/Rate

<UseEffectiveCount>

توزّع هذه السياسة عدد عمليات إيقاف الارتفاع المفاجئ على "معالجات الرسائل" (MP) عند استخدام مجموعات التوسيع التلقائي.

<SpikeArrest
  continueOnError="[false|true]"
  enabled="[true|false]"
 > na<me="policy_n>ame"

 < UseEffectiveCount>[<false|true]/>UseEffectiveCount
/SpikeArrest

<SpikeArrest name='Spike-Arres>t-1<'>;
  <Rate4>0ps</Rate
  UseEffect>iveC<ounttrue/UseEffect>i<veCount
/Spi>keArrest

العنصر <UseEffectiveCount> اختياري. القيمة التلقائية هي false عند حذف العنصر من سياسة Spike Arrest.

يوضّح الجدول التالي سمات العنصر <UseEffectiveCount>:

يعتمد تأثير <UseEffectiveCount> على قيمته:

• true: الحدّ الأقصى لمعدّل الارتفاع المفاجئ في عدد وحدات البكسل الوسيطة هو <Rate> مقسومًا على العدد الحالي لوحدات البكسل الوسيطة في الحزمة نفسها. الحدّ الأقصى المجمّع هو قيمة <Rate>. عند إضافة مقاييس أداء بشكل ديناميكي (أو إزالتها)، ستزداد حدود معدّل الارتفاع الفردي (أو تنخفض)، ولكن سيظل الحدّ الإجمالي كما هو.
• false: الحدّ الأقصى لمعدّل الارتفاع المفاجئ لكل MP هو ببساطة قيمة <Rate>. الحدّ الأقصى المجمّع هو مجموع معدّلات جميع مقاييس الأداء. عند إضافة شركاء وسيطاء (أو إزالتهم)، ستبقى الحدود الفردية لمعدل الارتفاع المفاجئ كما هي، ولكن سيزيد الحد الإجمالي (أو ينخفض).

تستخدم سياسة SpikeArrest خوارزمية "حزمة الرموز المميزة" التي تعمل على تسوية الارتفاعات المفاجئة في عدد الزيارات من خلال تقسيم الحدّ الأقصى لمعدّل الزيارات الذي تحدّده إلى فواصل زمنية أصغر. من سلبيات هذه الطريقة أنّه يمكن رفض طلبات متعددة مشروعة واردة خلال فترة زمنية قصيرة.

على سبيل المثال، لنفترض أنّك أدخلت معدّل 30 طلبًا في الدقيقة. في مرحلة الاختبار، قد تعتقد أنّه يمكنك إرسال 30 طلبًا في ثانية واحدة، طالما أنّها تصل في غضون دقيقة واحدة. لكنّ السياسة لا تفرض الإعداد بهذه الطريقة. إذا فكّرت في الأمر، قد يتم اعتبار 30 طلبًا خلال فترة ثانية واحدة ارتفاعًا صغيرًا في بعض البيئات.

• يتم تعديل معدّلات الدقيقة الواحدة لتصبح طلبات كاملة مسموح بها في فواصل زمنية تبلغ ثوانٍ.
  

  على سبيل المثال، يتم تسوية 30 طلبًا في الدقيقة على النحو التالي:
  60 ثانية (دقيقة واحدة) / 30 طلبًا في الدقيقة = فواصل زمنية مدتها ثانيتان، أو يُسمح بطلب واحد كل ثانيتين. سيؤدي تقديم طلب ثانٍ خلال ثانيتَين إلى تعذُّر تنفيذه. بالإضافة إلى ذلك، سيتعذّر تنفيذ الطلب الحادي والثلاثين خلال دقيقة واحدة.

• يتم تعديل معدّلات الطلبات في الثانية لتصبح طلبات كاملة مسموح بها في فواصل زمنية بالمللي ثانية.

  على سبيل المثال، يتم تسوية 10ps على النحو التالي:
  1000 مللي ثانية (ثانية واحدة) / 10ps = فواصل زمنية تبلغ 100 مللي ثانية، أو يُسمح بطلب واحد كل 100 مللي ثانية. سيتعذّر تنفيذ طلب ثانٍ خلال 100 ملي ثانية. بالإضافة إلى ذلك، سيتعذّر تنفيذ الطلب الحادي عشر خلال ثانية واحدة.

يوضّح الجدول التالي تأثير <UseEffectiveCount> في الحدّ الأقصى الفعّال لمعدّل كل شريك وسيط:

في هذا المثال، لاحظ أنّه عند خفض عدد مرات الظهور من 4 إلى 2، وعندما تكون <UseEffectiveCount> هي false، يظلّ معدّل التكلفة الفعّالة لكلّ مرّة ظهور كما هو (10). ولكن عندما تكون قيمة <UseEffectiveCount> هي true، يتغيّر المعدّل الفعّال لكلّ مليون وحدة معالجة من 10 إلى 20 عند خفض عدد وحدات المعالجة من 4 إلى 2.

متغيرات التدفق

عند تنفيذ سياسة Spike Arrest، يتم ملء متغيّر التدفق التالي:

لمزيد من المعلومات، يُرجى الاطّلاع على مرجع لمتغيرات التدفق.

مرجع الخطأ

يصف هذا القسم رموز الخطأ ورسائل الخطأ التي يتم إرجاعها ومتغيراتها. التي يتم ضبطها من خلال Edge عندما تؤدي هذه السياسة إلى ظهور خطأ. من المهم معرفة هذه المعلومات إذا كنت تضع قواعد خطأ التعامل مع الأخطاء. لمزيد من المعلومات، يُرجى مراجعة معلومات يجب معرفتها حول أخطاء السياسة والتعامل مع المعالجة والأخطاء.

أخطاء بيئة التشغيل

يمكن أن تحدث هذه الأخطاء عند تنفيذ السياسة.

أخطاء النشر

يمكن أن تحدث هذه الأخطاء عند نشر خادم وكيل يحتوي على هذه السياسة.

متغيّرات الأخطاء

يتم ضبط هذه المتغيّرات عند حدوث خطأ في بيئة التشغيل. يمكنك الاطّلاع على مقالة ما تحتاج إلى معرفته للحصول على مزيد من المعلومات. حول أخطاء السياسة.

مثال على استجابة الخطأ

فيما يلي مثال على الرد على الخطأ:

{  
   "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 (خطأ في الخادم الداخلي)، اضبط قيمة السمة features.isHTTPStatusTooManyRequestEnabled على false باستخدام واجهة برمجة التطبيقات تعديل خصائص المؤسسة.

على سبيل المثال:

curl -u email:password -X POST -H "Content-type:application/xml" http://api.enterprise.apigee.com/v1/organizations/my<org -d \
"Organization type="trial&qu>ot; n<ame=">MyOrganiz<ation"
    Properties
        Property name="fea>ture<s.isHTTPS>tatusTooManyRequest<Enabled&quo>t<;true/Propert>y
        . . .
    /Properties
/Organization"

المخططات

يتم تحديد كل نوع من أنواع السياسات من خلال مخطّط XML (.xsd). وللحصول على مرجع، تتوفّر مخطّطات السياسات على GitHub.

مواضيع ذات صلة

• سياسة الحصة: سياسة الحصة، وذلك للحدّ من عدد الزيارات التي يتلقّاها كل عميل على حدة
• تقييد معدّل الزيارات للحصول على نظرة عامة حول تقييد معدّل الزيارات
• مقارنة بين سياسات Quota وSpikeArrest
• نماذج عملية لخوادم وكيلة لواجهة برمجة التطبيقات