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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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