מבוא ל-Apigee ולמדריכים בנושא Apigee Hybrid

הדף הזה רלוונטי ל-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 נכשלות:

  • מוצרי API, מפתחים ואפליקציות לא מאוכלסים בממשק המשתמש של Apigee.
  • פריסות של שרתי proxy ל-API לא מסתיימות.
  • בקשות לניהול 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