Cloud Logging בתקן Matter

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

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

כדי לגשת אל Cloud Logging דרך Google Cloud Console, לוחצים על הצגת כל המוצרים ועוברים אל פעולות > רישום ביומן.

מעבר אל Cloud Logging

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

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

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

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

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

יומני ביצוע

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

נכס תיאור
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 בפרויקט מסמכי התיעוד: