המופע לא מדווח על הסטטוס של קבוצת הסביבות

הדף הזה רלוונטי ל-Apigee ול-Apigee Hybrid.

לעיון במסמכי התיעוד של Apigee Edge.

תסמינים

פריסות של שרתי proxy ל-API או של תהליכים משותפים נכשלות עם השגיאה Instance INSTANCE_NAME is not reporting status for environment group ENV_GROUP_NAME בממשק המשתמש של Apigee Hybrid.

הודעות שגיאה

השגיאה The Instance INSTANCE_NAME is not reporting status for environment group ENV_GROUP_NAME מוצגת בתפריט proxies ל-API בכרטיסייה Overview כשמעבירים את העכבר מעל סימן הקריאה האדום שמופיע בעמודה Status בקטע Deployments:

instance-not-reporting-status

סיבות אפשריות

מטרה תיאור
הבורר app: apigee-ingressgateway חסר כשמשתמשים ב-Apigee Ingress, הקובץ overrides.yaml צריך לכלול את הסלקטור app: apigee-ingressgateway בקטע virtualhosts.
ApigeeRoute לא עדכני או סביבה שנמחקה רק במישור הבקרה סביבה או פריסה הוסרו ממישור הבקרה או מהאשכול בלי להשלים את תהליך העבודה המלא של Full Delete, וכתוצאה מכך נשארו באשכול משאבים לא עדכניים של ApigeeRoute או של הסביבה.
חסימת תעבורת נתונים יוצאת ברשת אל Google APIs צומתי העובדים של האשכול לא יכולים ליצור חיבורים יוצאים לאימות של Google ולממשקי ה-API של מישור הבקרה של Apigee ב-*.googleapis.com:443.
שער הכניסה או פודים של זמן ריצה לא מוכנים ‫apigee-ingressgateway Pods לא פועלים כשכל הקונטיינרים מוכנים (2/2), או apigee-runtime Pods לא מוכנים (0/1) בגלל בדיקת READINESS:VersionLoadProbe שנכשלה.

הסיבה: חסר הסלקטור app: apigee-ingressgateway

כשמשתמשים בשער הכניסה של Apigee, הקובץ overrides.yaml כולל קטע להגדרת virtualhosts שבו צריך להגדיר את הבורר app: apigee-ingressgateway.

אבחון

קודם כל, ודאו שאתם משתמשים בשער הכניסה של Apigee שזמין בגרסה 1.8 ומעלה של Apigee Hybrid (ההגדרה הבאה לא פועלת ב-Istio ASM בניהול הלקוח). בקובץ overrides.yaml שכולל את קבוצת הסביבות שמוזכרת בשגיאה, מחפשים את הקטע virtualhosts ובודקים אם חסרים הסלקטורים הבאים:

  selector:
    app: apigee-ingressgateway
    ingress_name: INGRESS_NAME

רזולוציה

עורכים את הקובץ overrides.yaml כך שהקטע virtualhosts[].selector ייראה כמו בדוגמה הבאה:

    virtualhosts:
    - name: my-environment-group
      sslCertPath: my-cert.crt
      sslKeyPath: my-cert.key
      selector:
        app: apigee-ingressgateway
        ingress_name: INGRESS_NAME
  

אחרי שעורכים את הקובץ overrides.yaml, מחילים את ההגדרות החדשות באמצעות Helm:

הרצת בדיקה:

helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
--namespace APIGEE_NAMESPACE \
--atomic \
--set envgroup=ENV_GROUP \
-f OVERRIDES_FILE \
--dry-run=server

חשוב לכלול את כל ההגדרות שמוצגות, כולל --atomic כדי שהפעולה תבוטל אם היא תיכשל.

יכול להיות שההתקנה הוגדרה באמצעות ENV_GROUP_RELEASE_NAME שונה מ-ENV_GROUP. למידע על ההגדרות, ראו התקנת Apigee Hybrid באמצעות Helm.

מתקינים את התרשים:

helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
--namespace APIGEE_NAMESPACE \
--atomic \
--set envgroup=ENV_GROUP \
-f OVERRIDES_FILE

הסיבה: ApigeeRoute לא עדכני או סביבה שנמחקה רק במישור הבקרה

כשמסירים סביבה או פריסת סביבת זמן ריצה ממישור הבקרה או מהאשכול בלי להשלים את כל תהליך העבודה של המחיקה, יכול להיות שמשאבים ישנים של ApigeeRoute או של הסביבה יישארו באשכול. כש-apigee-watcher מנסה להתאים את הניתוב לקבוצת הסביבות ונתקל בשירות Kubernetes, בפריסה או בסביבה של מישור הבקרה שחסרים, הוא לא יכול להשלים את עדכון הניתוב או לדווח על סטטוס הפריסה למישור הבקרה.

אבחון

  1. בודקים את יומני ה-Pod של apigee-watcher כדי לראות אם יש שגיאות שקשורות לשירות או לסביבה חסרים:

    kubectl logs -n APIGEE_NAMESPACE -l app=apigee-watcher --since=2h
    

    מחפשים רשומות ביומן שדומות לאלה:

    • ApigeeRoute לא עדכני מפנה לשירות זמן ריצה או לפריסה שנמחקו:

      {"level":"error","caller":"watcher/watcher.go:60","msg":"error during watch","name":"ingressstatus","error":"INTERNAL: NOT_FOUND: failed to get service: services \"apigee-runtime-ORG_ENV_HASH\" not found"}
    • סביבה נמחקה במישור הבקרה, אבל משאבי זמן הריצה שלה נשארו באשכול:

      {"level":"error","caller":"watcher/watcher.go:60","msg":"error during watch","name":"ingress","error":"INVALID_ARGUMENT: err fetching environment data: NOT_FOUND: {\n  \"error\": {\n    \"code\": 404,\n    \"message\": \"generic::not_found: resource organizations/ORG_NAME/environments/ENV_NAME not found\",\n    \"status\": \"NOT_FOUND\"\n  }\n}"}
  2. בודקים את המשאבים של ApigeeRoute במרחב השמות (apigee כברירת מחדל) כדי לזהות נתיב שמפנה ל-ApigeeDeployment או לשירות שלא קיימים:

    kubectl get ApigeeRoute -n APIGEE_NAMESPACE
    kubectl describe ApigeeRoute APIGEE_ROUTE_NAME -n APIGEE_NAMESPACE
    

רזולוציה

  1. מוחקים את המשאב הלא תקין של ApigeeRoute:

    kubectl delete ApigeeRoute APIGEE_ROUTE_NAME -n APIGEE_NAMESPACE
    
  2. מגדירים מחדש את הנתיב על ידי החלה מחדש של תרשים ה-Helm של apigee-virtualhost:

    helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
      -n APIGEE_NAMESPACE \
      --atomic \
      --set envgroup=ENV_GROUP \
      -f OVERRIDES_FILE
    
  3. אם סביבה נמחקה רק במישור הבקרה (מה שגורם ל-err fetching environment data: NOT_FOUND), מסירים את גרסת ה-Helm של הסביבה (helm delete ENV_RELEASE_NAME -n APIGEE_NAMESPACE) ומסירים את הסביבה מהקובץ overrides.yaml, כמו שמתואר בקטע מחיקת סביבות.

הסיבה: תעבורת הנתונים היוצאת ברשת אל Google APIs חסומה

הרכיב apigee-synchronizer דוגם את מישור הבקרה של Apigee כדי להוריד חוזים של הגדרות זמן ריצה לפודים של apigee-runtime, ו-apigee-watcher מתחבר למישור הבקרה כדי לאחזר את הגדרת ה-Ingress ולדווח על סטטוס הפריסה. אם תעבורת הנתונים היוצאת מצומתי העובדים של האשכול אל Google APIs חסומה, הרכיבים האלה לא יכולים לאמת או לתקשר עם מישור הבקרה.

אבחון

  1. בודקים ביומני ה-pod של apigee-synchronizer אם יש שגיאות אימות ושגיאות של זמן קצוב לתפוגה של החיבור:

    kubectl logs -n APIGEE_NAMESPACE -l app=apigee-synchronizer --since=2h
    

    מחפשים שגיאות של זמן קצוב לתפוגה מסוג GoogleAuthException כשמאחזרים טוקן גישה:

    "logger":"CONTRACT-REPLICATION","exceptionStackTrace":"com.google.auth.oauth2.GoogleAuthException: Error getting access token for service account: connect timed out, iss: SERVICE_ACCOUNT_EMAIL"
  2. בודקים את יומני ה-Pod של apigee-watcher כדי לאתר כשלים בקישוריות של מישור הבקרה:

    kubectl logs -n APIGEE_NAMESPACE -l app=apigee-watcher --since=2h
    

    מחפשים שגיאות control-plane connectivity test failed עם זמן קצוב לתפוגה של TCP ליציאה 443:

    {"level":"error","caller":"issuescan/cp_connectivity_scanner.go:68","msg":"control-plane connectivity test failed","organization":"ORG_NAME","error":"Get \"https://apigee.googleapis.com/v1/organizations/ORG_NAME\": oauth2: cannot fetch token: Post \"https://oauth2.googleapis.com/token\": dial tcp IP_ADDRESS:443: i/o timeout"}

רזולוציה

מוודאים שהכללים של חומת האש לתעבורת נתונים יוצאת, שערי ה-NAT, רשימות ה-ACL של הרשת והגדרות שרת ה-proxy להעברת HTTP או HTTPS מאפשרים לצומתי העובדים של האשכול להגיע אל *.googleapis.com:443 (כולל apigee.googleapis.com ו-oauth2.googleapis.com). הרשימה המלאה של הדומיינים הנדרשים והשלבים לפתרון בעיות בקישוריות מפורטים במאמרים כתובות ה-URL של Google Cloud שצריך לאפשר ב-Hybrid ואין קישוריות רשת בין מישור זמן הריצה למישור הבקרה.

הסיבה: פודים של שער Ingress או של סביבת זמן ריצה לא מוכנים

כדי לאמת את סטטוס הפריסה ולדווח עליו, apigee-watcher מאחזר את קובצי ה-dump של הגדרות הניתוב מה-pods של apigee-ingressgateway ובודק את המוכנות של ה-pods של apigee-runtime. אם הפודים של שער הכניסה לא פועלים ומוכנים, או אם הפודים של זמן הריצה לא טענו את חוזה הסביבה, הדיווח על סטטוס הפריסה נכשל.

אבחון

  1. בודקים את הסטטוס של הפודים של apigee-ingressgateway:

    kubectl get pods -n APIGEE_NAMESPACE -l app=apigee-ingressgateway
    

    מוודאים שכל הפודים של apigee-ingressgateway נמצאים במצב Running עם קונטיינרים של 2/2 מוכנים. אם הפודים של שער הכניסה לא פועלים, 2/2, apigee-watcher לא יכול לאחזר את ה-dump של הגדרת Envoy שנדרש כדי לאמת את הפריסה.

  2. בודקים את הסטטוס של הפודים של apigee-runtime:

    kubectl get pods -n APIGEE_NAMESPACE -l app=apigee-runtime
    

    אם הפודים של apigee-runtime הם Running אבל לא מוכנים (0/1), בודקים את האירועים והיומנים של הפודים:

    kubectl describe pod RUNTIME_POD_NAME -n APIGEE_NAMESPACE
    kubectl logs RUNTIME_POD_NAME -n APIGEE_NAMESPACE
    

    מחפשים כשלים בבדיקת המוכנות (Readiness probe failed: HTTP probe failed with statuscode: 500) ושגיאות READINESS:VersionLoadProbe שמציינות שחוזה זמן הריצה לא נטען:

    {"level":"SEVERE","className":"com.apigee.probe.ProbeServiceImpl","severity":"SEVERE","message":"probe \"READINESS:VersionLoadProbe\" execution failed due to Version not loaded by Message Processor","logger":"ProbeServiceImpl"}

רזולוציה

לפני הפריסה מחדש, פותרים בעיות בהפעלת pod, מגבלות על משאבי אשכול (מגבלות מעבד או זיכרון) או בעיות בהורדת חוזה של סנכרון, כדי ש-apigee-ingressgateway pods יגיעו ל-2/2 מוכנים ו-apigee-runtime pods יגיעו ל-1/1 מוכנים. במדריך לפתרון בעיות במעבד הבקשות מפורטים שלבים נוספים לפתרון בעיות שקשורות לכשלים בבדיקת המוכנות של apigee-runtime.

קובצי עזר