רכיבים מוליכים וטווחים

במסמך הזה מוסבר על עקבות ועל טווחי זמן. Trace מייצג פעולה אחת מקצה לקצה. ‫Traces מורכבים מspans, שהם רשומות של פונקציה או פעולה יחידה.

מודל נתונים של מעקב

למעקב יש את המאפיינים הבאים:

  • ‫Trace ID: המזהה הייחודי של הפעולה מקצה לקצה. צריך להעביר את מזהה המעקב כהקשר כחלק מהפעולה מקצה לקצה.

  • אוסף של טווחים עם אותו ערך של מזהה המעקב.

    ‫Cloud Trace משתמש במזהה המעקב כדי לזהות אילו טווחי זמן במאגר שלו משויכים לאותו מעקב.

מודל נתונים של Span

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

  • מזהה מעקב: המזהה של הפעולה מקצה לקצה שבה התרחשה הפעולה הכוללת הספציפית הזו.
  • ‫Span ID: המזהה הייחודי של הטווח. אם אותה פעולה מופעלת כמה פעמים במהלך ביצוע של פעולה כוללת אחת, יכול להיות שיהיו כמה טווחי זמן עם אותו שם בנתוני המעקב. עם זאת, לכל יחידה לוגית למעקב יש מזהה טווח נפרד.
  • מזהה יחידה לוגית למעקב של ההורה: מזהה את הפעולה שהפעילה את היחידה הלוגית למעקב הזו. בטווח 'root' מזהה טווח ההורה מוגדר כ-null.
  • שם: שם הפעולה שבוצעה.
  • שעת ההתחלה: שעת ההתחלה של הפעולה.
  • שעת סיום: שעת הסיום של הפעולה.

טווחים יכולים להכיל גם מאפיינים, שבהם מאוחסן מידע נוסף על פעולה באמצעות צמדי מפתח/ערך. מומלץ להשתמש ב-Cloud Trace במוסכמות סמנטיות של OpenTelemetry כשאפשר.

משאבים

מקורות מידע על OpenTelemetry:

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