הצגת קורלציה בין מדדים לבין עקבות באמצעות נתונים לדוגמה

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

במאמר הזה מוסבר איך להגדיר את OpenTelemetry כדי ליצור דוגמאות של נתוני מעקב ולצרף אותן לנתוני המדדים.

אם יוצרים תרשים של תוצאות שאילתת SQL בלוח בקרה, Google Cloud Observability יכול גם ליצור באופן אוטומטי נתונים לדוגמה. מידע נוסף זמין במאמר בנושא יצירה והצגה של דוגמאות למעקב.

מידע על דוגמאות

נתוני דוגמאות הם דרך לשייך נתונים שרירותיים לנתוני מדדים. אפשר להשתמש בהם כדי לצרף נתונים שאינם מדדים למדידות. אחד השימושים בנתוני דוגמה הוא שיוך נתוני מעקב לנתוני מדדים. ב-Cloud Monitoring, אפשר לצרף נתונים לדוגמה לנתוני מדדים עם סוג הערך Distribution. מדדים עם ערכי התפלגות אוספים הרבה מדידות ומקבצים אותן לדליים. כל 'נקודה' היא היסטוגרמה, שהיא מערך שמפרט את ספירת הדליים. המדידות בפועל לא נשמרות, רק ספירת הדליים. מידע נוסף על מדדים עם ערכי פיזור

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

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

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

לדוגמה, בדוגמה של שדרוג ב-Go נעשה שימוש ב-OpenTelemetry כדי לכתוב נתוני מדדים, נתוני מעקב ודוגמאות. בצילום המסך הבא מוצג הערך של המדד prometheus/http_server_duration_milliseconds/histogram אחרי כמה הרצות של האפליקציה:

דוגמה למפת חום שבה מוצגות כמה דוגמאות.

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

כשבוחרים את ההערה, מוצג ה-trace שמקושר לדוגמה:

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

אם המידע שמוצג לא מספיק מפורט, אפשר לבחור באפשרות View in Trace (הצגה ב-Trace), ואז ייפתח הדף Trace Explorer (כלי לבדיקת נתיב בקשה). בדף הזה אפשר לראות את מאפייני העקבות ולגשת לקישורים לרשומות ביומן.

איך מפעילים את התכונה OpenTelemetry exemplars

כפי שאפשר לראות בדוגמה הקודמת, אפשר להגדיר את OpenTelemetry כך שיכתוב דוגמאות שמקשרות את הטווח הנוכחי של מעקב למדידת מדד. עם זאת, כדי לכתוב דוגמאות, צריך לבצע את הפעולות הבאות:

  1. מגדירים את שני ה-SDK של OpenTelemetry: מדדים ומעקב.

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

    לדוגמה, הפונקציה computeSubrequests פועלת לפי ההנחיות הקודמות. הפונקציה subRequestsHistogram.Record מופעלת אחרי tracer.Start ולפני span.End, שמושהית. שימו לב גם שההקשר, ctx, מועבר מ-tracer.Start לפונקציה Record:

    func computeSubrequests(r *http.Request, subRequests int) error {
	// Add custom span representing the work done for the subrequests
	ctx, span := tracer.Start(r.Context(), "subrequests")
	defer span.End()

	// Make specified number of http requests to the /single endpoint.
	for i := 0; i < subRequests; i++ {
		if err := callSingle(ctx); err != nil {
			return err
		}
	}
	// record number of sub-requests made
	subRequestsHistogram.Record(ctx, int64(subRequests))
	return nil
}

    מידע נוסף על הדוגמה הזו זמין במאמר בנושא הוספת מעקבים ומדדים מותאמים אישית לאפליקציה.

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