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

ענן לענן    Matter

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

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

כדי לגשת אל Cloud Logging דרך Google Cloud Console, לוחצים על View all products ואז עוברים אל Operations > Logging.

מעבר אל Cloud Logging

הגישה לנתוני הרישום ביומן מנוהלת באמצעות ניהול זהויות והרשאות גישה (IAM) למשתמשים בפרויקט הפעולות שלכם. במאמר בקרת גישה ב-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 Logging:

משאב Cloud Logging אירוע
פרויקט פעולה של Google Assistant שגיאות הקשורות לסנכרון של Intent
QUERY שגיאות הקשורות לכוונות
EXECUTE שגיאות ב-Intent
שגיאות שקשורות להתראות
שגיאות שקשורות לקישור חשבונות
Local Home SDK HandlerError

סנכרון יומנים

בטבלה הבאה מוצגת הסכימה של רשומת syncLog:

מאפיין (property) תיאור
requestId מזהה הבקשה של Intent לבית חכם.
httpLatencyMsec הזמן שעבר עד שהתקבלה תשובה.
status זהו הסטטוס של התגובה ל-Intent.

יומני ביצוע

בטבלה הבאה מוצגת הסכימה של רשומת executionLog:

מאפיין (property) תיאור
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:

מאפיין (property) תיאור
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 בפרויקט, תוכלו לעיין במאמרי העזרה הבאים:

הקודם
Cloud Monitoring
הבא
פתרון בעיות בשילוב שגיאות