בעיות בזמן ריצה

כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של Apigee X. מידע

כל השגיאות, בעיות בזמן האחזור או תוצאות בלתי צפויות שזוהו במהלך הביצוע של בקשות ה-API נקראות 'בעיות מסוג 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 שירות לא זמין – אין יעדים פעילים
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), אפשר לאסוף את יומני האבחון והמידע הבאים בבקשת התמיכה ולשתף אותם:

פרטי האבחון איפה אפשר לאסוף את המידע הזה? איך אפשר לאסוף את המידע הזה?
כלי המעקב מתעדים פלט של בקשות 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.*
יומנים של מעבד ההודעות מעבד בקשות 
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 לא ניתן לזהות שרת proxy לשגיאת מארח

חוברת

בקטע הזה מופיעים מידע והנחיות לגבי הליכים ספציפיים שאפשר לפעול לפיהם כדי לפתור את השגיאה 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 לא ניתן לזהות שרת proxy למארח

פרטי האבחון

אם דרושה לך עזרה מהתמיכה של 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 ושל עץ הסיווג מעבד בקשות

כדי לטעון את הסביבות של ארגון ספציפי:

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

פורסים את הגרסאות הקודמות לשרת proxy ספציפי של 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
יומנים של מעבד ההודעות מעבד בקשות 
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*
קובצי dump של ערימה (heap dumps) במעבדי הודעות מעבד בקשות

קבלת תמונת מצב של הזיכרון הפעיל:

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)

דוחס את dump הערימה:

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 - אין סטרימינג בשידור חי במהלך ההתחברות ל-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 שער שגוי

פרטי האבחון

אם צריך עזרה מהתמיכה של 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*
פלט עליון, Dump של ערימה ו-dump שרשורים מעבד בקשות

מקבלים את הפלט העליון של הפקודה:

top -H -bn5 > /tmp/rmp_top_output_$(hostname)-$(date +%Y.%m.%d_%H.%M.%S).txt

משיגים את נתוני ה-Dump של הערימה:

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 - 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 שער שגוי – 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.*
יומנים של מעבד ההודעות מעבד בקשות 
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, תוכלו לאסוף את פרטי האבחון הבאים ולשתף אותם בבקשת התמיכה:

פרטי האבחון איפה אפשר לאסוף את המידע הזה? איך אפשר לאסוף את המידע הזה?
כלי המעקב מתעדים פלט של בקשות 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.*
יומנים של מעבד ההודעות מעבד בקשות 
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
אישורים מ-Keystore ומ-Truststore של מעבד ההודעות שרת ניהול

משיגים את פרטי האישור מ-Keystore:

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