התקנת Cloud Logging באשכולות מצורפים שתואמים ל-CNCF

במאמר הזה מוסבר איך משולבים אשכולות מצורפים של GKE עם Cloud Logging, ואיך ניגשים ליומנים.

סקירה כללית

אשכולות GKE מצורפים תומכים ב-Cloud Logging לעומסי עבודה ולרכיבי מערכת שפועלים בצמתי עובדים.

אשכולות GKE מצורפים כוללים סוכן רישום ביומן שמבוסס על Fluentbit ופועל בצמתים של עובדים בתור Daemonset. אפשר לנהל ולמחוק את הנתונים שנאספים על ידי סוכני הרישום ביומן כמו כל נתון אחר של מדד ויומן, כפי שמתואר במסמכי Cloud Logging.

לפני שמתחילים

  1. צריך לעמוד בדרישות המוקדמות לשימוש ב-GKE Attached Clusters.

  2. נותנים הרשאה ל-Cloud Logging ול-Cloud Monitoring כדי להגדיר הרשאות ל-Google Cloud Observability.

אילו נתונים נאספים

אתם יכולים להגדיר אשכולות GKE מצורפים כך שיאספו את כל המידע הבא או חלק ממנו:

  • יומנים לעומסי עבודה

הפעלת רישום ביומן

אם לא מציינים מצב רישום ביומן כשמצרפים את האשכול, GKE attached clusters מפעיל את רישום היומן של המערכת כברירת מחדל. כדי לרשום ביומן את עומסי העבודה, הגרסה של Kubernetes באשכול צריכה להיות 1.23 ואילך.

כדי להפעיל רישום ביומן של עומסי עבודה כשמצרפים אשכול, פועלים לפי ההוראות לצירוף אשכול שתואם ל-CNCF וכוללים את הדגל האופציונלי --logging בפקודה gcloud container attached clusters register:

gcloud container attached clusters register CLUSTER_NAME
...
--logging=LOGGING_FLAG

כדי להפעיל רישום ביומן של עומסי עבודה באשכול שכבר צורף, פועלים לפי ההוראות לעדכון אשכול שתואם ל-CNCF וכוללים את האפשרות --logging בפקודה gcloud container attached clusters update:

gcloud container attached clusters update CLUSTER_NAME
...
--logging=LOGGING_FLAG

מחליפים את LOGGING_FLAG בדגל שמציין איזה סוג של רישום ביומן רוצים להפעיל:

  • ‫NONE: השבתת רישום ביומן.
  • ‫SYSTEM: הפעלת רישום ביומן של עומסי עבודה של המערכת שפועלים במרחבי שמות ספציפיים.
  • ‫SYSTEM,WORKLOAD: הפעלת רישום ביומן של פעילות המערכת ועומס העבודה בצמתי העובדים של האשכול.

גישה ליומנים

יש כמה דרכים לגשת ליומנים של אשכולות GKE מצורפים ב-Cloud Logging:

  • ‫Logs Explorer – אפשר לראות את היומנים ישירות מ-Logs Explorer באמצעות מסנני הרישום ביומן כדי לבחור את משאבי Kubernetes, כמו יומני אשכול, צומת, מרחב שמות, פוד או קונטיינר.

  • ‫Google Cloud CLI – באמצעות הפקודה gcloud logging read, בוחרים את היומן המתאים של האשכול, הצומת, ה-Pod והקונטיינר.

הסבר על רישומי היומן

יומן ב-Cloud Logging הוא אוסף של רשומות ביומן, וכל רשומה ביומן מתייחסת לסוג מסוים של משאב לרישום ביומן.

סוגי המשאבים

אלה סוגי המשאבים שספציפיים לאשכולות GKE מצורפים:

סוג המשאב השם המוצג
k8s_container יומנים של קונטיינרים של עומסי עבודה

כש-GKE attached clusters כותב את היומנים של האשכול, כל רשומה ביומן כוללת את סוג המשאב. הבנה של המקומות שבהם יומנים מופיעים עוזרת למצוא אותם בקלות כשצריך.

יומנים של אפליקציות מערכת

יומנים של אפליקציות מערכת משויכים לסוג המשאב k8s_container. הם כוללים יומנים מ-Pods שהותקנו בצמתי העובדים על ידי אשכולות GKE מצורפים. באופן ספציפי, נכללים קונטיינרים שפועלים במרחבי השמות הבאים:

  • gke-connect
  • gke-system
  • gmp-system
  • asm-user-auth
  • cnrm-system
  • config-management-system
  • gatekeeper-system
  • gmp-public
  • istio-system
  • knative-serving

איתור היומנים בממשק המשתמש של Cloud Logging

אפשר לצפות ביומנים באמצעות Logs Explorer בממשק המשתמש של Cloud Logging.

Logs Explorer

אפשר להשתמש בכלי ליצירת שאילתות כדי ליצור שאילתה על ידי הוספה ידנית של פרמטרים של שאילתה. לדוגמה, אם רוצים לעיין ביומנים של עומסי עבודה במערכת, אפשר להתחיל בבחירה או בחיפוש של סוג המשאב k8s_container, ואז לבחור את המיקום ואת שם האשכול. אחר כך אפשר לצמצם את החיפוש באמצעות סינון של שמות המאגרים או ה-Pods.

ב-Logs Explorer יש דרך נוספת ליצור שאילתות חיפוש באמצעות הכלי לחיפוש שדות ביומנים. מוצגת בו ספירה של רשומות ביומן, ממוינות לפי ספירה בסדר יורד, בשדה היומן הנתון. השימוש בכלי לבחירת שדות ביומנים שימושי במיוחד ליומנים של אשכולות מצורפים ב-GKE, כי הוא מספק דרך קלה לבחירת ערכי Kubernetes למשאבים. לדוגמה, אפשר לבחור יומנים של אשכול ספציפי, מרחב שמות, שם Pod ושם מאגר.

מידע נוסף זמין במאמר שימוש ב-Logs Explorer.

שאילתות לדוגמה

בקטע הזה יש שאילתות לדוגמה שאפשר להריץ ב-Logs Explorer.

דוגמה 1: קבלת היומנים של מאגר gke-connect-agent עבור אשכולGoogle Cloud CLUSTER_NAME:

resource.type="k8s_container"
resource.labels.cluster_name="attachedClusters/CLUSTER_NAME"
resource.labels.container_name="gke-connect-agent"

המאמרים הבאים