הפניה להודעת שגיאה

אתם צופים במסמכי העזרה של Apigee Edge.
כניסה למסמכי העזרה של Apigee X. info

בדף הזה יש קישורים למדריכים לפתרון בעיות של שגיאות ובעיות אחרות שעשויות לצוץ במהלך השימוש ב-Apigee Edge. בכל מדריך לפתרון בעיות מוסבר איך לאבחן כל סוג בעיה ולפתור אותה.

בעיות ב-Analytics

בנושאים האלה מוסבר איך לפתור בעיות שבהן נתוני ניתוח הנתונים לא מופיעים במרכזי הבקרה של Analytics או בדוחות בהתאמה אישית.

הודעת שגיאה או תיאור השגיאה Playbook
The report timed out: Try again with a smaller date range or a larger aggregation interval.

הזמן פג בדוחות Analytics

או:

התוקף של הדוח פג
ייתכן שלא תופיע הודעת שגיאה כלשהי, אלא אם נפח הדיסק ב-Postgres Server יתמלא לחלוטין. אין מקום פנוי בכונן של שרת Postgres
לא זוהו שגיאות. המשתנה המותאם אישית לא גלוי בדוחות בהתאמה אישית של Analytics
No traffic in the selected date range הנתונים לא מופיעים בלוחות הבקרה של Analytics
הנושא הזה מסביר איך לבצע משימה נפוצה. הוספה ומחיקה של רכיבי ניתוח נתונים בקבוצות של ניתוח נתונים
Could not get data for path מאפיינים מותאמים אישית לא מופיעים כשמגדירים כמה קבוצות axgroups

שגיאות בפריסה

הפריסה של שרתי proxy ל-API עשויה להיכשל מסיבות שונות, כמו בעיות בחיבור הרשת בין שרתי Edge, בעיות במאגר הנתונים של Cassandra, חריגות ב-ZooKeeper ושגיאות בחבילת שרת ה-proxy ל-API. בקטע הזה מפורט מידע והנחיות לגבי כמה נהלים ספציפיים שאפשר לפעול לפיהם כדי לפתור שגיאות בפריסה.
הודעת שגיאה או תיאור השגיאה Playbook
Error: Call timed out; either server is down or server is not reachable שגיאת זמן קצוב
Unexpected error Error while fetching children for path שגיאה באחזור צאצאים לנתיב
Error while accessing datastore;Please retry later שגיאה בקבלת גישה ל-Datastore
Configuration failed, associated contexts = [] הגדרה נכשלה
Unexpected error occurred while processing the updates, associated contexts = [] שגיאות בעדכונים של עיבוד

שגיאות בפורטל המפתחים

בנושאים האלה מוסבר איך לטפל בבעיות שעשויות לצוץ במהלך השימוש בפורטל למפתחים. לפני שמנסים לפתור בעיות בפורטל המפתחים, חשוב להבין את האופן שבו פורטל המפתחים פועל, כפי שמוסבר במאמר סקירה כללית על פתרון בעיות בפורטל המפתחים.
הודעת שגיאה או תיאור השגיאה Playbook
An internal error has occurred. Please retry your request. שגיאה פנימית בפורטל המפתחים
The website encountered an unexpected error. Please try again later. או There was an error trying to create the App. Please try again later. בעיות בתקשורת בפורטל למפתחים

בעיות במונטיזציה

בנושאים הבאים נסביר איך לפתור בעיות נפוצות שקשורות למונטיזציה.

הודעת שגיאה או תיאור של השגיאה Playbook 
<error>
   <messages>
        <message>Exceeded developer limit configuration -</message>
        <message>Is Developer Suspended - true</message>
   </messages>
</error>
Developer Suspended
יכול להיות שלא יוצגו הודעות שגיאה, אבל יופיעו בעיות כפי שמתואר בקטע סימנים במאמר בעיות בהגדרת המונטיזציה. בעיות בהגדרת המונטיזציה

בעיות ב-Edge Router

Edge Router מוטמע באמצעות NGINX. במהלך תהליך השדרוג של Edge או כשמשנים את ההגדרות של הנתב, יכול להיות שיופיעו שגיאות בהגדרות של NGINX. הנושא הבא יעזור לכם לטפל בבעיות כאלה.

הודעת שגיאה או תיאור של שגיאה Playbook
לא יוצגו הודעות שגיאה. עם זאת, יכול להיות שלא תוכלו להריץ את שרת ה-proxy של ה-API בגלל קבצי התצורה הפגומים. קבצי תצורה לא תקינים
429 Too Many Requests: Tuning Nginx Router connection limits 429 Too Many Requests

בעיות ב-OpenLDAP

בנושאים הבאים מוסבר איך לפתור בעיות נפוצות ב-OpenLDAP.

הודעת שגיאה או תיאור השגיאה Playbook
Unknown username and password combination. SMTP מושבת והמשתמשים צריכים לאפס את הסיסמה
לא מופיעות שגיאות, פשוט לא מוצגת ב-Edge UI רשימת המשתמשים שאמורה הייתה להיות מועתקת לכל שרתי OpenLDAP. אין שכפול ב-LDAP.
SLAPD Dead But Pid File Exists לא ניתן להפעיל את OpenLDAP
Unknown username and password combination. פגיעה בנתונים של OpenLDAP

שגיאות זמן ריצה

בנושאים הבאים נסביר איך לפתור בעיות נפוצות בסביבת זמן הריצה.

הודעת שגיאה או תיאור השגיאה Playbook
HTTP/1.1 500 Internal Server Error או 
{
   "fault":{
      "detail":{
         "errorcode":"steps.servicecallout.ExecutionFailed"
      },
      "faultstring":"Execution of ServiceCallout callWCSAuthServiceCallout failed.
        Reason: ResponseCode 400 is treated as error"
   }
}
שגיאה 500: שגיאת שרת פנימית
HTTP/1.1 502 Bad Gateway או 
{
   "fault": {
      "faultstring": "Unexpected EOF at target",
      "detail": {
           "errorcode": "messaging.adaptors.http.UnexpectedEOFAtTarget"
       }
    }
}
502 שער שגוי
HTTP/1.1 503 Service Unavailable או HTTP/1.1 503 Service Unavailable: Back-end server is at capacity או 
{
   "fault": {
      "faultstring": "The Service is temporarily unavailable",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.ServiceUnavailable"
       }
    }
}
‎503 Service Unavailable
HTTP/1.1 503 Service Unavailable או Received fatal alert: handshake_failure כשלים של לחיצת יד (handshake) ב-SSL
HTTP/1.1 503 Service Unavailable או 
{
 "fault": {
    "faultstring":"The Service is temporarily unavailable",
    "detail":{
        "errorcode":"messaging.adaptors.http.flow.ServiceUnavailable"
    }
 }
}
SSL Handshake Failures – Bad Client Certificate
HTTP/1.1 504 Gateway Timeout או 
{
   "fault": {
      "faultstring": "Gateway Timeout",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.GatewayTimeout"
       }
    }
}
504 Gateway Timeout

בעיות ב-Zookeeper

בנושאים הבאים נסביר איך לפתור בעיות נפוצות ב-Zookeeper.
הודעת שגיאה או תיאור של השגיאה Playbook
org: env: main ERROR ZOOKEEPER - ZooKeeperServiceImpl.exists() : Could not detect existence of path: /regions/dc-1/pods/analytics/servers/abc123/reachable , reason: KeeperErrorCode = ConnectionLoss

או

org.apache.zookeeper.KeeperException$ConnectionLossException: KeeperErrorCode = ConnectionLoss

או

יכול להיות שבממשק המשתמש של Edge תוצג השגיאה הבאה:

Error Fetching Deployments Error while checking path existence for path: path 		שגיאות של אובדן חיבור ב-Zookeeper
בעיות שקשורות לנתונים, שנקראות בדרך כלל בעיות בחיווט, יכולות להתבטא בכמה דרכים. פרטים נוספים זמינים במאמר בעיות בנתונים של Zookeeper. בעיות בנתונים של Zookeeper
+ apigee-service apigee-zookeeper status apigee-service: apigee-zookeeper: Not running (DEAD) apigee-all: Error: status failed on [apigee-zookeeper] לא ניתן להפעיל את Zookeeper

כלים ויומנים לאבחון

בנושאים האלה מתוארים כלים ויומנים שאפשר להשתמש בהם כדי לאבחן סוגים מסוימים של בעיות שעשויות להתרחש במהלך השימוש ב-Apigee Edge.

  • כלי לזיהוי חבילות (tcpdump) של TCP/IP
    כלי tcpdump הוא כלי לזיהוי חבילות בשורת הפקודה שמאפשר לתעד או לסנן חבילות TCP/IP שמתקבלות או מועברות ברשת.
  • תמונות מצב של ערימה
    תמונות מצב של ערימה הן תמונת מצב של הזיכרון של תהליך Java. הם מכילים את המידע על האובייקטים והכיתות של Java ב-heap בזמן האיסוף של גרסת ה-dump של ה-heap.
  • דיווחים על שרשור
    דיווח על שרשור הוא תמונת מצב של כל השרשור בתהליך Java שפועל. המצב של כל חוט מוצג עם התוכן של ה-stack שלו, שנקרא 'מעקב stack'.