مشاكل وقت التشغيل

أنت الآن بصدد الاطّلاع على مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. info

يُشار إلى أي أخطاء أو مشاكل في وقت الاستجابة أو نتائج غير متوقّعة يتم رصدها أثناء تنفيذ طلبات واجهة برمجة التطبيقات باسم runtime.

أخطاء 4XX/5XX

دليل إرشادي

يقدّم هذا القسم معلومات وإرشادات حول بعض الإجراءات المحدّدة التي يمكن اتّباعها لتحديد المشاكل وحلّ الأخطاء 4XX و5XX أثناء التنفيذ.

رسالة الخطأ أو الردّ الذي يشير إلى حدوث خطأ رمز الخطأ دليل إرشادي
HTTP/1.1 500 Internal Server Error يختلف حسب الخطأ الفعلي 500 Internal Server Error

و

‫500 خطأ في الخادم الداخلي - تم تفعيل البث
HTTP/1.1 503 Service Unavailable messaging.adaptors.http.flow.ServiceUnavailable ‫503 الخدمة غير متاحة
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 الخدمة غير متاحة - تعذُّر عمليات التحقّق من الصحة NoActiveTargets
HTTP/1.1 503 Service Unavailable

(من خادم الخلفية)

messaging.adaptors.http.flow.ErrorResponseCode ‫503 الخدمة غير متاحة - خادم الخلفية
HTTP/1.1 504 Gateway Timeout messaging.adaptors.http.flow.GatewayTimeout ‫504 انتهت مهلة البوابة
HTTP/1.1 504 Gateway Timeout

(من خادم الخلفية)

messaging.adaptors.http.flow.ErrorResponseCode ‫504 انتهت مهلة البوابة - خادم الخلفية

معلومات التشخيص

إذا كنت بحاجة إلى أي مساعدة من فريق دعم Apigee Edge بشأن أخطاء وقت التشغيل 4XX (مثل 400 و401 و404 و499) أو أخطاء 5XX (مثل 500 و503 و504)، عليك جمع سجلّات التشخيص والمعلومات التالية ومشاركتها في طلب الدعم:

بيانات التشخيص أين يمكنني جمع هذه المعلومات؟ كيف يمكنني جمع هذه المعلومات؟
تعذّر تسجيل طلبات البيانات من واجهة برمجة التطبيقات التي تعذّر تنفيذها في أداة التتبُّع واجهة مستخدم 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.*
سجلّات "معالج الرسائل" معالج الرسائل 
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 Bad Request - خطأ في شهادة 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 جهاز التوجيه

التقط حِزم الشبكة باستخدام الأمر tcpdump على جهاز التوجيه:

sudo tcpdump -s 0 -i any host CLIENT_HOST_IP_ADDRESS -w /tmp/router_tcpdump_$(hostname).pcap

اضغط على tcpdump: 

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

اضغط على tcpdump:

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 Unable to identify proxy for host error

دليل إرشادي

يقدّم هذا القسم معلومات وإرشادات حول بعض الإجراءات المحدّدة التي يمكن اتّباعها لتحديد المشاكل وحلّ الخطأ 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 Unable to identify proxy for host

بيانات التشخيص

إذا كنت بحاجة إلى مساعدة من فريق دعم 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
ناتج واجهة برمجة التطبيقات وشجرة التصنيف معالج الرسائل

احصل على البيئات التي تم تحميلها لمؤسسة معيّنة:

curl -s 0:8082/v1/runtime/organizations/ORGNAME/environments > /tmp/rmp_environments_list_$(hostname)_$(date +%Y.%m.%d_%H.%M.%S).txt

احصل على المراجعات التي تم نشرها لخادم وكيل معيّن لواجهة برمجة التطبيقات:

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
سجلّات "معالج الرسائل" معالج الرسائل 
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*
لقطات لأجزاء من الذاكرة على "معالجات الرسائل" معالج الرسائل

احصل على لقطة لأجزاء من الذاكرة المباشرة:

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
ضغط جميع بيانات التشخيص معالج الرسائل 
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)

[error] 4796#4796: *56357443 no live upstreams while connecting to upstream, client: ROUTER_IP_ADDRESS, server: HOST_ALIAS, request: "PUT BASE_PATH HTTP/1.1", upstream: "http://LISTOFMP_IP_R_MP_PORT/BASE_PATH", host: "HOST_ALIAS" 		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.*
سجلّات "معالج الرسائل" معالج الرسائل 
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 -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 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، يُرجى جمع معلومات التشخيص التالية ومشاركتها في طلب الدعم:

بيانات التشخيص أين يمكنني جمع هذه المعلومات؟ كيف يمكنني جمع هذه المعلومات؟
تعذّر تسجيل طلبات البيانات من واجهة برمجة التطبيقات التي تعذّر تنفيذها في أداة التتبُّع واجهة مستخدم 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.*
سجلّات "معالج الرسائل" معالج الرسائل 
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 معالج الرسائل 
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، عليك جمع معلومات التشخيص التالية ومشاركتها في طلب الدعم:

بيانات التشخيص أين يمكنني جمع هذه المعلومات؟ كيف يمكنني جمع هذه المعلومات؟
تعذّر تسجيل طلبات البيانات من واجهة برمجة التطبيقات التي تعذّر تنفيذها في أداة التتبُّع واجهة مستخدم 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.*
سجلّات "معالج الرسائل" معالج الرسائل 
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 معالج الرسائل

خادم الخلفية غير المفعّل فيه 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 معالج الرسائل 
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
الشهادات من ملف تخزين المفاتيح وملف تخزين الشهادات الموثوقة في "معالج الرسائل" خادم الإدارة

الحصول على تفاصيل الشهادة من ملف تخزين المفاتيح:

curl -v http://MANAGEMENT_SERVER_HOST:PORT/v1/organizations/ORGNAME/environments/ENVNAME/keystores/KEYSTORENAME/certs/CERTNAME -u USERNAME

احصل على تفاصيل الشهادة من Truststore:

curl -v http://MANAGEMENT_SERVER_HOSTPORT/v1/organizations/ORGNAME/environments/ENVNAME/keystores/TRUSTSTORENAME/certs/CERTNAME -u USERNAME
ضغط جميع بيانات التشخيص معالج الرسائل 
tar -cvzf /tmp/data_CASE#_$(hostname).tar.gz /tmp/router* /tmp/rmp_*