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

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

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

השיטה המומלצת היא להריץ את הסוכן Logging בכל מכונות ה-VM שלכם. ה-agent פועל גם ב-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 שולח את היומנים לפרויקט שמשויך לכל מכונה וירטואלית.

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

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

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

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

מידע נוסף על Bindplane ו-Bindplane

דרישות הגישה של הסוכן

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

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

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

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

  • ממשקי API של רישום ביומן: logging.googleapis.com

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

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

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

סביבות מנוהלות לא נתמכות

במכונות ה-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 יש תמיכה מובנית ב-Logging. מידע נוסף זמין במאמר רישום ביומן וצפייה ביומנים.

  • פונקציות HTTP ופונקציות ברקע של Cloud Run. פונקציות Cloud Run כוללות תמיכה מובנית ב-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

  • נתוני הגרסה של חבילת 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] של ניהול גרסאות סמנטי.

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

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

השלבים הבאים