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.

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

ב-Cloud Logging אפשר למצוא את סוגי המשאבים הבאים:

Resource Type השם המוצג התיאור Labels (תוויות)
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 בפרויקט: