במאמר הזה נסביר את המושג 'רישום מובנה ביומן' ואת השיטות להוספת מבנה לשדות של מטען ייעודי (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.