Сервис недоступен (ошибка 503).

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

Видео

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

Symptom

Клиентское приложение получает код статуса HTTP 503 с сообщением Сервис недоступен после вызова прокси API.

Сообщения об ошибках

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

HTTP/1.1 503 Service Unavailable
      

В ответе HTTP также может появиться следующее сообщение об ошибке:

Сервис недоступен

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

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

HTTP-ответ 503 Service Unavailable с кодом ошибки messaging.adaptors.http.flow.ServiceUnavailable возникает, если Message Processor Apigee Edge сталкивается с ошибками из-за истечения времени ожидания подключения, неправильного имени хоста или сбоев при установлении защищенного соединения SSL при взаимодействии с бэкенд-сервером.

Возможные причины ответа 503 Service Unavailable:

Распространенные этапы диагностики

Как определить идентификатор сообщения для запроса, который не удалось выполнить

Ошибки подключения из-за неправильного DNS-преобразования

диагностика;

1. Определите идентификатор сообщения, вызвавшего ошибку.
2. Найдите в журнале Message Processor (/opt/apigee/var/log/edge-message-processor/logs/system.log) идентификатор нужного запроса. Вы можете увидеть следующие ошибки:
   
   Ошибка onConnectTimeout означает, что Message Processor не смог подключиться к бэкенд-серверу в течение заданного времени ожидания (по умолчанию 3 секунды).

   2019-08-14 09:11:49,314 org:myorg env:prod api:Employees rev:1 messageid:mo-96cf6757a-9401-21-1 NIOThread@0 ERROR HTTP.CLIENT - HTTPClient$Context.onTimeout() : ClientChannel[Connected:]@164162 useCount=1 bytesRead=0 bytesWritten=0 age=3001ms lastIO=3001ms .onConnectTimeout connectAddress=www.abc.com/11.11.11.11  resolvedAddress=www.abc.com/22.22.22.22
   
   2019-08-14 09:11:49,333 org:myorg env:prod api:Employees rev:1 messageid:mo-96cf6757a-9401-21-1 NIOThread@0 ERROR ADAPTORS.HTTP.FLOW - RequestWriteListener.onTimeout() : RequestWriteListener.onTimeout(HTTPRequest@6b393600)
         

3. Запишите IP-адрес, указанный в ошибке onConnectTimeout, и проверьте, действителен ли он для вашего внутреннего сервера. Если IP-адрес действителен, перейдите к разделу Ошибки подключения.
4. Если IP-адрес недействителен, скорее всего, это связано с проблемами с разрешением DNS.
5. Повторите шаги 3 и 4 для нескольких других неудачных запросов API и проверьте, видите ли вы те же или другие недействительные IP-адреса.
6. Найдите в журнале Message Processor (/opt/apigee/var/log/edge-message-processor/logs/system.log) сообщения с ключевым словом DNS Refresh. Проверьте, не добавляются ли в DNS-кеш на Message Processor время от времени недействительные IP-адреса.

   2019-08-14 09:11:49,314 org:myorg env:prod api:Employees rev:1 messageid:mo-96cf6757a-9401-21-1 NIOThread@0 INFO c.a.p.h.d.DNSCachedAddress - DNSCachedAddress.reportDifferences() : DNS Refresh for host: apitarget-uat.schemeweb.co.uk:4436. Added 2 IPs [www.abc.com/22.22.22.22, www.abc.com/33.33.33.33] Removed 1 IPs [www.abc.com/11.11.11.11]
         

7. Эта проблема может возникнуть, если есть какие-либо проблемы с авторитетными DNS-серверами или серверами доменных имен, настроенными в /etc/resolv.conf.
   
   Как правило, для выполнения DNS-преобразования настраивается один или несколько авторитетных DNS-серверов. Если авторитетных DNS-серверов нет, то будет использоваться конфигурация, заданная в правиле /etc/resolv.conf, и DNS-преобразование будет выполнено соответствующим образом. Например, если /etc/resolv.conf настроен на использование определенных серверов доменных имен, то именно они будут использоваться для DNS-преобразования.
8. Если возникнут проблемы с авторитетными DNS-серверами или серверами имен, указанными в /etc/resolv.conf, имена хостов внутреннего сервера будут преобразованы в неверные или недействительные IP-адреса. Недействительные IP-адреса будут сохранены в кеше DNS Message Processor.
   1. Если проблема с авторитетными DNS-серверами или серверами доменных имен, указанными в /etc/resolv.conf, не устранена, то недействительные IP-адреса будут и дальше оставаться в кеше DNS Message Processor. Пока неверные IP-адреса хранятся в кеше DNS Message Processor, запросы ко всем API, использующим определенный бэкенд-сервер, будут завершаться ошибкой 503.
   2. Если проблема с авторитетными DNS-серверами или серверами доменных имен, указанными в /etc/resolv.conf, возникает время от времени, то в кеше DNS будут периодически сохраняться как хорошие, так и плохие IP-адреса. В этом случае вы будете периодически получать ошибки 503 для всех API, использующих определенный сервер.
9. Если проблема с DNS-серверами не устранена, вы будете постоянно видеть ошибки. Если проблема с DNS-серверами возникает время от времени, то и ошибки будут появляться время от времени. То есть всякий раз, когда имя хоста внутреннего сервера разрешается в неправильные IP-адреса, вы видите ошибки 503. Если имена хостов внутреннего сервера будут разрешены в действительные IP-адреса, вы увидите успешные ответы.

Разрешение

Обратитесь к администратору операционной системы и устраните проблемы с DNS-серверами.

1. Если проблема связана с авторитетными DNS-серверами или серверами имен, указанными в /etc/resolv.conf, устраните ее на соответствующем сервере.
2. Если в /etc/resolv.conf на системах с процессорами сообщений есть проблемы с конфигурацией, устраните их.

Ошибки подключения

Ошибка подключения возникает, когда Message Processor Apigee Edge пытается подключиться к серверу бэкэнда и происходит одна из следующих проблем:

• Message Processor не может подключиться в течение заданного времени ожидания подключения. Значение по умолчанию: 3 секунды.
• Внутренний сервер отклоняет подключение.

диагностика;

1. Определите идентификатор сообщения, вызвавшего ошибку.
2. Найдите идентификатор сообщения запроса в журнале Message Processor (/opt/apigee/var/log/edge-message-processor/logs/system.log). Вы можете увидеть следующие ошибки:
   1. Ошибка onConnectTimeout означает, что Message Processor не удалось подключиться к бэкенд-серверу в течение заданного времени ожидания подключения.

      2016-06-23 09:11:49,314 org:myorg env:prod api:Employees rev:1 messageid:mo-96cf6757a-9401-21-1 NIOThread@2 ERROR HTTP.CLIENT - HTTPClient$Context.onTimeout() : ClientChannel[C:]@10 useCount=1 bytesRead=0 bytesWritten=0 age=3001ms lastIO=3001ms .onConnectTimeout connectAddress=www.abc.com/11.11.11.11:80 resolvedAddress=www.abc.com/11.11.11.11
      2016-06-23 09:11:49,333 org:myorg env:prod api:Employees rev:1 messageid:mo-96cf6757a-9401-21-1 NIOThread@2 ERROR ADAPTORS.HTTP.FLOW - RequestWriteListener.onTimeout() : RequestWriteListener.onTimeout(HTTPRequest@6b393600)

   2. Ошибка java.net.ConnectException: Connection refused означает, что внутренний сервер отклонил подключение.

      14:40:16.531 +0530
      2016-06-17 09:10:16,531 org:myorg env:prod api:www.abc.com rev:1 rrt07eadn-22739-40983870-15 NIOThread@2 ERROR HTTP.CLIENT - HTTPClient$Context.onConnectFailure() : connect to www.abc.com:11.11.11.11:443 failed with exception {}
      java.net.ConnectException: Connection refused
      at sun.nio.ch.SocketChannelImpl.checkConnect(Native Method) ~[na:1.7.0_75]
      at sun.nio.ch.SocketChannelImpl.finishConnect(SocketChannelImpl.java:739) ~[na:1.7.0_75]
      at com.apigee.nio.ClientChannel.finishConnect(ClientChannel.java:121) ~[nio-1.0.0.jar:na]
      at com.apigee.nio.handlers.NIOThread.run(NIOThread.java:108) ~[nio-1.0.0.jar:na]

3. Проверьте, можете ли вы подключиться к определенному серверу напрямую с каждого процессора сообщений, используя команду telnet:
   1. Если внутренний сервер сопоставляется с одним IP-адресом, используйте следующую команду:

      telnet BackendServer-IPaddress 443
                

   2. Если серверу назначено несколько IP-адресов, используйте имя хоста сервера в команде telnet, как показано ниже:

      telnet BackendServer-HostName 443
                

4. Если вам удалось подключиться к внутреннему серверу, вы можете увидеть сообщение, например Connected to backend-server. Если вам не удается подключиться к серверу, возможно, IP-адреса процессоров сообщений не добавлены в белый список на этом сервере.

Разрешение

Предоставьте доступ к IP-адресам обработчика сообщений на определенном внутреннем сервере, чтобы разрешить трафику от обработчиков сообщений Edge доступ к внутреннему серверу. Например, в Linux можно использовать iptables, чтобы разрешить трафик с IP-адресов обработчика сообщений на внутреннем сервере.

Если проблема не исчезнет, обратитесь к администратору сети, чтобы определить и устранить ее. Если вам нужна помощь Apigee, обратитесь в службу поддержки Apigee.

Неправильное имя хоста целевого сервера

диагностика;

Если имя хоста, указанное на целевом сервере, неправильное, вы можете получить ответ 503 Service Unavailable с кодом ошибки messaging.adaptors.http.flow.ServiceUnavailable.

Разрешение

1. Убедитесь, что имя хоста целевого сервера, указанное в конфигурации конечной точки целевого сервера или в определении целевого сервера, правильное и не содержит лишних пробелов или специальных символов.
2. Если вы используете правило AssignMessage/JavaScript для динамического создания имени хоста целевого сервера, проверьте определение правила и код и убедитесь, что имя хоста целевого сервера создается правильно.

Сбои при подтверждении SSL

Целая инструкция по устранению неполадок посвящена ошибкам рукопожатия TLS/SSL. Подробнее о сбоях при подтверждении SSL…

Как определить источник проблемы

Определенные типы ошибок могут возникать как при входящем (северном), так и при исходящем (южном) подключении. Входящая (северная) ошибка возникает между клиентским приложением и Edge. Исходящая (южная) ошибка возникает между Edge и целевым сервером. Чтобы диагностировать такие проблемы, сначала нужно выяснить, где возникает ошибка: в северном или южном подключении.

Как работают подключения к северным и южным серверам

В Edge ошибка 503 "Сервис недоступен" может возникнуть при входящем или исходящем подключении:

• Входящее (или северное) подключение – подключение между клиентским приложением и маршрутизатором Edge. Маршрутизатор – это компонент Apigee Edge, который обрабатывает входящие запросы к системе.
• Исходящее (или нисходящее) соединение – соединение между Message Processor Edge и внутренним сервером. Message Processor – это компонент Apigee Edge, который перенаправляет запросы API на целевые серверы.

Если вы используете общедоступное облако Edge, вам, вероятно, неизвестны внутренние компоненты, такие как маршрутизатор или Message Processor. Эти внутренние компоненты не видны и недоступны пользователям общедоступного облака. По возможности мы предлагаем альтернативные способы устранения неполадок, не требующие прямого доступа к этим компонентам.

На рисунке ниже показаны входящие и исходящие подключения для Apigee Edge.

Как определить, где произошла ошибка 503: сервис недоступен

Чтобы определить, где произошла ошибка 503 (Сервис недоступен), в исходящем или входящем подключении, выполните одно из следующих действий.