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) למשתמשים בפרויקט שלכם ב-Actions. מידע נוסף על תפקידים והרשאות לנתוני רישום ביומן זמין במאמר בקרת גישה ב-Cloud Logging.

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

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

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, הפקודה שהונפקה ל-fulfillment למאפיינים נתמכים, למשל ONOFF_OFF
trait מאפיין אופציונלי שמשויך לפעולת המשתמש הזו.
deviceTypes רשימה של סוגי המכשירים שהושפעו מהאירוע, לדוגמה LIGHT.
isSuccess אם הבקשה קיבלה תשובה מוצלחת.
fallbackToCloud האם הבקשה הועברה למילוי בענן בעקבות שגיאה במילוי המקומי.
statusType הסטטוס של תגובת הכוונה, למשל SUCCESS,‏ PENDING או OFFLINE. בתשובות מסוג ERROR, המאפיין הזה מכיל את הערך של errorCode שסופק על ידי השירות להשלמה.
externalDebugString הודעה מפורטת אופציונלית לניפוי באגים שמשויכת לפעולה הזו של המשתמש.
locale קוד השפה שמשויך לבקשה.

החרגות ביומן

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

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

מדדים מבוססי-יומנים

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

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

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