קישור רשומות ביומן למעקב

במסמך הזה מוסבר איך לקשר בין רשומה ביומן לבין מעקב. כדי לבצע את הקישור, מגדירים שדה ברשומה ביומן. בעזרת שדות המעקב במבנה LogEntry – spanId, trace ו-traceSampled – אפשר ליצור קורלציה בין יומנים לבין מעקבים כדי לשפר את פתרון הבעיות המבוזר.

שיוך ידני של רשומה ביומן ל-trace או ל-span

אם אתם משתמשים ב-Cloud Logging API כדי לכתוב נתוני יומנים, או אם אתם כותבים נתוני יומנים מובנים, אתם יכולים לשייך רשומה ביומן למעקב או לטווח. ברשומה ביומן יכול להיות שיהיה גם תיעוד של דגימת העקבות. במאמר שדות מיוחדים במטענים מובְנים מוסבר איך סוכן תפעול ממיר נתוני יומן מובְנים לשדות ב-LogEntry.

כדי לשייך רשומה ביומן למעקב, מגדירים את השדה trace באובייקט LogEntry:

  • הפורמט המועדף: TRACE_ID
  • פורמט מדור קודם: projects/PROJECT_ID/traces/TRACE_ID

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

כדי לשייך רשומה ביומן ליחידה לוגית למעקב כשמשתמשים ב-Cloud Logging API, צריך להגדיר את השדה spanId באובייקט LogEntry לקידוד ההקסדצימלי בן 16 התווים של מזהה היחידה הלוגית למעקב. לדוגמה, כדי לשייך רשומה ביומן ליחידה לוגית למעקב עם מזהה 74, צריך להגדיר את מזהה היחידה הלוגית למעקב ל-000000000000004a.

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

שיוך אוטומטי של רשומה ביומן למעקב או לטווח

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

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

לחלופין, במקרים מסוימים, אם יש בקשת HTTP, אפשר להגדיר את שדות המעקב מהשדה W3C traceparent או מהערך X-Cloud-Trace-Context בבקשת ה-HTTP.

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

צפייה ביומנים

אפשר לראות את רשומת היומן של מעקב לצד תרשים ה-Waterfall או ב-Logs Explorer. כשמשתמשים בכלי Logs Explorer, הוא מוגבל אוטומטית לטווח חותמות הזמן של ה-trace. אם אין רשומות ביומן להצגה, בכלי Logs Explorer מוצגת ההודעה No entries found matching current filter.

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

  • כדי להציג את הרשומות של יומן המעקב לצד תרשים ה-Waterfall, עוברים לתרשים ה-Waterfall ולוחצים על Show logs (הצגת יומנים). אם האפשרות הצגת יומנים לא מוצגת, אין רשומות יומן זמינות.

  • כדי לראות את רשומת היומן ב-Logs Explorer, לוחצים על הצגה לצד התווית יומן בקטע פרטים. שימו לב: אם יש לכם מעקב Cloud Load Balancing, לוחצים על View לצד התווית VM Log.

מידע נוסף על הצגת רשומות ביומן ב-Cloud Logging זמין במאמר שימוש ב-Logs Explorer.

הרשאות צפייה ביומן

כדי לראות רשומות ביומן, צריכה להיות לכם הרשאה logging.logEntries.list בפרויקט. ההרשאה הזו ניתנת על ידי התפקידים צפייה ביומנים וצפייה בפרויקט במערכת לניהול הזהויות והרשאות הגישה (IAM).

כדי לראות את יומני הרישום של מכונת ה-VM, צריכה להיות לכם ההרשאה compute.instances.get בפרויקט. ההרשאה הזו ניתנת על ידי תפקידי ה-IAM‏ Compute Engine Network Viewer ו-Project Viewer.