ב-Cloud Logging, אובייקט LogEntry יכול לאחסן מטען ייעודי (payload) של יומן כנתונים מובְנים או כטקסט לא מובְנה. ברשומת יומן מובנית, המטען הייעודי מאוחסן כאובייקט JSON בשדה jsonPayload, ואילו ברשומת יומן לא מובנית, המטען הייעודי מאוחסן כמחרוזת בשדה textPayload.
עיצוב המטען הייעודי של היומן כאובייקט JSON מאפשר לחפש ולבצע שאילתות לפי נתיבי JSON ב-Logs Explorer. ביומנים לא מובְנים, אפשר לחפש את מחרוזת הטקסט, אבל אי אפשר לשלוח שאילתות למפתחות ספציפיים.
איך נכתבים יומנים מובְנים
האופן שבו רשומות מובְנות נכתבות ביומן ב-Logging תלוי בסביבה שלכם ובאופן שבו היומנים נאספים:
- ספריות לקוח של Logging: הספריות האלה כותבות יומנים מובְנים כשמעבירים אובייקט JSON או מפה כמטען ייעודי (payload), או כשהן מוציאות פלט של JSON בשורה אחת ל-
stdoutאו ל-stderr.
- Google Cloud CLI או Logging API: אתם יכולים להריץ את
gcloud logging writeעם הדגל--payload-type=json(דוגמה), או להפעיל את ה-methodentries.writeשל ה-API עם אובייקטjsonPayload.
המאמרים הבאים
כדי לשלוח שאילתות ולצפות ברשומות ביומן, קראו את המאמר צפייה ביומנים באמצעות Logs Explorer.
כדי לקרוא רשומות ביומן באמצעות ה-CLI של gcloud, קראו את המאמר קריאת רשומות ביומן.
כדי לקרוא רשומות ביומן באמצעות Logging API, אפשר להשתמש ב-method
entries.list.