Вы просматриваете документацию по Apigee Edge.
Перейдите к документации по Apigee X. Информация
Любые ошибки, проблемы с задержкой или неожиданные результаты, наблюдаемые при выполнении запросов к API, называются проблемами runtime.
Ошибки 4XX/5XX
Пособие для авторов
В этом разделе приведена информация и инструкции по устранению ошибок времени выполнения 4XX и 5XX.
| Сообщение об ошибке | Код ошибки | Пособие для авторов |
|---|---|---|
HTTP/1.1 500 Internal Server Error |
Зависит от ошибки |
500 Internal Server Error
и |
HTTP/1.1 503 Service Unavailable |
messaging.adaptors.http.flow.ServiceUnavailable |
503 Service Unavailable |
HTTP/1.1 503 Service Unavailable |
messaging.adaptors.http.flow.NoActiveTargets |
503 Service Unavailable - NoActiveTargets |
HTTP/1.1 503 Service Unavailable |
messaging.adaptors.http.flow.NoActiveTargets
(Причина – сбои при проверке состояния) |
503 Service Unavailable - NoActiveTargets Health Check Failures |
HTTP/1.1 503 Service Unavailable
(с бэкенд-сервера) |
messaging.adaptors.http.flow.ErrorResponseCode
|
503 Service Unavailable - Backend Server |
HTTP/1.1 504 Gateway Timeout |
messaging.adaptors.http.flow.GatewayTimeout |
Превышено время ожидания шлюза (ошибка 504) |
HTTP/1.1 504 Gateway Timeout
(с бэкенд-сервера) |
messaging.adaptors.http.flow.ErrorResponseCode
|
504 Gateway Timeout - Backend Server |
Информация о диагностике
Если вам нужна помощь службы поддержки Apigee Edge в связи с ошибками времени выполнения 4XX (например, 400, 401, 404 и 499) или ошибками 5XX (например, 500, 503 и 504), соберите и предоставьте в запросе в службу поддержки следующие диагностические журналы и информацию:
| Данные диагностики | Где можно найти эту информацию? | Как собрать эту информацию? |
|---|---|---|
| Выходные данные инструмента трассировки, в которых зафиксированы неудачные запросы к API | Интерфейс Edge | Как использовать инструмент трассировки |
| Журналы маршрутизатора | Маршрутизатор |
tar cvzf /tmp/router_logs_ORGNAME_ENVNAME_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-router/nginx/ORGNAME~ENVNAME.* |
| Журналы процессора сообщений | Message Processor |
tar cvzf /tmp/rmp_systemlogs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-message-processor/logs/system* |
| Сжать все данные диагностики |
>tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_* |
Ошибка 400: неверный запрос – ошибка сертификата SSL
Пособие для авторов
В этом разделе приведена информация и рекомендации по некоторым процедурам, которые можно выполнить для устранения неполадок и решения проблемы 400 Bad Request - SSL Certificate Error.
| Сообщение об ошибке | Пособие для авторов |
|---|---|
<html>
<head>
<title>400 The SSL certificate error</title>
</head>
<body bgcolor="white">
<center> <h1>400 Bad Request</h1>
</center>
<center>The SSL certificate error</center>
<hr>
<center>nginx</center>
</body>
</html> |
Ошибка 400 (неверный запрос) – ошибка сертификата SSL |
Данные диагностики
Если вам нужна помощь службы поддержки Apigee Edge по поводу 400 Bad Request - SSL Certificate
Error, соберите следующую диагностическую информацию и поделитесь ею в запросе в службу поддержки:
| Данные диагностики | Где можно найти эту информацию? | Как собрать эту информацию? |
|---|---|---|
| Журналы маршрутизатора | Маршрутизатор |
tar cvzf /tmp/router_logs_ORGNAME_ENVNAME_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-router/nginx/ORGNAME~ENVNAME.* |
Tcpdumps |
Маршрутизатор |
Перехватите сетевые пакеты с помощью команды sudo tcpdump -s 0 -i any host CLIENT_HOST_IP_ADDRESS -w /tmp/router_tcpdump_$(hostname).pcap Чтобы сжать файл tar cvzf /tmp/router_tcpdumps_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /tmp/router_tcpdump_$(hostname).pcap |
Tcpdumps |
Клиентский компьютер |
Захватите сетевые пакеты с помощью команды tcpdump на клиентском компьютере: sudo tcpdump -s 0 -i any host VIRTUAL_HOST_ALIAS -w /tmp/client_tcpdump_$(hostname).pcap Чтобы сжать файл tar cvzf /tmp/client_tcpdumps_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /tmp/router_tcpdump_$(hostname).pcap |
| Сжать все данные диагностики. | Маршрутизатор |
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* |
Ошибка 404: не удалось определить прокси-сервер для хоста
Пособие для авторов
В этом разделе приведена информация и инструкции по устранению ошибки 404 Unable to identify proxy for host.
| Сообщение об ошибке или ее описание | Код ошибки | Пособие для авторов |
|---|---|---|
HTTP/1.1 404 Not Found { "fault":{ "faultstring":"Unable to identify proxy for host: VIRTUAL_HOST_NAME and url: PATH", "detail":{ "errorcode":"messaging.adaptors.http.flow.ApplicationNotFound" } } } |
messaging.adaptors.http.flow.ApplicationNotFound |
404 Не удается определить прокси-сервер для хоста |
Данные диагностики
Если вам нужна помощь службы поддержки Apigee Edge в устранении ошибки 404 Unable to identify proxy for
host, соберите следующую диагностическую информацию и поделитесь ею в запросе в службу поддержки:
| Данные диагностики | Где можно найти эту информацию? | Как собрать эту информацию? |
|---|---|---|
| Выходные данные Deployments API | Сервер управления |
curl -s http://MANAGEMENT_SERVER_HOST:8080/v1/organizations/ORGNAME/environments/ENVNAME/apis/APINAME/deployments > /tmp/deployments_output_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).json |
| Выходные данные API и дерева классификации | Message Processor |
Чтобы загрузить среды для определенной организации, выполните следующие действия: curl -s 0:8082/v1/runtime/organizations/ORGNAME/environments > /tmp/rmp_environments_list_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).txt Чтобы получить развернутые версии для определенного прокси API: curl -s 0:8082/v1/runtime/organizations/ORGNAME/environments/ENVNAME/apis/APINAME/revisions > /tmp/rmp_api_APINAME_revisions_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).txt Чтобы получить дерево классификации: curl -s 0:8082/v1/classification/tree > /tmp/rmp_classification_tree_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).json |
| Журналы процессора сообщений | Message Processor |
tar cvzf /tmp/rmp_systemlogs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-message-processor/logs/system* tar cvzf /tmp/rmp_transactionlogs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-message-processor/logs/transactions* tar cvzf /tmp/rmp_configurationlogs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-message-processor/logs/configurations* tar cvzf /tmp/rmp_system_monitor_config_mp_logs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-message-processor/edge-message-processor* /opt/apigee/var/log/edge-message-processor/config* /opt/apigee/var/log/edge-message-processor/system-monitor* |
| Дампы кучи в процессорах сообщений | Message Processor |
Чтобы получить дамп кучи в реальном времени: sudo -u apigee jmap -dump:live,format=b,file=/opt/apigee/var/snapshot_$(hostname)-$(date +%Y.%m.%d_%H.%M.%S).hprof $(cat /opt/apigee/var/run/edge-message-processor/edge-message-processor.pid) Сжать дамп кучи: tar cvzf /tmp/rmp_heapdumps_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/snapshot_$(hostname)-$(date +%Y.%m.%d_%H.%M.%S).hprof |
| Сжать все данные диагностики | Message Processor |
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/rmp_* |
502 Bad Gateway - no live upstreams while connecting to upstream
Пособие для авторов
В этом разделе приведена информация и рекомендации по некоторым процедурам, которые можно выполнить для устранения неполадок и решения проблемы 502 Bad Gateway - no live upstreams while
connecting to upstream.
| Проблема | Сообщение об ошибке в журналах | Пособие для авторов |
|---|---|---|
HTTP/1.1 502 Bad Gateway <html> <head> <title>Error</title> <style> body { width: 35em; margin: 0 auto; font-family: Tahoma, Verdana, Arial, sans-serif; } </style> </head> <body> <h1>An error occurred.</h1> <p>Sorry, the page you are looking for is currently unavailable.<br/> Please try again later.</p> </body> </html> |
В журналах ошибок NGINX вы увидите следующую ошибку:
(/opt/apigee/var/log/edge-router/nginx/ORGNAME~ENVNAME._error_log)
|
502 Bad Gateway |
Данные диагностики
Если вам нужна помощь службы поддержки Apigee Edge по поводу 502 Bad Gateway - no live streams while connecting to upstream, соберите следующую диагностическую информацию и поделитесь ею в запросе:
| Данные диагностики | Где можно найти эту информацию? | Как собрать эту информацию? |
|---|---|---|
| Журналы маршрутизатора | Маршрутизатор |
tar cvzf /tmp/router_logs_ORGNAME_ENVNAME_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-router/nginx/ORGNAME~ENVNAME.* |
| Журналы процессора сообщений | Message Processor |
tar cvzf /tmp/rmp_systemlogs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-message-processor/logs/system* |
| Вывод команды top, дамп кучи и дамп потоков | Message Processor |
Получите результат выполнения команды top: top -H -bn5 > /tmp/rmp_top_output_$(hostname)-$(date +%Y.%m.%d_%H.%M.%S).txt Чтобы получить дамп кучи: sudo -u apigee jcmd $(cat /opt/apigee/var/run/edge-message-processor/edge-message-processor.pid) GC.heap_dump /opt/apigee/var/rmp_heapdump_$(hostname)-$(date +%Y.%m.%d_%H.%M.%S).hprof Как получить дамп потоков sudo -u apigee jcmd $(cat /opt/apigee/var/run/edge-message-processor/edge-message-processor.pid) Thread.print > /tmp/rmp_thread_print_$(hostname)-$(date +%Y.%m.%d_%H.%M.%S).tdump |
| Сжать все данные диагностики |
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_* /opt/apigee/var/rmp_heapdump_* |
502 Bad Gateway - Unexpected EOF At Target (Ошибка шлюза 502 – неожиданный конец файла в целевом объекте)
Пособие для авторов
В этом разделе приведена информация и инструкции по устранению неполадок и решению проблем с 502 Bad Gateway - Unexpected EOF At
Target:
| Сообщение об ошибке | Код ошибки | Пособие для авторов |
|---|---|---|
HTTP/1.1 502 Bad Gateway { "fault": { "faultstring": "Unexpected EOF at target", "detail": { "errorcode": "messaging.adaptors.http.flow.UnexpectedEOFAtTarget" } } } |
messaging.adaptors.http.flow.UnexpectedEOFAtTarget |
502 Bad Gateway Unexpected EOF |
Данные диагностики
Если вам нужна помощь службы поддержки Apigee Edge по поводу 502 Bad Gateway - Unexpected EOF At Target, соберите следующую диагностическую информацию и поделитесь ею в запросе в службу поддержки:
| Данные диагностики | Где можно найти эту информацию? | Как собрать эту информацию? |
|---|---|---|
| Выходные данные инструмента трассировки, в которых зафиксированы неудачные запросы к API | Интерфейс Edge | Как использовать инструмент трассировки |
| Журналы маршрутизатора | Маршрутизатор |
tar cvzf /tmp/router_logs_ORGNAME_ENVNAME_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-router/nginx/ORGNAME~ENVNAME.* |
| Журналы процессора сообщений | Message Processor |
tar cvzf /tmp/rmp_systemlogs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-message-processor/logs/system* |
Tcpdumps |
Message Processor |
sudo tcpdump -s 0 -i any host BACKENDSERVER_HOSTNAME -w /tmp/rmp_tcpdump_$(hostname).pcap tar cvzf /tmp/rmp_tcpdumps_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /tmp/$(hostname).pcap |
| Сжать все данные диагностики | Маршрутизатор/процессор сообщений |
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_* |
Сбои при подтверждении TLS
Пособие для авторов
В этом разделе приведена информация и рекомендации по некоторым процедурам, которые можно использовать для устранения неполадок и сбоев при установлении соединения TLS/SSL:
| Сообщение об ошибке | Пособие для авторов |
|---|---|
Received fatal alert: handshake_failure |
Сбои при подтверждении TLS/SSL |
Received fatal alert: bad_certificate |
Сбои рукопожатия SSL – недействительный сертификат клиента |
Данные диагностики
Если вам нужна помощь службы поддержки Apigee Edge в устранении неполадок с подтверждением TLS/SSL, соберите следующую диагностическую информацию и поделитесь ею в запросе в службу поддержки:
| Данные диагностики | Где можно найти эту информацию? | Как собрать эту информацию? |
|---|---|---|
| Выходные данные инструмента трассировки, в которых зафиксированы неудачные запросы к API | Интерфейс Edge | Как использовать инструмент трассировки |
| Журналы маршрутизатора | Маршрутизатор |
tar cvzf /tmp/router_logs_ORGNAME>_ENVNAME_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-router/nginx/ORGNAME~ENVNAME.* |
| Журналы процессора сообщений | Message Processor |
tar cvzf /tmp/rmp_systemlogs_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /opt/apigee/var/log/edge-message-processor/logs/system* |
| Выходные данные команды OpenSSL | Message Processor |
Бэкенд-сервер без поддержки SNI: openssl s_client -connect BACKEND_SERVER_HOSTNAME:PORT -showcerts | tee /tmp/rmp_openssl_$(hostname)-$(date +%Y.%m.%d_%H.%M.%S).txt Бэкенд-сервер с поддержкой SNI: openssl s_client -connect BACKEND_SERVER_HOSTNAME:PORT -server BACKEND_SERVER_HOSTNAME -showcerts | tee /tmp/rmp_openssl_$(hostname)-$(date +%Y.%m.%d_%H.%M.%S).txt |
Tcpdumps |
Message Processor |
sudo tcpdump -s 0 -i any host BACKEND_SERVER_HOSTNAME -w /tmp/$(hostname).pcap tar cvzf /tmp/rmp_tcpdumps_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).tar.gz /tmp/$(hostname).pcap |
| Сертификаты из хранилища ключей и хранилища доверенных сертификатов Message Processor | Сервер управления |
Получите данные сертификата из хранилища ключей: curl -v http://MANAGEMENT_SERVER_HOST:PORT/v1/organizations/ORGNAME/environments/ENVNAME/keystores/KEYSTORENAME/certs/CERTNAME -u USERNAME Получите данные сертификата из хранилища доверенных сертификатов: curl -v http://MANAGEMENT_SERVER_HOSTPORT/v1/organizations/ORGNAME/environments/ENVNAME/keystores/TRUSTSTORENAME/certs/CERTNAME -u USERNAME |
| Сжать все данные диагностики | Message Processor |
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_* |