הצלבת רשומות ביומן

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

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

הגדרת רשומות יומן שקשורות זו לזו

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

  • סביבה רגילה של App Engine

  • פונקציות Cloud Run ו-Cloud Run

מידע על הטמעת כלי מעקב באפליקציה כדי לאסוף נתוני מעקב זמין במאמר סקירה כללית על הטמעה של Cloud Trace.

כדי ש-Logs Explorer יוכל ליצור קורלציה בין אוסף של רשומות ביומן, הרשומות צריכות לעמוד בדרישות הבאות:

  • השדה trace באובייקט LogEntry מוגדר כמחרוזת בפורמט הבא:

       projects/PROJECT_ID/traces/TRACE_ID

    כאשר PROJECT_ID הוא מזהה הפרויקט שלכם ב- Google Cloud Project ו-TRACE_ID הוא מזהה העקבות.

  • השדות trace ברשומות ביומן זהים.

  • כל רשומה ביומן שייכת ליומן ייחודי. כלומר, הערך של השדות logName חייב להיות שונה.

צפייה ברשומות יומן שקשורות זו לזו ב-Logs Explorer

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

לדוגמה, כדי להציג את הרשומה ביומן הבקשות של App Engine ואת הרשומות ביומן האפליקציה:

  1. במסוף Google Cloud , נכנסים לדף Logs Explorer:

    כניסה אל Logs Explorer

    אם משתמשים בסרגל החיפוש כדי למצוא את הדף הזה, בוחרים בתוצאה שכותרת המשנה שלה היא Logging.

  2. בתפריט הנפתח Resource, בוחרים באפשרות GAE Application.

  3. בתפריט הנפתח שם היומן, בוחרים באפשרות request_log.

  4. בחלונית Query results, כדי להרחיב רשומה ביומן, לוחצים על Expand.

    רשומות ביומן האפליקציה שקשורות לרשומה ביומן הבקשות מוצגות כרשומות משנה בתוך הרשומה ביומן הבקשות:

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

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

חיפוש רשומות יומן שקשורות זו לזו

חיפוש מתואם מאפשר לכם לחפש שאילתה גם ברשומות של יומן ההורים וגם ברשומות של יומן הילדים. תוצאת החיפוש היא רשימה של רשומות ביומן ההורה שתואמות לשאילתה ברשומות ביומן ההורה או ברשומות ביומן הצאצא. לדוגמה, כדי לחפש את המחרוזת app log message (הודעה ביומן האפליקציה) ברשומות היומן של הצאצא ושל האב, מבצעים את הפעולות הבאות:

  1. במסוף Google Cloud , נכנסים לדף Logs Explorer:

    כניסה אל Logs Explorer

    אם משתמשים בסרגל החיפוש כדי למצוא את הדף הזה, בוחרים בתוצאה שכותרת המשנה שלה היא Logging.

  2. מזינים "app log message" בשדה החיפוש ולוחצים על Run query (הפעלת שאילתה). רשומות ביומן של ילדים שמכילות את המחרוזת "הודעה ביומן של אפליקציה" מוצגות בחלונית Query results.

  3. בחלונית Query results (תוצאות של שאילתות), לוחצים על Correlate by (הצלבת נתונים לפי) ובוחרים יומן אב. כדי לראות את יומני הבקשות של App Engine, בוחרים באפשרות request_log ולוחצים על החלה.

  4. בחלונית Query results מוצגים כל רשומות היומן הראשיות שמכילות את המחרוזת "app log message" או שיש להן רשומת צאצא שמכילה את המחרוזת.

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

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

    בצילום המסך הקודם, רשומת היומן של ההורה כוללת 10 רשומות יומן של הילד שמכילות את המחרוזת app log message. אפשר להרחיב את רשומות היומן של הילדים כדי לראות את הפרטים שלהן.

    אם בחרתם ביומן אב ולא מוצגים רשומות ביומן בחלונית Query results, סימן שאין רשומות אב וצאצא שמתאימות לשאילתה שלכם.

המאמרים הבאים