אפשר לגשת ליומני האירועים של השילובים מתוך 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 |
פרויקט Actions של Google Assistant | קונטיינר לפרויקט ב-Google Cloud שמשויך ל-Action של Assistant. |
|
יומני אירועים
בפרויקטים של Cloud-to-cloud יש תמיכה באירועים הבאים ב-Cloud Logging:
| משאב Cloud Logging | אירוע |
|---|---|
| פרויקט Actions של Google Assistant | שגיאות בכוונת SYNC |
| שגיאות בכוונת QUERY | |
| שגיאות בהפעלת כוונות EXECUTE | |
| Notifications errors | |
| שגיאות בקישור חשבונות | |
| Local Home SDK HandlerError |
סנכרון יומנים
בטבלה הבאה מפורטת הסכימה של רשומה מסוג syncLog:
| נכס | תיאור |
|---|---|
requestId |
מזהה בקשה של כוונת משתמש לבית חכם. |
httpLatencyMsec |
הזמן שחלף לפני קבלת התשובה. |
status |
מציין את הסטטוס של התשובה להבעת הכוונה. |
יומני ביצוע
בטבלה הבאה מפורטת הסכימה של רשומה מסוג executionLog:
| נכס | תיאור |
|---|---|
requestId |
מזהה בקשה ייחודי, לדוגמה 5325511189174727525. |
latencyMsec |
הזמן שחלף עד לקבלת תשובה, לדוגמה:
6000. |
executionType |
הפרוטוקול שבו נעשה שימוש לבקשה, למשל CLOUD או
MATTER, בהתאם לשילוב. |
actionType |
אינדיקטור אופציונלי של פעולת המשתמש, לדוגמה QUERY או EXECUTE.
עבור פעולות EXECUTE, כולל את הפקודה שהונפקה למילוי מאפיינים נתמכים, לדוגמה 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.
בוחרים את הפרויקט של הבית החכם.
בוחרים בכרטיסייה פיתוח ולוחצים על פעולות בסרגל הצד.
בתפריט הנפתח Log control ingestion, בוחרים באפשרות All.
החרגות של יומנים
מפתחים יכולים ליצור החרגות של יומנים באמצעות שפת שאילתות של רישום ביומן כדי להתאים אישית את היומנים בצורה גמישה יותר. שפת השאילתות של רישום ביומן משמשת גם את Logs Explorer, כך שתוכלו להשתמש ב-Logs Explorer כדי ליצור שאילתות.
אפשר לפעול לפי השלבים ליצירת מסנני החרגה שמפורטים במדריך הזה (צריך להגדיר את מסנן ההחרגה עבור מאגר _Default).
מדדים מבוססי-יומנים
מפתחים יכולים להשתמש במדדים מבוססי-יומן כדי לעקוב אחרי דפוסים ביומנים שלהם ולנתח אותם. אפשר גם ליצור תרשימים בהתאמה אישית ולהגדיר התראות על מדדים שמבוססים על יומנים.
כדי להתחיל להשתמש במדדים מבוססי-יומן לבית חכם, אפשר לעיין במדריך בנושא יצירת מדד מבוסס-יומן מסוג מונה.
מקורות מידע שקשורים לנושא
מידע נוסף על השימוש ב-Cloud Logging בפרויקט זמין במסמכי התיעוד הבאים:
- תמחור: פרטים על הקצאות ועלויות חריגה.
- מכסות ומגבלות: פרטים על מגבלות ומדיניות שמירת נתונים לרישום שימוש.
- שאילתות מתקדמות ביומנים: מדריך לשימוש בביטויים מתקדמים לשליחת שאילתות ולניתוח נתוני יומנים.