אתם צופים במסמכי התיעוד של Apigee ושל Apigee Hybrid.
לעיון במסמכי התיעוד של
Apigee Edge.
פתרון בעיות הוא גם אומנות וגם מדע. צוותי התמיכה הטכנית של Apigee משקיעים מאמצים רבים כדי להסביר את האומנות שמאחורי זיהוי בעיות ופתרונן, ולחשוף את המדע שמאחורי התהליך הזה.
מהם מדריכים?
המדריכים לפתרון בעיות ב-Apigee פותחו בשיתוף עם צוותי התמיכה הטכנית של Apigee, והם נועדו לספק פתרונות מהירים ויעילים לשגיאות או לבעיות אחרות שאתם עשויים להיתקל בהן כשאתם עובדים עם מוצרי Apigee.
קהל
המדריכים לפתרון בעיות מיועדים לקוראים עם הבנה ברמה גבוהה של Apigee והארכיטקטורה שלה, וגם הבנה מסוימת של מושגים בסיסיים כמו מדיניות וניתוח נתונים.
יש בעיות שאפשר לאבחן ולפתור רק אם משתמשים ב-Apigee hybrid, ויכול להיות שיידרש ידע ברכיבים פנימיים כמו מאגרי נתונים של Cassandra, מעבדי הודעות ורכיבי סנכרון.
אם אתם משתמשים ב-Apigee, אנחנו מציינים בבירור מתי אתם יכולים לבצע את שלבי פתרון הבעיות שצוינו ומתי אתם צריכים לפנות אל Cloud Customer Care של Google לקבלת עזרה.
מדריכים
בקטע הזה מתוארים ספרי ההדרכה הנוכחיים.
כדי לסנן את הטבלה הזו, מבצעים אחת או יותר מהפעולות הבאות: בוחרים קטגוריה, בוחרים מוצר, מקלידים מונח חיפוש או לוחצים על כותרת של עמודה כדי למיין.
| קטגוריה | 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 בלבד |
| חשיפה אוטומטית של בעיות | חוסר התאמה בתעודת הכניסה | אחרי שמריצים את הפקודה kubectl -n apigee get apigeeissues, מוצגת השגיאה AIS_INGRESS_CERT_MISMATCH.
|
Apigee Hybrid בלבד |
| חשיפה אוטומטית של בעיות | Ingress cert expiry | אחרי שמריצים את הפקודה 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 | בעיות במרחב הערימה של Cassandra Java |
בעיות ב-heap של Cassandra עלולות לגרום להאטה בהרצת ה-proxy של Apigee hybrid או אפילו לשגיאות Datastore. לפעמים היומנים הם אינדיקטור מוקדם, עוד לפני הופעת התסמינים.
|
Apigee Hybrid בלבד |
| Cassandra | פודים של Cassandra לא מופעלים באזור המשני |
פודים של Cassandra לא מופעלים באחד מהאזורים בהגדרה היברידית של מספר אזורים.
יכול להיות שתופיע הודעת השגיאה node already exists ביומני ה-pod של Cassandra, או
האזהרה FailedPreStopHook בסטטוס ה-pod של Cassandra.
|
Apigee Hybrid בלבד |
| Cassandra | מדריך לפתרון בעיות ב-Cassandra |
כשמשתמשים בפקודה kubectl כדי להציג את מצבי ה-pod, רואים שאחד או יותר מ-Cassandra pods תקועים. במדריך הזה מתוארים אבחון ופתרון של בעיות במאגר הנתונים של 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 נכשלת) או תגובות מ-Apigee.4xx/5xx
|
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 בלבד |
| פריסה | Instance is not reporting status for environment group | פריסות של שרתי 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. | Apigee |
| הגדרת רשת | 504 Gateway timeout - Target read timeout | במאמר הזה מוסבר איך לאבחן ולתקן שגיאות מסוג '504 הזמן שהוקצב לשער חלף' עם הסיבה TARGET_READ_TIMEOUT. | 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 מוצג רק קונטיינר אחד מתוך 2 שפועלים. |
Apigee Hybrid בלבד |
| התקנה ושדרוג של Apigee Hybrid | שגיאה בתרמיל UDC | הפודים של 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 בלבד |