סקירה כללית על סוכן Logging

במדריך הזה מוסבר על סוכן Logging, אפליקציה שמבוססת על fluentd ופועלת במכונות הווירטואליות (VM).

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

השיטה המומלצת היא להריץ את הסוכן Logging בכל מכונות ה-VM שלכם. הסוכן פועל גם ב-Linux וגם ב-Windows.

הוראות להתקנת סוכן Logging מופיעות במאמר התקנת סוכן Logging.

איך סוכן Logging עובד

מערכות הפעלה נתמכות

אפשר להריץ את סוכן Logging במערכות ההפעלה הבאות במכונות וירטואליות (VM) תואמות:

  • Rocky Linux 8
  • ‫RHEL 8: ‏ rhel-8-6-sap-ha, ‏ rhel-8-8-sap-ha
  • ‫SLES 12: ‏ sles-12-sp5-sap
  • ‫SLES 15: sles-15-sp6, sles-15-sp3-sap, sles-15-sp4-sap, sles-15-sp5-sap
  • ‫Windows Server 2016 ו-2019
  • ‫Windows Server Core 2016 ו-2019

אם אתם מפעילים מכונות וירטואליות של מערכת הפעלה שמותאמת לקונטיינרים, אתם צריכים לפעול לפי ההוראות של מערכת הפעלה שמותאמת לקונטיינרים כדי לאסוף יומנים מהמכונות הווירטואליות.

סביבות נתמכות

הסוכן Logging תואם לסביבות הבאות:

  • מכונות של Compute Engine. הסוכן Logging שולח את היומנים לפרויקט שמשויך לכל מכונת VM.

    במכונות ללא כתובות IP חיצוניות, צריך להפעיל גישה פרטית ל-Google כדי לאפשר לסוכן Logging לשלוח יומנים.

עבור מכונות VM אלה, נדרש זיכרון תושב (RSS) בנפח של 250MiB לפחות כדי להריץ את סוכן Logging, אבל מומלץ להשתמש ב-1GiB. לדוגמה, בקצב של 100 רשומות ביומן בגודל 1KB לשנייה, סוכן Logging עם הגדרות ברירת מחדל צורך 5% מהמעבד בליבה אחת ו-150MiB של זיכרון.

מכונות ה-VM הבאות תומכות ב-Logging באמצעות תוכנה משלהן, ולכן אי אפשר להתקין בהן את סוכן ה-Logging באופן ידני:

  • מופעים של הסביבה הרגילה של App Engine. ‫App Engine כולל תמיכה מובנית ב-Logging. למידע נוסף, אפשר לעבור אל כתיבת יומנים של אפליקציות.

  • מופעים של הסביבה הגמישה של App Engine. אפליקציות שפועלות בסביבה הגמישה של App Engine יכולות לכתוב יומנים בנוסף למה שנכלל בסביבה הרגילה של App Engine. מידע נוסף זמין במאמר בנושא כתיבת יומנים של אפליקציות.

  • מופעי צמתים של Google Kubernetes Engine. איסוף יומנים באמצעות Logging מופעל כברירת מחדל באשכולות חדשים של קונטיינרים, או שאפשר להפעיל אותו באשכולות קיימים. מידע נוסף זמין במאמר בנושא הגדרת רישום ביומן ומעקב ב-GKE.

  • במקרים שבהם מופעלות מכונות וירטואליות ב-Google Distributed Cloud, הסוכן אוסף יומני מערכת אבל לא אוסף יומני אפליקציות.

  • מכונות קונטיינר של Cloud Run. ‫Cloud Run כולל תמיכה מובנית ברישום ביומן. מידע נוסף זמין במאמר בנושא רישום ביומן וצפייה ביומנים.

  • פונקציות Cloud Run פונקציות HTTP ופונקציות ברקע. פונקציות Cloud Run כוללות תמיכה מובנית ב-Logging.

תמיכה בעננים מקומיים ובעננים היברידיים

Google Cloud משתפת פעולה עם Bindplane כדי לספק שירותי רישום ביומן עבור פלטפורמות מקומיות וענן היברידי באופן עקבי וצפוי. באמצעות Bindplane, אתם יכולים לאסוף נתונים משלכם ולשלוח אותם ל-Logging לצורך ניתוח. ‫Bindplane משתלב עם Cloud Logging כדי לתעד נתונים מהתשתית שלכם, והוא כלול בפרויקט ללא עלות נוספת.

מידע נוסף על Bindplane ו-Bindplane זמין במאמר מידע על Bindplane ו-Bindplane.

דרישות הגישה לסוכנים

כדי להפעיל את הסוכן, נדרשת גישה לשמות ה-DNS הבאים:

  • שרת הטוקנים של OAuth2: oauth2.googleapis.com

    יכול להיות שבגרסאות ישנות יותר של הסוכן נדרשת גישה אל www.googleapis.com (כתובת URL מלאה: https://www.googleapis.com/oauth2/v3/token).

    אם אתם משתמשים בגרסה ישנה יותר של הסוכן, מומלץ לשדרג את הסוכן לגרסה העדכנית.

  • ממשקי Logging API: logging.googleapis.com

כדי להתקין את הסוכן, צריך גישה לשמות ה-DNS הבאים:

  • (Linux) מאגר חבילות של Google Cloud: ‏ packages.cloud.google.com

  • שרת ההורדות של Google: dl.google.com

קוד המקור של סוכן Logging

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

הסוכן של Logging, ‏ google-fluentd, הוא גרסה שעברה שינוי של כלי איסוף נתוני היומן fluentd. ‫google-fluentd מופץ בשתי חבילות נפרדות. קוד המקור זמין במאגרי GitHub המשויכים:

  • מאגר GitHub בשם google-fluentd, שכולל את תוכנית הליבה fluentd, את סקריפטים של אריזה בהתאמה אישית ואת תוסף הפלט ל-Cloud Logging API.
    • תוסף הפלט ארוז כ-Ruby gem ונכלל בחבילה google-fluentd. הוא זמין גם בנפרד בשירות אירוח Ruby gem בכתובת fluent-plugin-google-cloud.
    • התוכן שקשור לתוכנת ההתקנה של Windows נמצא בתיקייה windows-installer.
  • מאגר GitHub בשם google-fluentd-catch-all-config שכולל את קובצי ההגדרות של סוכן Logging לצורך הטמעה של יומנים מחבילות תוכנה שונות של צד שלישי.

נתוני הגרסה של סוכן Logging

  • נתוני הגרסה של חבילת google-fluentd Linux זמינים בכתובת google-fluentd/releases, שבה תגי הגרסה הם בפורמט של [Major].[Minor].[Patch] ניהול גרסאות סמנטי.

  • הערות המוצר של קובצי ההתקנה ל-Windows נמצאות באותו המיקום: google-fluentd/releases. אבל תגי הגרסה מתחילים בקידומת Windows.

  • נתוני הגרסה של ה-gem העצמאי fluent-plugin-google-cloud זמינים בכתובת fluent-plugin-google-cloud/releases, כאשר תגי הגרסה הם בפורמט [Major].[Minor].[Patch] של גרסאות סמנטיות.

מדיניות הוצאה משימוש

הסוכן Logging כפוף למדיניות הוצאה משימוש של סוכני Google Cloud Observability.

השלבים הבאים