סקירה כללית על Cloud Trace

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

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

תמיכה בסביבה

אפשר להריץ את Trace ב-Linux בסביבות הבאות:

רכיבים

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

לקוח מעקב

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

ממשק מעקב

כדי להציג ולנתח את נתוני ה-span, אתם יכולים להשתמש בדפים Trace Explorer ו-Observability Analytics במסוףGoogle Cloud :

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

  • ‫Observability Analytics: ממשק לשאילתות SQL. השאילתות יכולות לאחד את נתוני המעקב והיומנים, ואפשר להציג את תוצאות השאילתה כטבלה או כתרשים. אם יוצרים מערך נתונים מקושר ב-BigQuery, אפשר להשתמש ב-BigQuery כדי לנתח את נתוני המעקב. מידע נוסף מופיע במאמר שליחת שאילתות וניתוח של נתוני מעקב.

הגדרות עם מעקב אוטומטי

ההגדרות הבאות מתעדות באופן אוטומטי נתוני מעקב:

  • סביבת ברירת המחדל ב-App Engine

  • פונקציות Cloud Run ו-Cloud Run

    נתוני זמן האחזור של בקשות HTTP נכנסות ויוצאות נשלחים באופן אוטומטי ל-Trace.

הוספת כלים לאפליקציה

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

כדי להוסיף לאפליקציה כלי למדידת ביצועים, מומלץ להשתמש בכלי קוד פתוח שלא תלוי בספק, כמו OpenTelemetry, במקום בממשקי API או בספריות לקוח שספציפיים לספק ולמוצר. למידע נוסף על מסגרות אלה, ראו יכולת תצפית למפתחי אפליקציות ובחירת גישה למדידת ביצועים.

הדוגמאות למדידת ביצועים שאנחנו מספקים משתמשות ב-OpenTelemetry:

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

‫Cloud Trace ואפליקציות מבוססות-סוכנים

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

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

שרתי Google Cloud MCP יכולים ליצור טווחי מעקב. מידע נוסף זמין במאמר בדיקת קריאות ל-MCP באמצעות Trace.

ממשקי API שמטמיעים נתוני מעקב

אתם יכולים לשלוח נתוני מעקב לפרויקט באמצעות Telemetry API או Cloud Trace API. אנחנו ממליצים על Telemetry API מהסיבות הבאות:

  • ה-API תואם לסביבה העסקית של OpenTelemetry בקוד פתוח, והמגבלות שלו בדרך כלל פחות מחמירות מהמגבלות של Cloud Trace API, שהוא API קנייני של Google Cloud .

  • נתוני המעקב מאוחסנים בפורמט שתואם באופן כללי לקובצי ה-proto שמוגדרים על ידי OTLP. יכול להיות שחלק מהשדות יומרו מסוג נתונים ספציפי ל-OpenTelemetry לסוג נתונים של JSON לפני האחסון. למידע על פורמט האחסון, ראו סכימה לנתוני מעקב.

  • כשמייצאים נתוני מעקב באמצעות אוסף, לא צריך להשתמש במכשיר ייצוא ספציפי ל- Google Cloud.

  • חלק מהתכונות, כמו מעקב אחרי אפליקציות, מסתמכות על מידע שזמין רק כששולחים נתוני מעקב ל-Telemetry API.

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

  • שירותיGoogle Cloud לא שולחים נתוני מעקב לפרויקט שלכם.
  • Google Cloud משיב לבקשות שנשלחות לנקודת קצה ל-API של Cloud Trace עם קוד שגיאה.
  • ‫Google Cloud Observability מתעלם מנתוני המעקב שנשלחים לנקודת קצה ל-API של Telemetry הספציפית למעקב. אל תשביתו את Telemetry API, כי הוא יכול לקבל נתוני יומנים, מדדים ומעקב.

אם אתם מנהלים ארגון ורוצים למנוע את השימוש ב-Cloud Trace, אתם יכולים ליצור אילוץ של מדיניות הארגון.

תמיכה ב-VPC Service Controls

שירותיGoogle Cloud והאפליקציות שלכם יכולים לשלוח נתוני מעקב לפרויקט באמצעות Cloud Trace API או Telemetry API. שירותי התצוגה החזותית של Cloud Trace משתמשים ב-Cloud Trace API כדי לאחזר את נתוני המעקב שהם מציגים:

  • ‫Cloud Trace הוא שירות שנתמך ב-VPC Service Controls. השם של שירות Trace הוא cloudtrace.googleapis.com. לפרטים ולמגבלות, ראו מוצרים נתמכים: Cloud Trace.

  • ‫Telemetry API הוא שירות שנתמך ב-VPC Service Controls. השם של השירות הוא telemetry.googleapis.com. פרטים ומגבלות מופיעים במאמר מוצרים נתמכים: Telemetry API.

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

  • ‫Observability API הוא שירות שנתמך ב-VPC Service Controls. השם של השירות הוא observability.googleapis.com. פרטים ומגבלות מופיעים במאמר מוצרים נתמכים: Observability API.

למידע נוסף, קראו את המאמרים הבאים:

‫Cloud Trace ומיקום אחסון הנתונים

אם אתם משתמשים ב-Assured Workloads בגלל דרישות של מיקום אחסון הנתונים או Impact Level 4 (IL4)‎, אל תשתמשו ב-Cloud Trace API כדי לשלוח את טווחי המעקב.

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

שמירת נתוני מעקב

קטגוריה תקופת שמירה
פרקי זמן שמאוחסנים בקטגוריה _Trace 30 ימים

תפקידי IAM

ב-Cloud Trace, הגישה למשאבים מנוהלת באמצעות הממשק לניהול זהויות והרשאות גישה (IAM). רשימה של תפקידי Cloud Trace API ו-Telemetry API מופיעה במאמר בקרת גישה באמצעות IAM.

‫Telemetry API הוא API לצרכנים, ולכן כדי לשלוח אליו נתונים צריך לציין פרויקט לחיוב על מכסות ולתת לחשבון השירות של האפליקציה הרשאה להשתמש במכסה הזו. מידע נוסף זמין במאמר Telemetry API: אימות.

תמחור

למידע על התמחור של Cloud Trace, קראו את הדף התמחור של Google Cloud Observability.

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