503 Служба недоступна — NoActiveTargets

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

Видео

Дополнительные сведения об ошибках 503 см. в следующих видеороликах:

Симптом

Клиентское приложение получает код состояния ответа HTTP 503 с сообщением «Служба недоступна» и кодом ошибки NoActiveTargets для запросов прокси-сервера API.

Сообщение об ошибке

Вы увидите следующий ответ об ошибке:

HTTP/1.1 503 Service Unavailable
  

В ответе HTTP вы увидите следующее сообщение об ошибке:

{
   "fault": {
      "faultstring": "The Service is temporarily unavailable",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.NoActiveTargets"
       }
    }
}
  

Возможные причины

HTTP-ответ 503 Service Unavailable с кодом ошибки NoActiveTargets обычно наблюдается, когда вы используете один или несколько целевых серверов в конфигурации целевой конечной точки в вашем прокси-сервере API.

В следующей таблице перечислены возможные причины ответа 503 Service Unavailable с кодом ошибки NoActiveTargets :

Причина: целевой сервер отключен.

Если все целевые серверы, указанные в конфигурации целевой конечной точки, отключены, вы получите ответ 503 Service Unavailable с кодом ошибки NoActiveTargets.

Диагностика

1. Определите имя целевого сервера, используемого в конкретной конфигурации целевой конечной точки неисправного прокси-сервера API, одним из следующих способов:
1. Если есть одна целевая конечная точка, проверьте эту конкретную целевую конечную точку.
2. Если существует несколько целевых конечных точек и вы не уверены, какая из них отключила целевой сервер, выполните следующие действия:
1. Включите сеанс трассировки , выполните вызов API и воспроизведите проблему — 503 Служба недоступна.
2. В трассировке перейдите к Target Request Flow Started и определите имя целевой конечной точки, как показано ниже:



2. После того как вы определили целевую конечную точку, получите используемое имя целевого сервера из конфигурации целевой конечной точки, как показано в примере ниже:

   <TargetEndpoint name="default">>
     <HTTPTargetConnection>
       <LoadBalancer>
         <Server name="demo-target" />
       </LoadBalancer>
       <Path>/test</Path>
     </HTTPTargetConnection>
   </TargetEndpoint>
         

   В приведенном выше примере имеется один целевой сервер с именем demo-target .

3. Получите определение для каждого целевого сервера, используемого в целевой конечной точке, с помощью пользовательского интерфейса Edge или вызова API Edge.

   Пограничный интерфейс

   Чтобы получить определение с помощью пользовательского интерфейса Edge:

   1. Перейдите в «Администратор» > «Среды» > «Целевые серверы» .
   2. Выберите конкретную среду, в которой вы видите сбой.
   3. Найдите конкретное имя целевого сервера, чтобы получить определение целевого сервера.

      Например, введите имя целевого сервера demo-target , и вы увидите его определение, как показано ниже:

      

      Обратите внимание, что демонстрационная цель целевого сервера имеет псевдоним хоста, номер порта и включен SSL. Однако сам целевой сервер отключен, на что указывает элемент ENABLED , выделенный серым цветом.

   Пограничный API

   Чтобы получить определение с помощью Edge API:

   Используйте API Get TargetServer, чтобы получить определение целевого сервера.

   Вывод определения целевого сервера

   <TargetServer name="demo-target">
     <Host>demo-target.apigee.net</Host>
     <Port>443</Port>
     <IsEnabled>false</IsEnabled>
     <SSLInfo>
         <Enabled>true</Enabled>
     </SSLInfo>
   </TargetServer>
             

   Вывод API Apigee показывает, что демонстрационная цель целевого сервера отключена , поскольку для элемента IsEnabled установлено значение false.

   Поскольку целевой сервер отключен, процессор сообщений немедленно отправит клиенту сообщение 503 Service Unavailable с кодом ошибки NoActiveTargets .

Разрешение

Убедитесь, что определенные целевые серверы, используемые в конфигурации целевой конечной точки вашего прокси-сервера API, всегда включены.

<TargetServer name="demo-target">
  <Host>demo-target.apigee.net</Host>
  <Port>443</Port>
  <IsEnabled>true</IsEnabled>
  <SSLInfo>
      <Enabled>true</Enabled>
  </SSLInfo>
</TargetServer>
        

Если проблема не устранена, перейдите к разделу «Необходимо собрать диагностическую информацию» .

Диагностика проблем с помощью мониторинга API

Мониторинг API позволяет быстро изолировать проблемные области для диагностики ошибок, проблем с производительностью и задержкой, а также их источников, таких как приложения для разработчиков, прокси-серверы API, целевые серверные части или платформа API.

Ознакомьтесь с примером сценария , который демонстрирует, как устранять проблемы 5xx с вашими API с помощью мониторинга API. Например, вы можете настроить оповещение, которое будет уведомляться, когда количество ошибок messaging.adaptors.http.flow.NoActiveTargets превышает определенный порог.

Необходимо собрать диагностическую информацию

Если проблема не устранена даже после выполнения приведенных выше инструкций, соберите следующую диагностическую информацию. Свяжитесь со службой поддержки Apigee и поделитесь ими:

1. Если вы являетесь пользователем Public Cloud, предоставьте следующую информацию:
1. Название организации
2. Имя среды
3. Имя прокси API
4. Завершите команду Curl, чтобы воспроизвести ошибку.
5. Файл трассировки, содержащий запросы с кодом 503 Service Unavailable и кодом ошибки NoActiveTargets.
2. Если вы являетесь пользователем частного облака, предоставьте следующую информацию:
   1. Обнаружено полное сообщение об ошибке
   2. Имя среды
   3. Пакет API-прокси
   4. Файл трассировки, содержащий запросы с кодом 503 Service Unavailable и кодом ошибки NoActiveTargets.
   5. Журналы доступа NGINX

      ( /opt/apigee/var/log/edge-router/nginx/<org>~<env>.<port#>_access_log /var/log/edge-router/nginx/<org>~<env>.<port#>_access_log)

   6. Журналы процессора сообщений

      ( /opt/apigee/var/log/edge-message-processor/logs/system.log )