רישום ביומן Cloud להעברה מענן לענן

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

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

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 שגיאות בכוונה SYNC
שגיאות בכוונה QUERY
שגיאות בכוונה EXECUTE
התראות שגיאות
שגיאות בקישור החשבון
Local Home SDK HandlerError

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

בטבלה הבאה מופיעה הסכימה של רשומה syncLog:

נכס תיאור
requestId מזהה הבקשה של הכוונה לבית חכם.
httpLatencyMsec משך הזמן שחלף עד לקבלת תשובה.
status מציין את הסטטוס של תגובת הכוונה.

יומני ביצוע

בטבלה הבאה מופיעה הסכימה של רשומה executionLog:

נכס תיאור
requestId מזהה בקשה ייחודי, לדוגמה 5325511189174727525.
latencyMsec משך הזמן שחלף עד לקבלת תשובה, לדוגמה, 6000.
executionType פרוטוקול התעבורה שבו נעשה שימוש בבקשה, למשל CLOUD או MATTER, בהתאם לשילוב שלכם.
actionType אינדיקטור אופציונלי של הפעולה שבוצעה על ידי המשתמש, לדוגמה QUERY או EXECUTE. בפעולות EXECUTE, הפקודה שהונפקה ל-fulfillment למאפיינים נתמכים, למשל ONOFF_OFF
trait מאפיין אופציונלי שמשויך לפעולת המשתמש הזו.
deviceTypes רשימה של סוגי המכשירים שהושפעו מהאירוע, לדוגמה LIGHT.
isSuccess אם הבקשה קיבלה תשובה מוצלחת.
fallbackToCloud האם הבקשה הועברה למילוי בענן בעקבות שגיאה במילוי המקומי.
statusType הסטטוס של תגובת הכוונה, למשל SUCCESS,‏ PENDING או OFFLINE. בתשובות מסוג ERROR, המאפיין הזה מכיל את הערך של errorCode שסופק על ידי השירות להשלמה.
externalDebugString הודעה מפורטת אופציונלית לניפוי באגים שמשויכת לפעולה הזו של המשתמש.
locale קוד השפה שמשויך לבקשה.

יומני התראות

בטבלה הבאה מופיעה הסכימה של רשומה notificationLog:

נכס תיאור
requestId מזהה הבקשה להתרעה.
structName השם של מבנה ההתראה, למשל 'ObjectDetection'.
status מציין את הסטטוס של ההתראה.

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

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

אתם יכולים לקבוע את רמת היומן של הפרויקט באמצעות:

  1. ב-Actions on Google Console, עוברים לדף Projects.

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

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

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

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

החרגות ביומן

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

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

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

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

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

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