גישה ליומני אירועים באמצעות Cloud Logging

אתם יכולים לגשת ליומני האירועים של השילובים ב-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.

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

ב-Cloud Logging אפשר למצוא את סוגי המשאבים הבאים:

Resource Type	השם המוצג	תיאור	Labels (תוויות)
assistant_action_project	פרויקט פעולה ב-Google Assistant	קונטיינר של הפרויקט ב-Google Cloud שמשויך לפעולה של Assistant.	project_id: המזהה של הפרויקט הנוכחי שמשויך למשאב הזה, למשל my-project.

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

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

משאב של Cloud Logging	אירוע
פרויקט פעולה ב-Google Assistant	שגיאות Intent מסוג סנכרון
	QUERY שגיאות Intent
	EXECUTE שגיאות Intent
	שגיאות של התראות
	שגיאות בקישור החשבון
	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 פרויקטים מוגדרים לקבל יומני שגיאות כברירת מחדל, ומפתחים יכולים גם להצטרף כדי לקבל יומני הצלחה. האפשרות הזו שימושית במיוחד בשלב הפיתוח, כשמתכננים לתעד את כל היומנים ממספר נציגים. אם תחרגו ממכסת הרישום ביומן, יכול להיות שיחולו חיובים נוספים על הפרויקט.

ניתן לשלוט ברמת היומן של הפרויקט על ידי:

1. בActions on Google Console נכנסים לדף 'פרויקטים'.

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

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

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

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

החרגות של יומנים

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

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

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

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

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

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

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

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