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

أنت تعرض مستندات 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 Support بشأن أخطاء 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 Support على 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 Support بشأن الخطأ 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 - لا تتوفّر أي عمليات بث مباشر عند الاتصال بالبثّ

دليل إرشادي

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

دليل إرشادي

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

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

إذا كنت بحاجة إلى مساعدة من Apigee Edge Support على 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 Support في حال حدوث مشاكل في تأكيد اتصال بروتوكول أمان طبقة النقل (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
الشهادات من ملف تخزين المفاتيح وTruststore في "معالج الرسائل" خادم الإدارة

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

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_*