הדף הזה רלוונטי ל-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 |
| הצגה אוטומטית של בעיות | תפוגת התוקף של אישור Ingress | אחרי שמריצים את 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 |
| הצגה אוטומטית של בעיות | תפוגת התוקף של אישור הלקוח של MCP mTLS | אחרי שמריצים את kubectl -n apigee get apigeeissues, הבעיה AIS_MCP_MTLS_CLIENT_CERT_EXPIRY מוצגת.
|
רק ב-Apigee Hybrid |
| הצגה אוטומטית של בעיות | אישור הלקוח של MCP mTLS לא תקין | אחרי שמריצים את kubectl -n apigee get apigeeissues, מוצגת השגיאה AIS_MCP_MTLS_CLIENT_CERT_INVALID.
|
רק ב-Apigee Hybrid |
| הצגה אוטומטית של בעיות | תפוגת התוקף של אישור ה-CA של MCP mTLS | אחרי שמריצים את kubectl -n apigee get apigeeissues, הבעיה AIS_MCP_MTLS_CA_CERT_EXPIRY מוצגת.
|
רק ב-Apigee Hybrid |
| הצגה אוטומטית של בעיות | אישור ה-CA של MCP mTLS לא תקין | אחרי שמריצים את kubectl -n apigee get apigeeissues, מוצגת השגיאה AIS_MCP_MTLS_CA_CERT_INVALID.
|
רק ב-Apigee Hybrid |
| Cassandra | כשל ברפליקציה של נתוני Cassandra |
כשמשכפלים נתונים במהלך הרחבה למספר אזורים, יכול להיות שבסטטוס של CassandraDataReplication יוצג מצב שגיאה ושכפול הנתונים ייכשל.
|
רק ב-Apigee Hybrid |
| Cassandra | בעיות בזיכרון הערימה של Cassandra Java |
בעיות בערימה של 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 בזמן ניקוז צמתים | כשמרוקנים pod של Istio, יכול להיות שחלק מהצמתים לא יתרוקנו כי יש להם רפליקה אחת, ונדרשות 3 רפליקות או יותר. כדי למנוע את זה, צריך להגדיר את מספר הרפליקות המינימלי לכל נכס ל-3 לפחות. | רק ב-Apigee Hybrid |
| אחר | מדריך לפתרון בעיות במעבד הבקשות |
פוד אחד או יותר של 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 |
כשמרוקנים pod של Istio, יכול להיות שחלק מהצמתים לא יתרוקנו כי יש להם מספר רפליקות של 1, ונדרשות 3 רפליקות או יותר. כדי למנוע את זה, צריך להגדיר את מספר הרפליקות המינימלי לכל נכס ל-3 לפחות.
|
רק ב-Apigee Hybrid |
| הגדרת רשת | פתרון בעיות כשאין מקום פנוי בכתובת ה-IP | במהלך הקצאת היכולות ב-Apigee, אם תבחרו טווח CIDR של רשת שלא פנוי לגמרי, יכול להיות שתופיע הודעת שגיאה. | Apigee ו-Apigee Hybrid |
| הגדרת רשת | שגיאת 503 Service Unavailable עם TARGET_CONNECT_TIMEOUT (יעדים באינטרנט וברשתות VPC שכנות) | במאמר הזה מוסבר איך לאבחן ולתקן שגיאות מסוג "503 Service Unavailable" עם 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 בסטטוס CrashLoopBackOff | תרמילי Cassandra תקועים במצב CrashLoopBackOff אחרי התקנה או שדרוג. | רק ב-Apigee Hybrid |
| התקנה ושדרוג של Apigee Hybrid | פודים של מדדי Apigee בסטטוס CrashLoopBackOff | פודים של מדדי Apigee נשארים במצב CrashLoopBackOff אחרי התקנה או שדרוג. | רק ב-Apigee Hybrid |
| התקנה ושדרוג של Apigee Hybrid | ב-pods של שער הכניסה של Apigee מוצג קונטיינר אחד מתוך שניים שפועלים |
כשאתם מקבלים את רשימת הפודים, ב-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 | אין מספיק מעבדים |
כשמשתמשים ב-kubectl כדי להציג את מצבי ה-Pod, רואים Pod אחד או יותר במצב CrashLoopBackoff או FailedScheduling. |
רק ב-Apigee Hybrid |