ב-Cloud Trace, מעקבים וטווחים יוצרים את מודל הנתונים שמשמש למעקב אחרי הנתיב והחביון של בקשות באפליקציות המבוזרות. מעקב מתעד את הפעולות שמתבצעות בבקשה מקצה לקצה בשירותים שלכם. Trace מורכב מטווחים, שמתעדים את הפעולות האישיות, הקריאות לפונקציות ו-RPC שמתרחשים במהלך הבקשה.
מודל נתונים של מעקב
נתוני מעקב כוללים את הרכיבים הבאים:
Trace ID: המזהה הייחודי של הפעולה מקצה לקצה. מזהה העקבות מועבר בהקשר של הבקשה בין גבולות השירות.
אוסף של span: קבוצה של span עם אותו מזהה עקבות. הטווחים האלה יוצרים עץ או גרף אציקלי מכוון שמייצג את ההיררכיה של בקשה.
Cloud Trace משתמש במזהה המעקב כדי לזהות אילו טווחי זמן במאגר שלו משויכים לאותו מעקב.
מודל נתונים של Span
יחידה לוגית למעקב מייצגת פעולה יחידה שהתרחשה בפרק זמן מסוים. כל span מכיל שדות שמספקים מידע על ה-span ועל סטטוס הפעולה:
המזהים כוללים את השדות הבאים:
- Trace ID: המזהה הייחודי של הבקשה הכוללת או של יומן המעקב שאליהם שייכת היחידה הלוגית למעקב.
- Span ID: המזהה הייחודי של הטווח. אם מפעילים פעולה כמה פעמים בתוך יומן מעקב אחד, כל הפעלה יוצרת יחידה לוגית למעקב נפרדת עם אותו שם אבל עם מזהה יחידה לוגית למעקב ייחודי.
- Parent span ID (מזהה של טווח ההורה): מזהה את פעולת ההורה שהפעילה את הטווח הזה.
בטווח 'root' מוגדר מזהה טווח ההורה כ-
null. - שם: שם הפעולה שבוצעה.
- סוג: סוג הטווח מספק מידע לכלי מעקב, כמו Trace Explorer, על הקשר בין הטווחים. מידע נוסף זמין במאמר בנושא OpenTelemetry SpanKind.
פרטי ההפעלה מופיעים בשדות הבאים:
- סטטוס: הסטטוס של השלמת הפעולה. הערך של השדה הזה הוא
Unset(ברירת מחדל),ErrorאוOk. ערך ברירת המחדל לא מציין שגיאה. - שעת ההתחלה: שעת ההתחלה של הפעולה.
- שעת סיום: שעת הסיום של הפעולה.
- סטטוס: הסטטוס של השלמת הפעולה. הערך של השדה הזה הוא
טווחים יכולים להכיל שדות אחרים, כמו אירועים, מאפיינים וקישורים:
- אירועים מתעדים הודעות מובנות עם חותמת זמן בטווח מסוים.
- מאפיינים מאחסנים מידע נוסף על פעולה באמצעות צמדי מפתח/ערך. כשכותבים מאפיינים, מומלץ לפעול לפי המוסכמות הסמנטיות של OpenTelemetry ככל האפשר.
- קישורים מאפשרים לקשר בין טווח אחד לטווח אחר.
מידע נוסף זמין במאמר בנושא OpenTelemetry: Spans.
משאבים
מקורות מידע על OpenTelemetry: