Политика SpikeArrest

Вы просматриваете документацию Apigee Edge .
Перейти к документации Apigee X. info

Политика Spike Arrest защищает от скачков трафика с помощью элемента <Rate> . Этот элемент ограничивает количество запросов, обрабатываемых API-прокси и отправляемых на бэкэнд, защищая от задержек производительности и простоев.

Элемент <SpikeArrest>

Определяет политику ареста Spike.

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

Используйте в дополнение к атрибуту 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> пустым, для всех запросов к этому прокси-серверу 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>

Указывает вес, определенный для каждого сообщения. Вес сообщения изменяет влияние одного запроса на расчет скорости Spike Arrest. Вес сообщения может быть любой переменной потока, например, заголовком HTTP, параметром запроса, параметром формы или содержимым тела сообщения. Вы также можете использовать пользовательские переменные с помощью политики JavaScript или политики AssignMessage .

Используйте вместе с <Identifier> для дальнейшего ограничения запросов со стороны определенных клиентов или приложений.

Например, если Spike Arrest <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>

Распределяет количество Spike Arrest по процессорам сообщений (MP) при использовании групп автоматического масштабирования.

<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 , если элемент опущен в вашей политике Spike Arrest.

В следующей таблице описаны атрибуты элемента <UseEffectiveCount> :

Эффект <UseEffectiveCount> зависит от его значения:

• true : Предел скорости скачков MP равен <Rate> , деленный на текущее количество MP в одном модуле. Совокупный предел равен значению <Rate> . Когда MP динамически добавляются (или удаляются), их индивидуальные пределы скорости скачков будут увеличиваться (или уменьшаться), но совокупный предел останется прежним.
• false (это значение по умолчанию, если оно опущено): предел скорости скачков каждого MP — это просто значение его <Rate> . Совокупный предел — это сумма скоростей всех MP. Когда MP добавляются (или удаляются), их индивидуальные пределы скорости скачков останутся прежними, но совокупный предел увеличится (или уменьшится).

В следующей таблице показано влияние <UseEffectiveCount> на эффективный предел скорости каждого MP:

В этом примере обратите внимание, что когда количество MP уменьшается с 4 до 2, а <UseEffectiveCount> равен false , эффективная ставка на MP остается прежней (10). Но когда <UseEffectiveCount> равен true , эффективная ставка на MP увеличивается с 10 до 20, когда количество MP уменьшается с 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 для превышения ограничения скорости, установленного политикой квоты или Spike Arrest, — 429 (слишком много запросов). Чтобы изменить код статуса HTTP на 500 (внутренняя ошибка сервера), установите свойство features.isHTTPStatusTooManyRequestEnabled в значение false с помощью API обновления свойств организации .

Например:

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.

Похожие темы

• Политика квот : Политика квот для ограничения трафика для отдельных клиентов.
• Ограничение скорости для обзора ограничения скорости
• Сравнение политик квот и SpikeArrest
• Рабочие образцы API-прокси