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

אתם צופים במסמכי התיעוד של Apigee Edge.
כדאי לעיין במסמכי התיעוד של Apigee X.
מידע

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

בעיות ב-Analytics

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

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

פסק זמן בדוחות Analytics

או:

פסק זמן בדוח

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

שגיאות פריסה

פריסת 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 Error Accessing 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

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

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

בעיות ב-OpenLDAP

הנושאים הבאים יעזרו לכם לפתור בעיות נפוצות ב-OpenLDAP.

הודעת השגיאה או התיאור שלה Playbook
Unknown username and password combination. פרוטוקול SMTP מושבת והמשתמשים צריכים לאפס את הסיסמה
לא מופיעות שגיאות, ובממשק המשתמש של Edge פשוט לא מוצגת רשימת המשתמשים שהייתה אמורה להיות משוכפלת בכל שרתי 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 Bad Gateway
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 השירות לא זמין
HTTP/1.1 503 Service Unavailable או Received fatal alert: handshake_failure כשלים בלחיצת היד של SSL
HTTP/1.1 503 Service Unavailable או
{
 "fault": {
    "faultstring":"The Service is temporarily unavailable",
    "detail":{
        "errorcode":"messaging.adaptors.http.flow.ServiceUnavailable"
    }
 }
}
כשלים בתהליך הלחיצה של SSL – אישור לקוח לא תקין
HTTP/1.1 504 Gateway Timeout או
{
   "fault": {
      "faultstring": "Gateway Timeout",
      "detail": {
           "errorcode": "messaging.adaptors.http.flow.GatewayTimeout"
       }
    }
}


504 הזמן הקצוב לתפוגה של השער תם

בעיות ב-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 Connection Loss Errors
בעיות שקשורות לנתונים, שנקראות בדרך כלל בעיות בחיבור, יכולות להתבטא באחת מכמה בעיות. פרטים נוספים זמינים במאמר בעיות בנתונים של 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.

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