הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.
לעיון במסמכי התיעוד של Apigee Edge
פתרון בעיות הוא גם אמנות וגם מדע. צוותי התמיכה הטכנית של Apigee משקיעים מאמצים רבים כדי להסביר את האומנות שמאחורי זיהוי בעיות ופתרונן, ולחשוף את המדע שמאחורי התהליך הזה.
מהם מדריכים לתכנון אסטרטגיה?
המדריכים לפתרון בעיות ב-Apigee פותחו בשיתוף עם צוותי התמיכה הטכנית של Apigee, והם נועדו לספק פתרונות מהירים ויעילים לשגיאות או לבעיות אחרות שאתם עשויים להיתקל בהן כשאתם עובדים עם מוצרי Apigee.
קהל
המדריכים לפתרון בעיות מיועדים לקוראים עם הבנה ברמה גבוהה של Apigee והארכיטקטורה שלה, וגם הבנה מסוימת של מושגים בסיסיים כמו מדיניות וניתוח נתונים.
יש בעיות שאפשר לאבחן ולפתור רק אם משתמשים ב-Apigee hybrid, ויכול להיות שיידרש ידע ברכיבים פנימיים כמו מאגרי נתונים של Cassandra, מעבדי הודעות ורכיבי סנכרון.
אם אתם משתמשים ב-Apigee, אנחנו מציינים באופן ברור מתי אפשר לבצע את השלבים לפתרון הבעיות ומתי צריך לפנות אל Cloud Customer Care לקבלת עזרה.
פלייבוקים
בקטע הזה מתוארים הפלייבוקים הנוכחיים.
כדי לסנן את הטבלה הזו, מבצעים אחת או יותר מהפעולות הבאות: בוחרים קטגוריה, בוחרים מוצר, מקלידים מונח חיפוש או לוחצים על כותרת של עמודה כדי למיין.
| קטגוריה | מדריך/תיאור הבעיה | הודעת השגיאה | המדריך רלוונטי ל |
|---|---|---|---|
| Cassandra | כשל באימות אישור TLS של Cassandra | אם אישור ה-CA של Apigee לא זהה בכל האשכולות, יכול להיות שאימות אישור ה-TLS ב-Cassandra ייכשל. | Apigee Hybrid בלבד |
| Cassandra | פתרון בעיות בשחזור של Cassandra | במהלך השחזור של Cassandra ב-Apigee hybrid, יכול להיות שתיתקלו בשגיאות ביומני השחזור. | Apigee Hybrid בלבד |
| חשיפה אוטומטית של בעיות | אין קישוריות לרשת בין מישור זמן הריצה לבין מישור הבקרה | בקשות לניהול API ב-Apigee נכשלות:
|
Apigee Hybrid בלבד |
| זיהוי אוטומטי של בעיות | חסרה קבוצת סביבות למארח וירטואלי | אחרי שמריצים את הפקודה kubectl -n apigee get apigeeissues, מוצגת השגיאה AIS_VIRTUALHOST_MISSING_ENVGROUP.
|
Apigee Hybrid בלבד |
| חשיפה אוטומטית של בעיות | חסר בורר של מארח וירטואלי | אחרי שמריצים את הפקודה kubectl -n apigee get apigeeissues, מוצגת השגיאה AIS_VIRTUALHOST_MISSING_SELECTOR.
|
Apigee Hybrid בלבד |
| זיהוי אוטומטי של בעיות | חוסר התאמה בתעודת הכניסה | אחרי שמריצים את הפקודה kubectl -n apigee get apigeeissues, מוצגת השגיאה AIS_INGRESS_CERT_MISMATCH.
|
Apigee Hybrid בלבד |
| זיהוי אוטומטי של בעיות | תפוגת התוקף של אישור הכניסה | אחרי שמריצים את הפקודה kubectl -n apigee get apigeeissues, מוצגת השגיאה AIS_INGRESS_CERT_EXPIREY.
|
Apigee Hybrid בלבד |
| חשיפה אוטומטית של בעיות | Ingress mTLS CA cert expiry | אחרי שמריצים את הפקודה kubectl -n apigee get apigeeissues, מוצגת השגיאה AIS_INGRESS_MTLS_CA_CERT_EXPIREY.
|
Apigee Hybrid בלבד |
| חשיפה אוטומטית של בעיות | Ingress mTLS CA cert invalid | אחרי שמריצים את הפקודה kubectl -n apigee get apigeeissues, מוצגת השגיאה AIS_INGRESS_MTLS_CA_CERT_INVALID.
|
Apigee Hybrid בלבד |
| Cassandra | כשל בשכפול נתוני Cassandra |
כשמשכפלים נתונים במהלך הרחבה של מספר אזורים, יכול להיות שהסטטוס CassandraDataReplication יציג מצב שגיאה והשכפול של הנתונים ייכשל.
|
Apigee Hybrid בלבד |
| Cassandra | בעיות בזיכרון Heap של Java ב-Cassandra |
בעיות ב-heap של Cassandra עלולות לגרום להאטה בהרצת ה-proxy של Apigee hybrid או אפילו לשגיאות Datastore. לפעמים היומנים הם אינדיקטור מוקדם, עוד לפני הופעת התסמינים.
|
Apigee Hybrid בלבד |
| Cassandra | פודים של Cassandra לא מופעלים באזור המשני |
פודים של Cassandra לא מצליחים להתחיל באחד מהאזורים בהגדרה היברידית של כמה אזורים.
יכול להיות שתופיע הודעת השגיאה node already exists ביומני הרישום של Cassandra pod, או
האזהרה FailedPreStopHook בסטטוס של Cassandra pod.
|
Apigee Hybrid בלבד |
| Cassandra | מדריך לפתרון בעיות ב-Cassandra |
כשמשתמשים בפקודה kubectl כדי להציג את מצבי ה-pod, רואים שאחד או יותר מ-pods של Cassandra תקועים. במדריך הזה מתוארים אבחון ופתרון של בעיות במאגר הנתונים של Cassandra.
|
Apigee Hybrid בלבד |
| פריסה | פריסות של proxy ל-API נכשלות ללא אזהרה על פודים פעילים של זמן ריצה | האזהרה No active runtime pods מוצגת בתיבת הדו-שיח Details לצד הודעת השגיאה Deployment issues on ENVIRONMENT: REVISION_NUMBER בדף proxy ל-API. | Apigee Hybrid בלבד |
| Ingressgateway | קריאות ל-API נכשלות עם שגיאות של פסק זמן |
curl: (7) Failed to connect to example.apis.com port 443: Operation timed out |
Apigee Hybrid בלבד |
| Ingressgateway | קריאות ל-API נכשלות בגלל שגיאות TLS |
curl: (35) LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to example.apis.com:443 |
Apigee Hybrid בלבד |
| רישום ביומן | פתרון בעיות שקשורות ליומני Apigee שחסרים ב-Cloud Logging | לא ידוע על הודעות שגיאה שמוצגות בתרחיש הזה. | Apigee ו-Apigee Hybrid |
| ניהול/ממשק משתמש | Inconsistent/no data observed for entities in hybrid UI or through Management APIs | לא ידוע על הודעות שגיאה שמוצגות בתרחיש הזה. | Apigee Hybrid בלבד |
| הגדרת רשת | בעיות בגישה לניתוב ב-Apigee |
לקוחות חיצוניים לא יכולים לגשת ל-Apigee או להתחבר אליו באופן הרצוי. השגיאות האלה כוללות כשלים בקישוריות לרשת (הלחיצת יד של TLS נכשלת) או 4xx/5xxתגובות מ-Apigee.
|
Apigee ו-Apigee Hybrid |
| הגדרת רשת | בעיה בקישוריות של Apigee עם Private Service Connect לכיוון צפון |
ההגדרה של Private Service Connect בכיוון צפון לא פועלת כמו שצריך, והסטטוס של קבוצת נקודות הקצה ברשת נשאר Pending.
|
Apigee בלבד |
| הגדרת רשת | בעיות בקישוריות של Apigee עם יעדים של Private Service Connect בדרום |
בעיה בחיבור לרשת או פסק זמן של TCP בין Apigee לבין שירות היעד יופיעו כתגובת שגיאה 503, ואם תיצרו סשן ניפוי באגים, תופיע שגיאה דומה לזו שמופיעה בהמשך.
{"fault":{"faultstring":"The Service is temporarily unavailable","detail":{"errorcode":"messaging.adaptors.http.flow.ServiceUnavailable","reason":"TARGET_CONNECT_TIMEOUT"}}} |
Apigee ו-Apigee Hybrid |
| אחר | הגדלת מספר העותקים של מאפייני Istio כשמרוקנים צמתים | כשמרוקנים את ה-pods של Istio, יכול להיות שחלק מהצמתים לא יתרוקנו כי יש להם מספר עותקים של 1, כשנדרשים 3 עותקים או יותר. כדי להימנע מכך, צריך להגדיר לכל נכס לפחות 3 עותקים משוכפלים. | Apigee Hybrid בלבד |
| אחר | מדריך לפתרון בעיות במעבד בקשות |
אחד או יותר מ-pods של apigee-runtime לא נמצאים במצב Ready.
כשמשתמשים ב-kubectl כדי לתאר פוד apigee-runtime שנכשל, מוצגת השגיאה:
Readiness probe failed: HTTP probe failed with statuscode: 500 |
Apigee Hybrid בלבד |
| אחר | הדפסת פרטי ה-Build |
buildinfo API מחזיר מידע על גרסת ה-build הנוכחית של רכיב זמן ריצה. המידע הזה יכול להיות שימושי אם תצטרכו ליצור קשר עם התמיכה.
|
Apigee Hybrid בלבד |
| אחר | StreamingPull errors 100% |
אם בלוח הבקרה של המדדים מופיע שהשיטה
google.pubsub.vl.Subscriber.StreamingPull נכשלת עם
100% שגיאות, אפשר להתעלם מהבעיה. זו התנהגות צפויה.
|
Apigee Hybrid בלבד |
| פריסה | המופע לא מדווח על הסטטוס של קבוצת הסביבות | פריסות של שרתי proxy ל-API נכשלות עם השגיאה Instance INSTANCE_NAME is not reporting status for environment group ENV_GROUP_NAME בממשק המשתמש של Apigee hybrid. | Apigee Hybrid בלבד |
| פריסה | פריסות של proxy ל-API נכשלות עם השגיאה apigee-serving-cert is not found or expired |
פריסות של proxy ל-API נכשלות עם הודעות שגיאה ביומני apigee-watcher.
|
Apigee Hybrid בלבד |
| Ingressgateway | הרחבת מספר העותקים של נכסי Istio כדי למנוע בעיות בניקוז של צמתי Istio |
כשמרוקנים את הפודים של Istio, יכול להיות שחלק מהצמתים לא יתרוקנו כי יש להם מספר רפליקות של 1, כשנדרשות 3 רפליקות או יותר. כדי להימנע מכך, צריך להגדיר את המספר המינימלי של העתקים לכל נכס ל-3 לפחות.
|
Apigee Hybrid בלבד |
| הגדרת רשת | פתרון בעיות שקשורות למרחב כתובות IP לא פנוי | במהלך הקצאת הרשאות ב-Apigee, אם בוחרים טווח CIDR של רשת שלא פנוי לגמרי, יכול להיות שתופיע הודעת שגיאה. | Apigee ו-Apigee Hybrid |
| הגדרת רשת | שגיאה 503 Service Unavailable עם TARGET_CONNECT_TIMEOUT (יעדי אינטרנט ו-VPC peering) | במסמך הזה מוסבר איך לאבחן ולתקן שגיאות מסוג TARGET_CONNECT_TIMEOUT עם הודעת השגיאה '503 השירות לא זמין' כשמשתמשים ביעדים של אינטרנט או של VPC Peering. | Apigee |
| הגדרת רשת | 504 הזמן שהוקצב לשער תם – הזמן הקצוב לתפוגה של קריאת היעד | במאמר הזה מוסבר איך לאבחן ולתקן שגיאות מסוג '504 הזמן שהוקצב לשער חלף' עם הסיבה TARGET_READ_TIMEOUT. | Apigee ו-Apigee Hybrid |
| זמן ריצה | בקשות API נכשלות עם השגיאה TARGET CONNECT HOST NOT REACHABLE | במסמך הזה מוסבר איך לאבחן ולפתור שגיאות של קוד סטטוס תגובה HTTP 503 עם הסיבה TARGET_CONNECT_HOST_NOT_REACHABLE. | Apigee ו-Apigee Hybrid |
| זמן ריצה | בקשות API נכשלות עם השגיאה 502 Bad Gateway ("Unexpected EOF at target") | במדריך הזה מוסבר איך לאבחן ולפתור שגיאות מסוג 502 Bad Gateway Unexpected EOF. | Apigee ו-Apigee Hybrid |
| אחר | פתרון בעיות שקשורות ל-Apigee Hybrid שנתקע במצב יצירה או שחרור |
במאמר הזה מוסבר איך לאפס רכיבי Apigee hybrid כשהם תקועים במצב creating או releasing.
|
Apigee Hybrid בלבד |
| התקנה ושדרוג של Apigee Hybrid | Cassandra Pods in CrashLoopBackOff Status | תאי Cassandra תקועים במצב CrashLoopBackOff אחרי התקנה או שדרוג. | Apigee Hybrid בלבד |
| התקנה ושדרוג של Apigee Hybrid | תאי Apigee Metrics במצב CrashLoopBackOff | תאי Apigee Metrics נשארים במצב CrashLoopBackOff אחרי התקנה או שדרוג. | Apigee Hybrid בלבד |
| התקנה ושדרוג של Apigee Hybrid | Pods של שער כניסה ב-Apigee מציגים 1 מתוך 2 קונטיינרים שפועלים |
כשמקבלים את רשימת הפודים, בפודים של apigee-ingressgateway מוצג רק קונטיינר אחד מתוך 2 שפועלים. |
Apigee Hybrid בלבד |
| התקנה ושדרוג של Apigee Hybrid | שגיאה ב-UDCA pod | תאים של UDCA ו-Connect Agent מחזירים שגיאה שקשורה לבעיית הרשאות. | Apigee Hybrid בלבד |
| התקנה ושדרוג של Apigee Hybrid | החיבור מתאפס במהלך לחיצת היד של TLS עבור לקוחות שאינם SNI | איפוס חיבורים נצפה במהלך לחיצת היד בפרוטוקול TLS עבור לקוחות שאינם SNI. | Apigee Hybrid בלבד |
| התקנה ושדרוג של Apigee Hybrid | אין מספיק מקום בכונן ב-Cassandra | תהליך ההתקנה של Apigee hybrid נכשל בגלל שאין מספיק מקום בכונן למסד הנתונים של Cassandra. | Apigee Hybrid בלבד |
| התקנה ושדרוג של Apigee Hybrid | Insufficient CPU |
כשמשתמשים ב-kubectl כדי להציג את מצבי ה-Pod, רואים Pod אחד או יותר במצב CrashLoopBackoff או FailedScheduling. |
Apigee Hybrid בלבד |