הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.
לעיון במסמכי התיעוד של Apigee Edge
פתרון בעיות הוא גם אומנות וגם מדע. צוותי התמיכה הטכנית של Apigee משקיעים מאמצים רבים כדי להסביר את האומנות שמאחורי זיהוי בעיות ופתרונן, ולחשוף את המדע שמאחורי התהליך הזה.
מהם מדריכים?
המדריכים לפתרון בעיות ב-Apigee פותחו בשיתוף עם צוותי התמיכה הטכנית של Apigee, והם נועדו לספק פתרונות מהירים ויעילים לשגיאות או לבעיות אחרות שאתם עשויים להיתקל בהן כשאתם עובדים עם מוצרי Apigee.
קהל
המדריכים לפתרון בעיות מיועדים לקוראים עם הבנה ברמה גבוהה של Apigee והארכיטקטורה שלה, וגם הבנה מסוימת של מושגים בסיסיים כמו מדיניות וניתוח נתונים.
יש בעיות שאפשר לאבחן ולפתור רק אם משתמשים ב-Apigee hybrid, ויכול להיות שיידרש ידע ברכיבים פנימיים כמו מאגרי נתונים של Cassandra, מעבדי הודעות ורכיבי סנכרון.
אם אתם משתמשים ב-Apigee, אנחנו מציינים בבירור מתי אפשר לבצע את שלבי פתרון הבעיות שמופיעים ומתי צריך לפנות אל Cloud Customer Care לקבלת עזרה.
פלייבוקים
בקטע הזה מתוארים ספרי ההדרכה הנוכחיים.
כדי לסנן את הטבלה הזו, מבצעים אחת או יותר מהפעולות הבאות: בוחרים קטגוריה, בוחרים מוצר, מקלידים מונח חיפוש או לוחצים על כותרת של עמודה כדי למיין.
| קטגוריה | Playbook/Problem description | הודעת השגיאה | הפלייבוק רלוונטי ל |
|---|---|---|---|
| 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 בלבד |
| זיהוי אוטומטי של בעיות | חוסר התאמה בתעודה של Ingress | אחרי שמריצים את הפקודה 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 |
| ניהול/ממשק משתמש | לא נצפו נתונים או שנצפו נתונים לא עקביים לגבי ישויות בממשק משתמש היברידי או באמצעות ממשקי ניהול | לא ידוע על הודעות שגיאה שמוצגות בתרחיש הזה. | 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 כדי לתאר pod שנכשל, מוצגת השגיאה: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 |
כשמרוקנים את ה-pods של 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 | Apigee ingress gateway pods מציגים 1 מתוך 2 קונטיינרים שפועלים |
כשמקבלים את רשימת הפודים, בפודים של apigee-ingressgateway מוצג רק קונטיינר אחד מתוך שניים שפועלים. |
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 בלבד |