אפשר לגשת ליומני האירועים של השילובים דרך Google Cloud Logging. אפשר להשתמש ב-Cloud Logging כדי לחקור יומנים, ליצור מדדים והתראות או לייצא יומנים לאפליקציות אחרות באמצעות Google Cloud Pub/Sub.
רישום ביומן של גישה
כדי לגשת אל Cloud Logging מGoogle Cloud Console, לוחצים על כל המוצרים ואז עוברים אל Observability > Logging.
הגישה לנתוני הרישום ביומן מנוהלת באמצעות ניהול זהויות והרשאות גישה (IAM) למשתמשים בפרויקט Actions. לפרטים נוספים על תפקידים והרשאות לרישום נתונים ביומן, קראו את המאמר בקרת גישה ב-Cloud Logging.
רשומות ביומן נשמרות למשך 30 יום בהתאם למדיניות שמירת הנתונים של Cloud Logging, ואז מתוזמנות למחיקה. אתם יכולים גם למחוק רשומות לפי דרישה באמצעות הממשק של Logs Explorer.
בקטע "חיפוש ביומנים" במדריך לפתרון בעיות מוסבר איך להשתמש ביומנים בצורה יעילה.
ב-Cloud Logging יש את סוגי המשאבים הבאים:
| Resource Type | השם המוצג | תיאור | תוויות |
|---|---|---|---|
assistant_action_project |
פרויקט פעולה של Google Assistant | מאגר לפרויקט ב-Google Cloud שמשויך לפעולה ב-Assistant. |
|
יומני הרצה
בטבלה הבאה מפורטת הסכימה של רשומה ב-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 |
קוד השפה שמשויך לבקשה. |
החרגות של יומנים
מפתחים יכולים ליצור החרגות של יומנים באמצעות שפת השאילתות של Logging כדי להתאים אישית את היומנים שלהם בצורה גמישה יותר. שפת השאילתות של Logging משמשת גם את Logs Explorer, כך שאפשר להשתמש ב-Logs Explorer כדי ליצור שאילתות.
כדי ליצור מסנני החרגה, אפשר לפעול לפי השלבים במדריך הזה (הגדרת מסנן ההחרגה לכיור _Default).
מדדים מבוססי-יומנים
מפתחים יכולים להשתמש במדדים מבוססי-יומנים כדי לעקוב אחרי דפוסים ביומנים ולנתח אותם. אפשר גם ליצור תרשימים בהתאמה אישית ולהגדיר התראות במדדים מבוססי-יומנים.
כדי להתחיל להשתמש במדדים מבוססי-יומנים לבית חכם, עיינו במדריך ליצירת מדד מבוסס-יומנים מסוג מונה.
מקורות מידע שקשורים לנושא
למידע נוסף על השימוש ב-Cloud Logging בפרויקט, אפשר לעיין במסמכי התיעוד הבאים:
- תמחור: פרטים על המכסות ועל עלויות החריגה.
- מכסות ומגבלות: פרטים על המגבלות ועל מדיניות השמירה של נתוני השימוש ביומנים.
- שאילתות מתקדמות ביומנים: מדריך לשימוש בביטויים מתקדמים כדי לשלוח שאילתות ולנתח נתוני יומנים.