Cloud Logging בתקן Matter

אפשר לגשת ליומני האירועים של השילובים שלכם מ-Google Cloud Logging. איך משתמשים ב-Cloud Logging כדי לעיין ביומנים, ליצור מדדים והתראות או לייצא יומנים לאפליקציות אחרות באמצעות Google Cloud Pub/Sub.

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

כדי לגשת אל Cloud Logging דרך Google Cloud Console, לוחצים על View all products ואז עוברים אל Operations > Logging.

מעבר אל Cloud Logging

הגישה לנתוני הרישום ביומן מנוהלת באמצעות ניהול זהויות והרשאות גישה (IAM) למשתמשים בפרויקט הפעולות שלכם. במאמר בקרת גישה ב-Cloud Logging תוכלו לקרוא פרטים נוספים על התפקידים וההרשאות לרישום נתונים.

הרשומות ביומן נשמרות למשך 30 ימים בהתאם למדיניות השמירה של Cloud Logging, ולאחר מכן מתוזמנות למחיקה. תוכלו גם למחוק רשומות לפי דרישה באמצעות ממשק Logs Explorer.

בקטע 'חיפוש יומנים' במדריך לפתרון בעיות תוכלו לקרוא מידע נוסף על שימוש יעיל ביומנים.

Cloud Logging מספק את סוגי המשאבים הבאים:

Resource Type השם המוצג תיאור תוויות
assistant_action_project פרויקט פעולה של Google Assistant מאגר של הפרויקט ב-Google Cloud שמשויך לפעולת Assistant.
  • project_id: המזהה של הפרויקט הנוכחי שמשויך למשאב הזה, לדוגמה my-project.

יומני ביצוע

בטבלה הבאה מוצגת הסכימה של רשומת executionLog:

מאפיין (property) תיאור
requestId מזהה בקשה ייחודי, לדוגמה 5325511189174727525.
latencyMsec הזמן שעבר עד שהתקבלה תשובה, לדוגמה, 6000.
executionType אמצעי התחבורה שבו נעשה שימוש בבקשה, לדוגמה CLOUD או MATTER, בהתאם לשילוב.
actionType אינדיקטור אופציונלי של פעולת המשתמש שבוצעה, לדוגמה QUERY או EXECUTE. עבור פעולות EXECUTE, כולל הפקודה שהונפקה למילוי הזמנות של מאפיינים נתמכים, לדוגמה ONOFF_OFF
trait תכונה אופציונלית שמשויכת לפעולת המשתמש הזאת.
deviceTypes רשימה של סוגי המכשירים שמושפעים מהאירוע, לדוגמה LIGHT.
isSuccess האם הבקשה קיבלה תגובה מוצלחת.
fallbackToCloud האם הבקשה הועברה למילוי הזמנות בענן בעקבות שגיאה ממילוי הזמנות מקומי.
statusType זהו הסטטוס של התגובה ל-Intent, למשל SUCCESS, PENDING או OFFLINE. לתשובות ERROR, המאפיין הזה מכיל את errorCode שסופק על ידי מילוי ההזמנות.
externalDebugString הודעה מפורטת אופציונלית לניפוי באגים שמשויכת לפעולת המשתמש הזאת.
locale קוד השפה שמשויך לבקשה.

החרגות ביומן

המפתחים יכולים ליצור החרגות ליומנים באמצעות שפת השאילתות ביומן כדי להתאים אישית את היומנים בצורה גמישה יותר. שפת השאילתה ביומן משמשת גם ב-Logs Explorer, כדי שתוכלו להשתמש ב-Logs Explorer כדי ליצור שאילתות.

תוכלו לבצע את השלבים ליצירת מסנני החרגה במדריך הזה (מגדירים את מסנן ההחרגה של ה-sink _Default).

מדדים מבוססי יומן

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

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

למידע נוסף על השימוש ב-Cloud Logging בפרויקט, תוכלו לעיין במאמרי העזרה הבאים: