סינון יומנים ויצירת מדדים מבוססי-יומנים

אחרי שמייצאים את נתוני Crashlytics ונתוני הסשנים של Firebase (אופציונלי) אל Cloud Logging, אפשר לסנן את היומנים וליצור מדדים מבוססי-יומנים. שתי האפשרויות האלה שימושיות לצפייה בנתונים ספציפיים, לשימוש בהם ולניתוח שלהם.

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

סינון היומנים באמצעות שאילתות

סינון היומנים עוזר לראות נתונים ספציפיים, וגם להפחית את עלויות מאגר הנתונים וניתוח נוסף. אפשר לסנן יומנים באמצעות LQL (שפת שאילתות ביומן).

במאמרים שאילתות לדוגמה באמצעות Logs Explorer ויצירת שאילתות ביומן מוסבר איך לסנן את היומנים באמצעות שאילתות. בטבלה הבאה מתוארים השדות שזמינים לשאילתות האלה.

מסננים לדוגמה

לגבי Crashlytics, הנה כמה דוגמאות למסננים ראשוניים לשאילתה:

  • כדי למצוא את כל הקריסות החמורות בגרסה ספציפית של האפליקציה:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"
    jsonPayload.issue.errorType="FATAL"
    jsonPayload.version.displayVersion="3.2.0"
  • זיהוי קריסות שמתרחשות בדגם מכשיר ספציפי (לדוגמה, Pixel 6a):

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"
    jsonPayload.device.model="Pixel 6a"
  • חיפוש של OutOfMemoryError ספציפי בכל האירועים החמורים:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"
    jsonPayload.issue.errorType="FATAL"
    jsonPayload.issue.subtitle="java.lang.OutOfMemoryError"
  • חיפוש אירועים לפי מזהה בעיה ספציפי ב-Crashlytics:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"
    jsonPayload.issue.id="ISSUE_ID"

סכימת היומן

לכל רשומה ביומן יש מבנה מוגדר מראש ושדות שאפשר לשלוח אליהם שאילתות (ראו LogEntry).

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

יצירת מדדים מבוססי-יומנים

אתם יכולים להציג וליצור מדדים מבוססי-יומנים, ואז להשתמש במדדים האלה ב-Cloud Monitoring כדי ליצור תרשימים, לוחות בקרה בהתאמה אישית והתראות בהתאמה אישית.

  • להשתמש במדדי מערכת מוגדרים מראש שמתועדים באופן אוטומטי, כמו מספר אירועי הרישום ביומן שהתרחשו בפרק זמן מסוים.

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

  • אפשר להשתמש בCloud Monitoring כדי לתעד את מספר הרשומות ביומן שמכילות הודעות מסוימות, או כדי לחלץ מידע על זמן האחזור שדווח ברשומות ביומן. אחר כך תוכלו להשתמש במדדים האלה בתרשימים ובהתראות בהתאמה אישית.

דוגמאות למדדים מבוססי-יומנים

הנה שתי דוגמאות למדדים מבוססי-יומנים שמוגדרים על ידי המשתמש, שאפשר ליצור מנתוני הסשנים של Crashlytics ו-Firebase שיוצאו:

  • באמצעות הנתונים של Crashlytics:
    יוצרים מדד בשם firebase/crashlytics_events עם התווית errorType, ומגדירים אותו כך:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fevents"

  • שימוש בנתוני סשנים של Firebase:
    יוצרים מדד בשם firebase/session_events עם התווית eventType, ומגדירים אותו כך:

    logName="projects/PROJECT_ID/logs/firebasecrashlytics.googleapis.com%2Fsession_events"

מה השלב הבא?