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

החרגות של יומנים

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

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

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

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

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

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