הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.
לצפייה במסמכי התיעוד של Apigee Edge.
פתרון בעיות הוא גם אמנות וגם מדע. צוותי התמיכה הטכנית של Apigee פועלים כל הזמן כדי להסביר את האומנות ולחשוף את המדע שמאחורי זיהוי הבעיות ופתרונן.
מהם מדריכים לתכנון אסטרטגיה?
המדריכים לפתרון בעיות ב-Apigee פותחו בשיתוף עם צוותי התמיכה הטכנית של Apigee, והם נועדו לספק פתרונות מהירים ויעילים לשגיאות או לבעיות אחרות שבהן אתם עשויים להיתקל במהלך העבודה עם מוצרי Apigee.
קהל
המדריכים לפתרון בעיות מיועדים לקוראים עם הבנה ברמה גבוהה של Apigee והארכיטקטורה שלה, וגם הבנה מסוימת של מושגים בסיסיים כמו כללי מדיניות וניתוח נתונים.
יש בעיות שאפשר לאבחן ולפתור רק על ידי משתמשי Apigee hybrid, ויכול להיות שצריך ידע ברכיבים פנימיים כמו מאגרי נתונים של Cassandra, מעבדי בקשות וסנכרונים.
אם אתם משתמשים ב-Apigee, אנחנו מציינים בבירור מתי אתם יכולים לבצע את השלבים לפתרון הבעיות ומתי אתם צריכים לפנות אל Google 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 |
| הצגה אוטומטית של בעיות | חוסר התאמה באישור Ingress | אחרי שמריצים את הפקודה kubectl -n apigee get apigeeissues, מוצגת השגיאה AIS_INGRESS_CERT_MISMATCH.
|
Apigee Hybrid בלבד |
| הצגה אוטומטית של בעיות | תפוגת התוקף של אישור הכניסה | אחרי שמריצים את kubectl -n apigee get apigeeissues, מוצגת השגיאה AIS_INGRESS_CERT_EXPIREY.
|
רק ב-Apigee Hybrid |
| הצגה אוטומטית של בעיות | תפוגת התוקף של אישור ה-CA של Ingress mTLS | אחרי שמריצים את kubectl -n apigee get apigeeissues, מוצגת השגיאה AIS_INGRESS_MTLS_CA_CERT_EXPIREY.
|
Apigee Hybrid בלבד |
| חשיפה אוטומטית של בעיות | אישור ה-CA של Ingress mTLS לא תקין | אחרי שמריצים את kubectl -n apigee get apigeeissues, מוצגת השגיאה AIS_INGRESS_MTLS_CA_CERT_INVALID.
|
רק ב-Apigee Hybrid |
| Cassandra | שכפול נתוני Cassandra נכשל |
כשמשכפלים נתונים במהלך הרחבה במספר אזורים, יכול להיות שבסטטוס של CassandraDataReplication יופיע מצב שגיאה והשכפול ייכשל.
|
רק ב-Apigee Hybrid |
| Cassandra | בעיות ב-Java heap space של Cassandra |
בעיות ב-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, רואים ש-pod אחד או יותר של 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 |
| ניהול/ממשק משתמש | נתונים לא עקביים או חוסר בנתונים לגבי ישויות בממשק משתמש היברידי או דרך ממשקי Management API | לא ידוע על הודעות שגיאה שמוצגות בתרחיש הזה. | 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 בזמן ניקוז צמתים | כשמרוקנים פודים של Istio, יכול להיות שחלק מהצמתים לא יתרוקנו כי יש להם מספר רפליקות של 1, ונדרשות 3 רפליקות או יותר. כדי למנוע את זה, צריך להגדיר את מספר הרפליקות המינימלי לכל נכס ל-3 לפחות. | Apigee Hybrid בלבד |
| אחר | מדריך לפתרון בעיות במעבד ההודעות |
פוד אחד או יותר של apigee-runtime לא נמצא במצב Ready.
כשמשתמשים ב-kubectl כדי לתאר pod של apigee-runtime שנכשל, מופיעה השגיאה:
Readiness probe failed: HTTP probe failed with statuscode: 500 |
Apigee Hybrid בלבד |
| אחר | הדפסת פרטי הגרסה |
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 או 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 שכנות) | במסמך הזה מוסבר איך לאבחן ולתקן שגיאות מסוג '503 השירות לא זמין' עם TARGET_CONNECT_TIMEOUT כשמשתמשים ביעדים של אינטרנט או של VPC peering. | Apigee |
| הגדרת רשת | 504 הזמן שהוקצב לשער חלף – הזמן הקצוב לקריאת היעד חלף | במסמך הזה מוסבר איך לאבחן ולתקן שגיאות מסוג "504 Gateway Timeout" עם הסיבה 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 או Apigee Hybrid |
במאמר הזה מוסבר איך למחוק באופן מיידי ארגון Apigee או ארגון Apigee Hybrid בלי לשמור את הנתונים, באמצעות האפשרות NO_RETENTION.
|
Apigee ו-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 מוצג קונטיינר אחד מתוך שניים שפועלים |
כשאתם מקבלים את רשימת הפודים, הפודים של apigee-ingressgateway מציגים רק קונטיינר אחד מתוך שניים שפועלים. |
רק ב-Apigee Hybrid |
| התקנה ושדרוג של Apigee Hybrid | שגיאה בתרמיל UDCA | פודים של UDCA ו-Connect Agent מחזירים שגיאה שקשורה להרשאות. | Apigee Hybrid בלבד |
| התקנה ושדרוג של Apigee Hybrid | איפוס החיבור במהלך לחיצת יד בפרוטוקול TLS ללקוחות ללא SNI | איפוס חיבורים נצפה במהלך לחיצת היד בפרוטוקול TLS עבור לקוחות שאינם SNI. | רק ב-Apigee Hybrid |
| התקנה ושדרוג של Apigee Hybrid | אין מספיק מקום בכונן ב-Cassandra | תהליך ההתקנה של Apigee Hybrid נכשל כי אין מספיק מקום בכונן למסד הנתונים של Cassandra. | Apigee Hybrid בלבד |
| התקנה ושדרוג של Apigee Hybrid | אין מספיק מעבדים |
כשמשתמשים ב-kubectl כדי להציג את מצבי ה-pod, רואים pod אחד או יותר במצב CrashLoopBackoff או FailedScheduling. |
רק ב-Apigee Hybrid |