זיהוי אוטומטי של בעיות

סקירה כללית

התכונה 'חשיפת בעיות אוטומטית' (AIS) מספקת מידע מהיר על בעיות שמתרחשות באשכול Hybrid. המידע הזה כולל קישורים למסמכי תיעוד לפתרון בעיות. התהליך האוטומטי של הצגת בעיות מחפש רק בעיות נפוצות וידועות שאפשר לזהות במערכת, ולא יכול לזהות את כל הבעיות באשכול.

החל מ-Apigee hybrid v1.10, רכיב ה-watcher של זמן הריצה של Apigee סורק אוטומטית את מצב ה-control plane ואת שרת ה-API של Kubernetes כדי לקבוע אם יש בעיות בהגדרות. כברירת מחדל, הסריקה מתבצעת כל 60 שניות. אם רוצים, אפשר לשנות את המרווח או להשבית את הסריקה.

כש-AIS מזהה בעיה, הוא יוצר מופע חדש של ApigeeIssue בתוך שרת ה-API של Kubernetes. המופעים האלה מכילים מידע על הבעיות וקישורים למסמכי תיעוד בנושא הבעיות הספציפיות.

כשפותרים בעיות, הן נמחקות אוטומטית משרת ה-API של Kubernetes כשהסריקה קובעת שהן כבר לא מתרחשות.

שימוש בחשיפת בעיות אוטומטית.

בודקים אם יש בעיות קיימות באמצעות הפקודה kubectl get apigeeissues: 

kubectl -n APIGEE_NAMESPACE get apigeeissues

לדוגמה:

kubectl -n APIGEE_NAMESPACE get apigeeissues

NAME                                 SEVERITY    AGE URL
vhost-missing-eg-nonprod             Error       1hr https://cloud.google.com/apigee/docs/hybrid/MISSING_ENV_GROUP
control-plane-connectivity-failure   Error       1d  https://cloud.google.com/apigee/docs/hybrid/OLD_TLS_VERSION

כדי לקבל מידע מפורט יותר על בעיה ספציפית, משתמשים בפקודה kubectl describe עם שם הבעיה. לפני השם צריך להוסיף את התחילית apigeeissues, לדוגמה: apigeeissues vhost-missing-eg-nonprod.

kubectl -n APIGEE_NAMESPACE describe apigeeissues vhost-missing-eg-nonprod

Name:         vhost-missing-eg-nonprod
Namespace:    apigee
Labels:       
Annotations:  
API Version:  apigee.cloud.google.com/v1alpha1
Kind:         ApigeeIssue
Metadata:
  Creation Timestamp:  2022-08-25T20:41:56Z
  Managed Fields:
    API Version:  apigee.cloud.google.com/v3
  Resource Version:  12345678
  UID:               aaaaaaaa-bbbb-cccc-dddd-eeeeffffgggg
Spec:
  Severity: Error
  Reason: MISSING_ENV_GROUP
  Details: Expected envgroup "nonprod" for ApigeeRouteConfig "my-org-nonprod"
  Documentation: https://cloud.google.com/apigee/docs/hybrid/MISSING_ENV_GROUP
  Ignore: false
  IgnoreReason:
Events:

שינוי מרווח הסריקה

כברירת מחדל, Watcher סורק את מישור הבקרה כדי לזהות בעיות פעם ב-60 שניות. כדי לשנות את מרווח הזמן בין הסריקות, מציינים את המרווח החדש בשניות באמצעות המאפיין watcher.args.issueScanInterval בקובץ ההחלפות. לדוגמה:

watcher:
  args:
    issueScanInterval: 120

מחילים את ההגדרה.

Helm

משדרגים את התרשים apigee-env לכל סביבת Apigee.

helm upgrade $ORG_NAME apigee-org/ \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE

apigeectl

מחילים את השינוי על כל הסביבות.

apigeectl apply -f OVERRIDES_FILE --org

השבתה של הצגת בעיות באופן אוטומטי

כדי להשבית את התכונה 'זיהוי אוטומטי של בעיות', צריך להגדיר את המאפיין watcher.args.enableIssueScanning לערך false בקובץ השינויים. לדוגמה:

watcher:
  args:
    enableIssueScanning: false

מחילים את ההגדרה.

Helm

משדרגים את התרשים apigee-env לכל סביבת Apigee.

helm upgrade $ORG_NAME apigee-org/ \
  --namespace APIGEE_NAMESPACE \
  -f OVERRIDES_FILE

apigeectl

מחילים את השינוי על כל הסביבות.

apigeectl apply -f OVERRIDES_FILE --org
הצגת בעיות באופן אוטומטי יכולה לספק קישורים ישירות למדריכים לפתרון בעיות, כולל: במאמרים מבוא ל-Apigee X ו-Apigee hybrid playbooks מופיעה סקירה כללית ורשימה של מדריכים לפתרון בעיות ב-Apigee.