כרגע מוצג התיעוד של Apigee Edge.
כניסה למסמכי התיעוד של
Apigee X. מידע
תיאור הבעיה
אירעה שגיאה בשליחת בקשת API פעילה באמצעות SmartDocs מפורטל המפתחים.
הודעות שגיאה
השגיאה הנפוצה שמופיעה בפורטל למפתחים היא "אירעה שגיאה פנימית. אפשר לנסות שוב לשלוח את הבקשה".
סיבות אפשריות
השגיאה הזו עשויה להתרחש כשתגובה לפורטל למפתחים לא מצליחה לקבל תגובה מהקצה העורפי (שרת proxy למסמכים חכמים או נקודת הקצה בפועל).
אבחון
מפעילים את הכלים למפתחים בדפדפן ובודקים בכרטיסיית הרשת כדי לזהות את השגיאה בפועל.
שגיאות נפוצות והסיבות האופייניות להן מפורטות בטבלה הבאה:
|
שגיאה |
סיבות אופייניות |
|
ERR_NAME_NOT_RESOLVED |
הגבלות על הגדרה שגויה של שרת proxy ב-SmartDocs או של חומת אש ברשת |
|
תוכן מעורב |
|
|
500 - שגיאת שרת פנימית |
נבחן כל אחת מהסיבות האלה בנפרד, ונעבור על השלבים לפתרון הבעיה.
הגבלות על הגדרה שגויה של שרת proxy ב-SmartDocs או על חומת אש ברשת
ההודעה "ERR_NAME_NOT_RESOLVED" מציינת שכתובת ה-URL של שרת ה-proxy של Smartdocs מוגדרת באופן שגוי, או שהרשת שממנה מתבצעת הגישה לפורטל לא יכולה לבצע קריאה לכתובת ה-URL של שרת ה-proxy של Smartdocs עקב הגבלות של חומת האש. שרת ה-proxy של Smartdocs צריך להיות נגיש מהאינטרנט או מהרשת הפנימית (לממשקי API פנימיים).
רזולוציה
כדי לוודא שניתן לגשת לשרת ה-proxy של Smartdocs מכל הרשתות הנדרשות, צריך לפרוס את שרת ה-proxy של Smartdocs למארח וירטואלי ב-Edge עם שם מארח שאפשר לגשת אליו מהאינטרנט.
הפורטל מוגדר ב-HTTPS, בקשת SmartDocs באמצעות HTTP
השגיאה "תוכן מעורב" מציינת ששרת proxy של מסמכים חכמים מופעל באמצעות HTTP מדף שנטען ב-HTTPS.
רזולוציה
חשיפת שרת proxy של Smartdocs באמצעות https כדי לפתור את הבעיה. כדי לעשות זאת, פורסים את שרת ה-proxy של Smartdocs כך שיכלול מארח וירטואלי שמוגדר להשתמש ב-TLS/SSL (בדרך כלל המארח הווירטואלי ה"מאובטח").
שרת proxy של SmartDocs מחזיר חריג
ייתכן שההודעה 500 - שגיאת שרת פנימית נובעת מבעיה בשרת ה-proxy 'Smartdocs'. במקרה כזה, תשימו לב ששרת ה-proxy של Smartdocs מחזיר את השגיאה הזו.
אבחון
אפשר להשתמש בכלי המעקב כדי לאבחן שגיאות בשרת ה-proxy 'מסמכים חכמים', כפי שמתואר בהמשך. למידע נוסף, ראו שימוש בכלי המעקב.
- כדי לאתר את המדיניות הספציפית שמחזירה את שגיאת השרת הפנימית 500, צריך להפעיל את המעקב לשרת ה-proxy של "smartdocs" בארגון "VerifyATE".
- בוחרים את המדיניות הספציפית בנתוני המעקב כדי לזהות את הגורם לשגיאה.
רזולוציה
מתקנים את השגיאה שזוהתה. צוות התמיכה של Apigee Edge ישמח לעזור לך.
מעבדי הודעות של Edge לא יכולים להפעיל את נקודת הקצה של ה-API שפורסמה
500 – שגיאת שרת פנימית יכולה להתרחש גם כשמעבדי ההודעות ששייכים לארגון שמארח את שרת ה-proxy של Smartdocs לא יכולים להפעיל את נקודת הקצה של ה-API.
אבחון
אפשר להשתמש בכלי המעקב כדי לאבחן שגיאות בשרת ה-proxy 'מסמכים חכמים', כפי שמתואר בהמשך. למידע נוסף, ראו שימוש בכלי המעקב.
- צריך להפעיל את trace עבור שרת ה-proxy "trace" בארגון "trace" כדי לאתר את המדיניות הספציפית שמחזירה את שגיאת השרת הפנימית 500.
- בדוגמה הבאה של מעקב בממשק המשתמש, ניתן לראות שמדיניות JavaScript "BuildTargetAPIRequest" לא מצליחה להפעיל את כתובת ה-URL של היעד.
- מקבלים את כתובת ה-URL של היעד ממדיניות JavaScript "BuildTargetAPIRequest".
- צריך לבצע קריאה ישירה לכתובת ה-URL מהצמתים של מעבד ההודעות המשויכים לארגון
"VerifyATE", כפי שמוצג בהמשך:
curl -v <target URL>
- מתקנים כל שגיאה שזוהתה.
רזולוציה
- יש לוודא שניתן להפעיל את ממשקי ה-API שפורסמו בפורטל למפתחים ממעבדי הודעות המשויכים לארגון "VerifyATE", ולתקן את כל השגיאות שנמצאו.
- אם הצלחתם לבצע את הקריאה ל-API ישירות ממעבד ההודעות, סביר מאוד להניח שגם תוכלו להפעיל את ה-API דרך SmartDocs.
- מפעילים את הקריאה ל-API דרך SmartDocs ובודקים אם הבעיה נפתרה.