רישום מובנה ביומן

מאמרי עזרה זה דנים בקונספט של רישום ביומן מובנה ובשיטות להוספת מבנה לשדות של מטען ייעודי (payload) ברשומות ביומן. כשמטען ייעודי של יומן מעוצב כאובייקט JSON והאובייקט הזה מאוחסן בשדה jsonPayload, רשומת היומן נקראת יומן מובנה. במקרה של היומנים האלה, אפשר ליצור שאילתות שמחפשות נתיבי JSON ספציפיים, ואפשר ליצור אינדקס לשדות ספציפיים במטען הייעודי (payload) של היומן. לעומת זאת, אם מטען הייעודי (payload) של היומן מעוצב כמחרוזת ומאוחסן בשדה textPayload, רשומת היומן היא לא מובנית. אפשר לחפש בשדה הטקסט, אבל אי אפשר ליצור אינדקס של התוכן שלו.

כדי ליצור רשומות יומן מובנות, מבצעים אחת מהפעולות הבאות:

  • קוראים לשיטת ה-API‏ entries.write ומספקים LogEntry בפורמט מלא.
  • משתמשים בפקודה gcloud logging write.
  • שימוש בספריית לקוח של Cloud Logging שכותבת יומנים מובנים.
  • להשתמש בשירות BindPlane.

  • שימוש בסוכן לכתיבת יומנים:

    • חלק מה Google Cloud שירותים מכילים סוכן רישום ביומן משולב ששולח את הנתונים שנכתבו ב-stdout או ב-stderr כיומנים ל-Cloud Logging. אפשר להשתמש בגישה הזו Google Cloud בשירותים כמו Google Kubernetes Engine,‏ סביבה גמישה ב-App Engine ופונקציות Cloud Run.
    • למכונות וירטואליות (VM) ב-Compute Engine, מומלץ להתקין ולהגדיר את סוכן תפעול כדי לשלוח יומנים מובנים ל-Cloud Logging. אם המכונות הווירטואליות הקיימות שלכם משתמשות בסוכן Logging מדור קודם, חשוב לדעת שהתמיכה בסוכן הזה הסתיימה. מידע על חלופות להעברה מסוכן Logging מדור קודם זמין במדריך להעברה. אפשר גם לקרוא את המאמר רישום מובנה ביומן באמצעות סוכן Logging מדור קודם כדי לקבל מידע על שימוש בסוכן Logging מדור קודם לכתיבת יומנים מובנים.

דוגמאות קוד מופיעות במאמר בנושא כתיבת יומנים מובְנים.

כתיבת יומנים באמצעות ה-CLI של gcloud

אפשר לכתוב נתוני יומן באמצעות ה-CLI של gcloud. הממשק תומך ביומנים לא מובנים וביומנים מובנים. כשרוצים לכתוב יומן מובנה, צריך לספק לפקודה אובייקט JSON שעבר סריאליזציה.

מדריך למתחילים: כתיבה של רשומות ביומן ושאילתות לגביהן באמצעות Google Cloud CLI

דוגמאות קוד מופיעות במאמר בנושא gcloud logging write.

כתיבת יומנים באמצעות BindPlane

אפשר להשתמש בשירות BindPlane כדי לשלוח יומנים ל-Logging. במקרה של היומנים האלה, המטען הייעודי (payload) הוא בפורמט JSON והמבנה שלו תלוי במערכת המקור. מידע על איתור וצפייה ביומנים שנקלטים באמצעות BindPlane זמין במדריך למתחילים של BindPlane.

כתיבת יומנים באמצעות סוכן התפעול

כדי לקבל יומנים מהמכונות של Compute Engine, אפשר להשתמש בסוכן תפעול. סוכן התפעול משלב יומנים ומדדים בסוכן יחיד, מספק הגדרה מבוססת-YAML וכולל רישום ביומן עם תפוקה גבוהה.

במאמר הגדרת סוכן תפעול מוסבר איך מגדירים את סוכן תפעול כדי לתמוך ברישום ביומן מובנה או כדי להתאים אישית את הצורה של יומן מובנה.

פתרון בעיות

כדי לפתור בעיות נפוצות שקשורות להתקנה של Ops Agent או לאינטראקציה איתו, אפשר לעיין במאמר פתרון בעיות שקשורות לסוכן.

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