Cloud Logging לסביבה העסקית של Google Home

ענן לענן    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.

יומני אירועים

בפרויקטים מסוג Cloud-to-cloud יש תמיכה באירועים הבאים ב-Cloud Logging:

משאב ב-Cloud Logging	אירוע
פרויקט של פעולה ב-Google Assistant	שגיאות בכוונה SYNC
	שגיאות בכוונה QUERY
	שגיאות בכוונה EXECUTE
	התראות שגיאות
	שגיאות בקישור החשבון
	Local Home SDK HandlerError

סנכרון יומנים

בטבלה הבאה מופיעה הסכימה של רשומה syncLog:

נכס	תיאור
requestId	מזהה הבקשה של הכוונה לבית חכם.
httpLatencyMsec	משך הזמן שחלף עד לקבלת תשובה.
status	מציין את הסטטוס של תגובת הכוונה.

יומני ביצוע

בטבלה הבאה מופיעה הסכימה של רשומה 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	קוד השפה שמשויך לבקשה.

יומני התראות

בטבלה הבאה מופיעה הסכימה של רשומה notificationLog:

נכס	תיאור
requestId	מזהה הבקשה להתרעה.
structName	השם של מבנה ההתראה, למשל 'ObjectDetection'.
status	מציין את הסטטוס של ההתראה.

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

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

אתם יכולים לקבוע את רמת היומן של הפרויקט באמצעות:

1. ב-Actions on Google Console, עוברים לדף Projects.

   כניסה למסוף Actions on Google

2. בוחרים את הפרויקט של הבית החכם.

3. בוחרים בכרטיסייה Develop ולוחצים על Actions בסרגל הצד.

4. בוחרים באפשרות הכול ברשימה הנפתחת טמעת בקרת יומנים.

החרגות ביומן

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

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

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

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

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

מקורות מידע שקשורים לנושא

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

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