אפשר לגשת ליומני האירועים של השילובים דרך Google Cloud Logging. אפשר להשתמש ב-Cloud Logging כדי לעיין ביומני אירועים, ליצור מדדים והתראות או לייצא יומנים לאפליקציות אחרות באמצעות Google Cloud Pub/Sub.
רישום ביומן של אירועי גישה
כדי לגשת ל-Cloud Logging מ-Google Cloud Console, לוחצים על View all products (הצגת כל המוצרים) ואז עוברים אל Operations (פעולות) > 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. |
|
יומני אירועים
בפרויקטים מסוג 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 מוגדרים לקבל יומני שגיאות כברירת מחדל, ואפשר להביע הסכמה לקבל גם יומני הצלחה. האפשרות הזו שימושית במיוחד בשלב הפיתוח, כשרוצים לתעד את כל היומנים מכמה סוכנים. אם תחרגו ממכסת הרישום ביומן, יכול להיות שיחולו חיובים נוספים על הפרויקט.
אתם יכולים לקבוע את רמת היומן של הפרויקט באמצעות:
ב-Actions on Google Console, עוברים לדף Projects.
בוחרים את הפרויקט של הבית החכם.
בוחרים בכרטיסייה Develop ולוחצים על Actions בסרגל הצד.
בוחרים באפשרות הכול ברשימה הנפתחת טמעת בקרת יומנים.
החרגות ביומן
מפתחים יכולים ליצור החרגות ביומן באמצעות שפת השאילתות של הרישום ביומן כדי להתאים אישית את היומנים שלהם בצורה גמישה יותר. שפת השאילתות של הרישום ביומן משמשת גם את Logs Explorer, כך שאפשר להשתמש ב-Logs Explorer כדי ליצור שאילתות.
אפשר לפעול לפי השלבים ליצירת מסנני החרגה שמפורטים במדריך הזה (מגדירים את מסנן ההחרגה לבור הנתונים _Default
).
מדדים מבוססי-יומנים
מפתחים יכולים להשתמש במדדים שמבוססים על יומנים כדי לעקוב אחרי דפוסים ביומני המערכת ולנתח אותם. אפשר גם ליצור תרשימים בהתאמה אישית ולהגדיר התראות לגבי מדדים שמבוססים על יומנים.
כדי להתחיל להשתמש במדדים שמבוססים על יומנים לבית חכם, כדאי לעיין במדריך ליצירת מדד שמבוסס על יומן ספירה לאחור.
מקורות מידע שקשורים לנושא
מידע נוסף על השימוש ב-Cloud Logging בפרויקט זמין במסמכי העזרה הבאים:
- תמחור: פרטים על המכסות ועלויות של חריגה מהמכסה.
- מכסות ומגבלות: פרטים על המגבלות ועל מדיניות השמירה של השימוש ביומן.
- שאילתות מתקדמות ביומן: מדריך לשימוש בביטויים מתקדמים כדי לשלוח שאילתות ולנתח נתוני יומן.