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

يتم الآن عرض مستندات Apigee Edge.
انتقِل إلى مستندات Apigee X. المعلومات

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

خطأ 4XX/5XX

دليل إرشادي

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

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

و

خطأ 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 الخدمة غير متوفرة - 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 خطأ طلب غير صالح - خطأ في شهادة 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 تعذر تحديد الخادم الوكيل لخطأ المضيف

دليل إرشادي

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

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

دليل إرشادي

يقدّم هذا القسم معلومات وإرشادات حول بعض الإجراءات المحدّدة التي يمكن اتّباعها لتحديد المشاكل وحلّها في 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 مدخل غير صالح

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

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

دليل إرشادي

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

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

إذا كنت بحاجة إلى مساعدة من فريق دعم 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) أو طبقة المقابس الآمنة:

رسالة الخطأ دليل إرشادي
Received fatal alert: handshake_failure تعذُّر تأكيد الاتصال من خلال بروتوكول أمان طبقة النقل (TLS) أو طبقة المقابس الآمنة
Received fatal alert: bad_certificate إخفاقات تأكيد الاتصال بطبقة المقابس الآمنة - شهادة عميل غير صالحة

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

إذا كنت بحاجة إلى مساعدة من فريق دعم Apigee Edge بشأن تعذُّر تأكيد اتصال بروتوكول أمان طبقة النقل أو طبقة المقابس الآمنة، يمكنك جمع معلومات التشخيص التالية ومشاركتها في تجربة الدعم:

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