SpikeArest की नीति

आपको Apigee Edge दस्तावेज़ दिख रहा है.
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है इस पेज पर जाएं Apigee X दस्तावेज़. जानकारी

स्पाइक अरेस्ट नीति, <Rate> एलिमेंट का इस्तेमाल करके ट्रैफ़िक में होने वाली बढ़ोतरी से बचाती है. यह एलिमेंट, एपीआई प्रॉक्सी से प्रोसेस होने वाले और बैकएंड को भेजे गए अनुरोधों की संख्या को थ्रॉटल करता है, इससे परफ़ॉर्मेंस में होने वाली देरी और डाउनटाइम से बचने में मदद मिलती है.

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

इस एलिमेंट में ये एट्रिब्यूट शामिल होते हैं, जो सभी नीतियों में शामिल हैं:

उदाहरण

इन उदाहरणों में बताया गया है कि किस तरह से, स्पाइक अरेस्ट नीति का इस्तेमाल किया जा सकता है:

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

<SpikeArrest name="Spike-Arrest-1">
  <Rate>12pm</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>

name एट्रिब्यूट के साथ-साथ, नीति को मैनेज करने वाले यूज़र इंटरफ़ेस (यूआई) प्रॉक्सी एडिटर में, नीति को किसी ऐसे नाम से लेबल करें जो सामान्य हो और सुनने में अच्छा लगे.

<DisplayName> एलिमेंट सभी नीतियों में एक जैसा होता है.

<DisplayName> एलिमेंट में इस सिंटैक्स का इस्तेमाल किया जाता है:

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

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

<DisplayName> एलिमेंट में कोई एट्रिब्यूट या चाइल्ड एलिमेंट नहीं है.

<Identifier>

इससे अनुरोधों को ग्रुप करने का तरीका चुना जा सकता है, ताकि ज़रूरत के हिसाब से स्पाइक अरेस्ट नीति लागू की जा सके क्लाइंट-साइड पर. उदाहरण के लिए, डेवलपर आईडी के हिसाब से अनुरोधों को ग्रुप में रखा जा सकता है. इस मामले में, हर डेवलपर के अनुरोधों की गिनती, उनके निजी स्पाइक अरेस्ट रेट में की जाएगी, न कि प्रॉक्सी.

ज़्यादा सटीक जानकारी के लिए, <MessageWeight> एलिमेंट के साथ इस्तेमाल करें रिक्वेस्ट थ्रॉटलिंग पर कंट्रोल.

<Identifier> एलिमेंट को खाली छोड़ने पर, सभी अनुरोधों के लिए अनुरोध की एक सीमा लागू हो जाती है उस एपीआई प्रॉक्सी में स्विच कर सकते हैं.

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

हर मैसेज के लिए तय की गई महत्व की जानकारी देता है. संदेश भार प्रभाव को संशोधित करता है की गणना के लिए एक अनुरोध किया है. मैसेज का वज़न कोई भी हो सकता है फ़्लो वैरिएबल, जैसे कि एचटीटीपी हेडर, क्वेरी पैरामीटर, फ़ॉर्म पैरामीटर या मैसेज का मुख्य कॉन्टेंट. आप JavaScript नीति या assignMessage की नीति.

अनुरोधों का आगे बढ़ने के लिए, <Identifier> के साथ इस्तेमाल करें खास क्लाइंट या ऐप्लिकेशन पर भेज सकते हैं.

उदाहरण के लिए, अगर स्पाइक अरेस्ट <Rate> 10pm है और कोई ऐप्लिकेशन सबमिट करता है 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 name="Spike-Arrest-1">
  <Rate>12pm</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> की वैल्यू सबमिट करें. कुल सीमा, सभी सांसदों के रेट का कुल योग होता है. सदस्यों को जोड़ने (या हटाए जाने) पर, बढ़ोतरी की दर की सीमाएं पहले जैसी ही रहेंगी. हालांकि, एग्रीगेट सीमा बढ़ जाएगी (या घटता है).

नीचे दी गई टेबल में, कन्वर्ज़न रेट की सीमा पर <UseEffectiveCount> का असर दिखाया गया है हर एमपी में:

इस उदाहरण में ध्यान दें कि जब सांसद की संख्या 4 से 2 हो जाती है, और <UseEffectiveCount> false है. हर एमपी में लागू होने वाली दर में कोई बदलाव नहीं होगा (इससे 10). हालांकि, <UseEffectiveCount> के true होने पर, हर एमपी से लागू होने वाली दर इस तरीके से होती है: 10 से 20 तब, जब एमपी की संख्या 4 से 2 हो जाए.

फ़्लो वैरिएबल

स्पाइक अरेस्ट नीति के लागू होने पर, यह फ़्लो वैरिएबल अपने-आप भर जाता है:

ज़्यादा जानकारी के लिए, फ़्लो वैरिएबल रेफ़रंस देखें.

गड़बड़ी का रेफ़रंस

इस सेक्शन में, गड़बड़ी के कोड और गड़बड़ी के मैसेज के साथ-साथ गड़बड़ी के वैरिएबल के बारे में बताया गया है ये सेटिंग, 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>

कोटा या स्पाइक अरेस्ट नीति की ओर से सेट की गई दर सीमा को पार करने के लिए मौजूदा एचटीटीपी स्टेटस कोड 429 है (बहुत ज़्यादा अनुरोध). एचटीटीपी स्टेटस कोड को 500 में बदलने के लिए (आंतरिक सर्वर गड़बड़ी), इसका इस्तेमाल करके false को features.isHTTPStatusTooManyRequestEnabled प्रॉपर्टी संगठन की प्रॉपर्टी अपडेट करें एपीआई.

उदाहरण के लिए:

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

स्कीमा

हर तरह की नीति को एक्सएमएल स्कीमा (.xsd) से तय किया जाता है. रेफ़रंस के लिए, नीति के स्कीमा GitHub पर उपलब्ध हैं.

मिलते-जुलते विषय

• कोटा नीति: कोटा नीति, ताकि अलग-अलग क्लाइंट पर ट्रैफ़िक सीमित किया जा सके
• अनुरोध संख्या सीमित करने के लिए अनुरोध संख्या सीमित करना खास जानकारी
• तुलना करना कोटा और SpikeAreest की नीतियां
• एपीआई प्रॉक्सी के काम करने के सैंपल