Cloud Logging לסביבה העסקית של Google Home

ענן לענן    נושא

אפשר לגשת ליומני האירועים של השילובים דרך: Google Cloud Logging להשתמש ב-Cloud Logging כדי לעיין ביומנים, ליצור מדדים והתראות, או לייצא יומנים לאפליקציות אחרות באמצעות Google Cloud Pub/Sub

רישום ביומן גישה

כדי לגשת אל Cloud Logging דרך Google Cloud Console, לוחצים על הצגת כל המוצרים ועוברים אל פעולות > רישום ביומן.

מעבר אל Cloud Logging

הגישה לנתוני הרישום ביומן מנוהלת באמצעות ניהול זהויות והרשאות גישה (IAM) למשתמשים בפרויקט Actions שלכם. פרטים נוספים על התפקידים וההרשאות של רישום נתונים ביומן, ראו Cloud Logging בקרת גישה.

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

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

Cloud Logging מספק את סוגי המשאבים הבאים:

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

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

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

משאב Cloud Logging	אירוע
פרויקט פעולה של Google Assistant	שגיאות הקשורות לSYNC של Intent
	QUERY שגיאות הקשורות לכוונות
	EXECUTE שגיאות ב-Intent
	תזכורות שגיאות
	קישור חשבונות שגיאות
	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. בוחרים באפשרות All (הכול) ברשימה הנפתחת Log control control (הטמעת הנתונים של היומן).

החרגות ביומן

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

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

מדדים מבוססי יומן

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

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

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

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

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