19.03.01 — Примечания к выпуску Apigee Edge для публичного облака

Балансировка нагрузки — расширенные возможности управления процессом отключения неисправных серверов.

При настройке балансировщика нагрузки для API-прокси можно определить, сколько ошибок ответа произойдет до того, как сервер будет исключен из ротации балансировки нагрузки. Ошибка ответа означает, что Apigee не получает ответа от целевого сервера. В этом случае счетчик ошибок увеличивается на единицу. Если Apigee получает ответ от целевого сервера, даже если это ошибка HTTP (например, 500), это засчитывается как ответ от целевого сервера, и счетчик ошибок сбрасывается. Чтобы гарантировать, что некорректные ответы HTTP (например, 500) также увеличивают счетчик ошибок, чтобы как можно скорее исключить неработоспособный сервер из ротации балансировки нагрузки, можно добавить новый элемент <ServerUnhealthyResponse> с дочерними элементами <ResponseCode> в конфигурацию балансировщика нагрузки. Edge также будет учитывать ответы с этими кодами как ошибки.

<HTTPTargetConnection>
  <LoadBalancer>
    <Algorithm>RoundRobin</Algorithm>
    <Server name="target1" />
    <Server name="target2" />
    <ServerUnhealthyResponse>
        <ResponseCode>500</ResponseCode>
        <ResponseCode>502</ResponseCode>
        <ResponseCode>503</ResponseCode>
    </ServerUnhealthyResponse>
    <MaxFailures>5</MaxFailures>
  </LoadBalancer>
</HTTPTargetConnection>
  
  

Улучшения политики AccessControl

Политика AccessControl определяет, какие IP-адреса могут совершать вызовы к API-прокси. Новый элемент в этой политике предоставляет разработчикам API больше возможностей для определения того, какие IP-адреса следует проверять.

<IgnoreTrueClientIPHeader> : Необязательный параметр (по умолчанию - false). Если установить значение true, политика игнорирует заголовок True-Client-IP и оценивает IP-адреса в заголовке X-Forwarded-For в соответствии с настроенным вами поведением оценки X-Forwarded-For .

<AccessControl async="false" continueOnError="false"
    enabled="true" name="Access-Control-1">
    <DisplayName>Access Control-1</DisplayName>
    <IgnoreTrueClientIPHeader>true</IgnoreTrueClientIPHeader>
    ...
</AccessControl>

Подробности смотрите в этом сообщении на форуме сообщества .

В политике RaiseFault появились два новых элемента, которые делают обработку правил FaultRules более понятной и эффективной.

• ShortFaultReason — это логическое значение, которое, если установлено в true, помещает имя политики в переменную fault.reason.
• AssignVariable , доступный в объекте FaultResponse, позволяет присвоить ответ об ошибке переменной, которая будет использоваться другими политиками в потоке API-прокси.

В настоящее время действуют ограничения на количество размещенных целевых объектов. Подробную информацию об ограничениях см. в разделе «Ограничения».

Теперь вы можете использовать переменные шаблона сообщений для установки IP-адресов и масок CIDR в политике AccessControl . Например, если вы хотите сохранить IP-адрес и маску в карте ключ-значение (KVM), вы можете получить эти значения из переменной, которую вы установили в потоке API-прокси. Это позволяет проще изменять значения IP-адресов во время выполнения без необходимости изменения конфигурации политики.

Например, вместо:

<MatchRule action="DENY">
    <SourceAddress mask="24">198.51.100.1</SourceAddress>
</MatchRule>
     

Политику можно настроить следующим образом, предполагая, что значения хранятся в KVM, и вы используете политику KeyValueMapOperations для получения значений и присвоения их переменным, показанным здесь:

<MatchRule action="DENY">
    <SourceAddress mask="{kvm.mask.ref}">{kvm.ip.ref}</SourceAddress>
</MatchRule>
     

Мониторинг API предоставляет две роли: администратор мониторинга API и пользователь мониторинга API, описанные в разделе «Доступ к мониторингу API» . Эти роли стали доступны в декабре 2018 года.

Теперь Edge добавляет заголовок X-Apigee.Message-Timeout к каждому запросу. Этот заголовок используется Edge внутри системы. Не полагайтесь на значения в заголовках X-Apigee.* в ваших API-прокси, поскольку эти заголовки не предназначены для использования клиентами и могут быть удалены или изменены Apigee в любое время.

Обрабатывайте ошибки удаления хранилища ключей, чтобы вызов API не завершался с ошибкой.

Параметр x-apigee.edge.execution.sense.action всегда имеет значение null.

В политике ResponseCache поток NIOTheread выполняется без отклонения пулом потоков.

Использование нескольких экспортеров логов на маршрутизаторах Apigee приводит к высокой загрузке ЦП.

Периодические ошибки 404 в отдельных организациях

Развернутый общий поток не выполняется в некоторых обработчиках сообщений.

Это исправление будет включено в следующий релиз Edge for Private Cloud.

Это исправление будет включено в следующий релиз Edge for Private Cloud.

Это исправление будет включено в следующий релиз Edge for Private Cloud.