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

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

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

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

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

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

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

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

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