אפשר לגשת ליומני האירועים של השילובים דרך 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. |
|
יומני אירועים
בפרויקטים ב-Cloud-to-cloud יש תמיכה באירועים הבאים ב-Cloud Logging:
| משאב של Cloud Logging | אירוע |
|---|---|
| פרויקט פעולה של Google Assistant | שגיאות ב-intent מסוג SYNC |
| שגיאות ב-intent מסוג QUERY | |
| שגיאות ב-intent מסוג EXECUTE | |
| התראות שגיאות | |
| שגיאות בקישור חשבונות | |
| Local Home SDK HandlerError |
יומני סנכרון
בטבלה הבאה מפורטת הסכימה של רשומה ב-syncLog:
| נכס | תיאור |
|---|---|
requestId |
מזהה הבקשה של ה-intent בבית החכם. |
httpLatencyMsec |
הזמן שחלף עד לקבלת תשובה. |
status |
מציין את הסטטוס של התגובה ל-Intent. |
יומני הרצה
בטבלה הבאה מפורטת הסכימה של רשומה ב-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 |
קוד השפה שמשויך לבקשה. |
יומני התראות
בטבלה הבאה מפורטת הסכימה של רשומה ב-notificationLog:
| נכס | תיאור |
|---|---|
requestId |
מזהה בקשת ההתראה. |
structName |
שם המבנה של ההתראה, למשל "ObjectDetection". |
status |
מציין את הסטטוס של ההתראה. |
הגדרת רמת הרישום ביומן
כברירת מחדל, פרויקטים ב-Cloud-to-cloud מוגדרים לקבל יומני שגיאות, ומפתחים יכולים להביע הסכמה לקבל גם יומני הצלחה. זה שימושי במיוחד בשלב הפיתוח, כשרוצים לתעד את כל היומנים מכמה סוכנים. אם חורגים ממכסת הרישום ביומן, יכול להיות שיהיו חיובים נוספים בפרויקט.
אתם יכולים לשלוט ברמת הרישום ביומן של הפרויקט באמצעות:
ב-Actions on Google Console, נכנסים לדף Projects.
בוחרים את הפרויקט של הבית החכם.
בוחרים בכרטיסייה Develop (פיתוח) ולוחצים על Actions (פעולות) בסרגל הצד.
ברשימה הנפתחת Log control ingestion, בוחרים באפשרות All.
החרגות של יומנים
מפתחים יכולים ליצור החרגות של יומנים באמצעות שפת השאילתות של Logging כדי להתאים אישית את היומנים שלהם בצורה גמישה יותר. שפת השאילתות של Logging משמשת גם את Logs Explorer, כך שאפשר להשתמש ב-Logs Explorer כדי ליצור שאילתות.
כדי ליצור מסנני החרגה, אפשר לפעול לפי השלבים במדריך הזה (הגדרת מסנן ההחרגה לכיור _Default).
מדדים מבוססי-יומנים
מפתחים יכולים להשתמש במדדים מבוססי-יומנים כדי לעקוב אחרי דפוסים ביומנים ולנתח אותם. אפשר גם ליצור תרשימים בהתאמה אישית ולהגדיר התראות במדדים מבוססי-יומנים.
כדי להתחיל להשתמש במדדים מבוססי-יומנים לבית חכם, עיינו במדריך ליצירת מדד מבוסס-יומנים מסוג מונה.
מקורות מידע שקשורים לנושא
למידע נוסף על השימוש ב-Cloud Logging בפרויקט, אפשר לעיין במסמכי התיעוד הבאים:
- תמחור: פרטים על המכסות ועל עלויות החריגה.
- מכסות ומגבלות: פרטים על המגבלות ועל מדיניות השמירה של נתוני השימוש ביומנים.
- שאילתות מתקדמות ביומנים: מדריך לשימוש בביטויים מתקדמים כדי לשלוח שאילתות ולנתח נתוני יומנים.