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