חיפוש ועריכה של עקבות

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

כדי לבצע ניתוח צבירה בהתאמה אישית של טווחי הזמן באמצעות SQL, אפשר להשתמש בדף Observability Analytics או ב-BigQuery. בדף Observability Analytics, אפשר לראות את תוצאות השאילתה כטבלה או כתרשים. מידע על שימוש ב-SQL כדי לשלוח שאילתות לנתוני העקבות זמין במאמר שליחת שאילתות לנתוני עקבות וניתוח שלהם.

מידע על הדף Trace Explorer

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

בצילום המסך הבא אפשר לראות איך מוצגים נתוני המעקב:

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

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

• כדי להציג מעקב ספציפי, משתמשים באפשרות pageview Search for trace (חיפוש מעקב) בסרגל הכלים.

כדי לזהות חריגים ולראות פרטים של טווחי זמן ספציפיים, משתמשים בקטע הטבלאי:

• אפשר למיין את השורות בכרטיסיות Spans ו-Grouped לפי הכותרת Duration.

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

כדי לראות את הפרטים של טווח או קיבוץ, בוחרים את הרשומה משורה בקטע הטבלה. ייפתח חלון קופץ שבו יוצג טווח הזמן בהקשר של המעקב שלו. בתצוגה הזו אפשר לראות את יחידה לוגית למעקב, המאפיינים שלה, האירועים ונתוני היומן. אפשר גם לחפש מילות מפתח בטווחים ובמאפיינים של ה-trace.

הנתונים של העקבות שמוצגים בדף Trace Explorer תלויים בפרמטרים הבאים:

• ההגדרה היקף, שקובעת באילו תצוגות המערכת מחפשת נתוני מעקב. כשהדף נפתח, הרכיב Scope מוגדר לערך ברירת המחדל trace scope והמערכת מריצה שאילתות בתצוגות המפורטות שמופיעות בהיקף הזה כדי לאחזר נתוני מעקב.

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

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

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

• הגדרת טווח הזמן.

• המסננים שהפעלתם.

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

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

לפני שמתחילים

כדי לקבל את ההרשאות שנדרשות להצגת נתוני מעקב באמצעות מסוף Google Cloud ולבחירת היקף המעקב, צריך לבקש מהאדמין להקצות לכם את תפקיד ה-IAM‏ Cloud Trace User (roles/cloudtrace.user) בפרויקט. להסבר על מתן תפקידים, קראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

ההרשאות הנדרשות

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

• כדי לבחור את היקף המעקב: cloudtrace.traceScopes.[get, list]
• כדי לקרוא את היקף ברירת המחדל של המעקב: observability.scopes.get

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

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

צפייה בנתוני מעקב מצטברים

כדי לראות את המידע המצטבר על נתוני העקבות:

1. נכנסים לדף Trace explorer במסוף Google Cloud :

   כניסה אל Trace explorer

   אפשר גם להשתמש בסרגל החיפוש כדי למצוא את הדף הזה.

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

2. מגדירים את הדף Trace Explorer:

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

   2. אופציונלי: מגדירים באילו תצוגות המערכת תחפש נתוני מעקב באמצעות רכיב Scope:

      • כדי להציג את נתוני המעקב שמאוחסנים בפרויקט, מגדירים את התפריט הראשון של הרכיב Scope לאפשרות Project או לאפשרות _Default. שתי ההגדרות האלה שוות.

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

      הנתונים שמוצגים במערכת תלויים בתפקידי ה-IAM שלכם בתצוגות שחיפשתם. לדוגמה, אם אין לכם את ההרשאות שדרושות כדי לראות נתונים בתצוגה, המערכת לא תציג את הנתונים האלה.

      מידע נוסף מופיע במאמר בנושא יצירה וניהול של היקפי מעקב.

   3. אופציונלי: מעדכנים את טווח הזמן באמצעות בורר טווח הזמן או באמצעות הצבעה כדי להדגיש טווח בציר ה-x.

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

3. עיון במפת החום:

   • משתמשים בצבע כדי לזהות מגמות וחריגות. תא עם הרבה טווחים יהיה בצבע כהה יותר מתא עם מעט טווחים.

   • כדי לראות את הפרטים של התא, מעבירים את העכבר מעל התא. בתיאור כלי מופיעים מספר טווחי הזמן, התאריך והשעה ומרווח הזמן של התא.

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

4. בדיקת אחוזוני זמן האחזור ושיעורי השגיאות:

   • כדי לראות את מגמות ההשהיה, מגדירים בתפריט Chart view את האפשרות Span duration (percentile). בתרשים משך הזמן מוצגים האחוזונים ה-50, ה-90, ה-95 וה-99.

   • כדי לראות את סטטוס התגובה כפונקציה של הזמן, בתפריט Chart view בוחרים באפשרות Span rate. בתרשים מוצג קצב שליחת המרווחים לפרויקט.

5. אפשר להשתמש בטבלאות Spans ו-Grouped כדי לזהות חריגים או כדי לראות מידע סטטיסטי. בטבלה Spans מפורטים טווחי זמן ספציפיים. בטבלה Grouped, הטווחים מקובצים לפי השם שלהם ולפי שם השירות או העומס.

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

     לדוגמה, מיון הטבלה Spans לפי משך מאפשר לכם למצוא טווחי זמן עם זמן אחזור גבוה.

   • כדי לראות נתונים סטטיסטיים כמו זמן תגובה ממוצע, משתמשים בטבלה Grouped (מקובצים).

   • כדי למצוא שירותים ועומסי עבודה שרשומים ב-App Hub, מחפשים בעמודה Service/workload ערכים שכוללים את סמל השירות, , או את סמל עומס העבודה, . הקישור שמצורף לשירות או לעומס עבודה שרשומים ב-App Hub פותח את לוח הבקרה המתאים של Application Monitoring.

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

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

סינון נתוני העקבות

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

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

סינון לפי מזהה מעקב

כשמנסים לפתור בעיה או תקלה, יכול להיות שיש לכם את מזהה העקבות. כדי לעיין בנתוני העקבות, עוברים לסרגל הכלים, לוחצים על pageview Search for trace (תצוגת דף חיפוש נתוני עקבות) ומזינים את מזהה העקבות.

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

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

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

החלת מסננים על טווחים

בחלונית Span filters (מסנני טווח) מופיעים המסננים הנפוצים ביותר. אפשר לבחור כמה ערכים מכל קטגוריית משנה. כשמוסיפים או מסירים מסננים, סרגל המסננים מתעדכן גם הוא.

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

בדרך כלל, מסנני הטווח הבאים זמינים:

• שירות OpenTelemetry: סינון לפי המאפיין service.name.
• ‫Span name: השם של ה-span.
• סטטוס של טווח: סטטוס הבקשה. מידע על הערכים מופיע במסמכי התיעוד של OpenTelemetry בנושא SpanStatus.
• משך זמן: משך הזמן של יחידה לוגית למעקב.
• Span kind: מתאר את הקשרים בין ה-spans. מידע על הערכים זמין במאמרי העזרה בנושא OpenTelemetry SpanKind.
• אפליקציה של מרכז האפליקציות: סינון לפי מאפיין המשאב gcp.apphub.application.id.
• שירות מרכז האפליקציות: סינון לפי gcp.apphub.service.idמאפיין המשאב.
• עומס עבודה של מרכז האפליקציות: סינון לפי מאפיין המשאב gcp.apphub.workload.id.

אם רוצים לסנן לפי מאפיין שלא מופיע בחלונית Span filters, משתמשים בסרגל Filter.

שימוש בסרגל הסינון

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

כדי להוסיף מסנן, לוחצים על הוספת מסנן ואז מבצעים אחת מהפעולות הבאות:

• בוחרים מפתח מוגדר, כמו Span name, ואז בוחרים ערך מהתפריט המשני.

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

  לדוגמה, כדי לסנן לפי מזהה המארח, מגדירים את המפתח ל-host.id. באופן דומה, כדי לסנן לפי קוד סטטוס, מגדירים את המפתח לערך /http/status_code. במקרה כזה, אפשר להגדיר את הערך 200, וכך ליצור את המסנן /http/status_code: 200. כדי שהמסנן יתאים לכל ערך, בוחרים באפשרות כל ערך.

סינון לפי אפליקציה

אפשר לסנן את נתוני העקבות לפי אפליקציה, עומס עבודה או שירות של מרכז האפליקציות, אם הנתונים האלה מכילים את מאפייני המשאבים הבאים:

• gcp.apphub.application.{container,id,location}
• gcp.apphub.{workload,service}.{criticality_type,environment_type,id}

מאפייני המשאבים האלה נוצרים על ידי הוספת מכשור לאפליקציות.

בדף Trace Explorer, משתמשים בתפריטים הבאים של Span filters כדי להגביל את ה-Spans לפי אפליקציה, שירות או עומס עבודה:

• אפליקציית מרכז האפליקציות
• שירות מרכז האפליקציות
• עומס עבודה של מרכז האפליקציות

כדי לפתוח את מרכז הבקרה של ניטור האפליקציות בשביל שירות ועומס עבודה שרשומים ב-App Hub, מבצעים את הפעולות הבאות:

1. עוברים לטבלה Spans או Grouped ומחפשים את השירות או את עומס העבודה. אפשר לחפש את סמל השירות, , את סמל עומס העבודה, , או לסנן את הטבלה.

2. לוחצים על הקישור בעמודה שירות/עומס עבודה.

עיון בנתוני מעקב

כדי לבדוק יחידה לוגית למעקב בהקשר של יומן המעקב שלה, בצע את הפעולות הבאות:

1. פותחים את הדף Trace Explorer ומגדירים אותו. מידע על השלבים האלה זמין במאמר הצגת נתוני מעקב מצטברים.

2. כדי לראות את הפרטים של יחידה לוגית למעקב או של יומן מעקב, מבצעים אחת מהפעולות הבאות:

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

   • עוברים לסרגל הכלים בדף Trace Explorer, לוחצים על pageview Search for trace ומזינים את trace ID.

     התפריט הנפתח Details נפתח ומוצגים בו יומן מעקב ויחידות לוגיות למעקב שלו בפורמט של ציר זמן, ומוצג מידע על היחידה הלוגית למעקב שנבחרה:

     

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

     הרכיבים בציר הזמן הם דינמיים. בוחרים טווח כדי לראות את המאפיינים, הרשומות ביומן והאירועים שלו.

עיון בהיררכיית השיחות

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

• בעמודה Name מוצגים שם ומזהה של יחידה לוגית למעקב או נתוני מעקב. סמל של GenAI, , מציין שטווח כולל אירועים או מאפיינים של AI גנרטיבי.
• בעמודה Service/workload מוצג שם של שירות או עומס עבודה. המערכת מגדירה את הערך הזה באמצעות מאפיין OpenTelemetry‏ service.name. כחלופה, בשירותי App Engine, המערכת מציגה את שם השירות של App Engine.
• הצבע והאורך של סרגל ההשהיה משקפים את הסטטוס ואת משך הזמן של הפקודה.
• עיגול בסרגל זמן האחזור מציין שרשומה ביומן או אירוע משויכים לטווח. כדי לשנות את ההתנהגות הזו, משתמשים בתפריט Logs & events (יומנים ואירועים).

כדי להציג את ההיררכיה של הקריאות כגרף אציקלי מכוון (DAG), בוחרים באפשרות Graph בסרגל הכלים:

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

חיפוש טווחי זמן במעקב

כדי לחפש מילות מפתח בטווחים של הנתונים, משתמשים בשדה חיפוש בנתוני המעקב.

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

לדוגמה, אם מזינים GET, כל התאמה ל-GET שלא תלויה באותיות רישיות בשדות שם, שירות/עומס עבודה ומאפיינים תודגש.

הצגת מאפיינים, רשומות ביומן ואירועים

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

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

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

• יומנים ואירועים: בכרטיסייה הזו מפורטים אירועים ורשומות ביומן שבהם השדות trace_id ו-span_id תואמים לטווח הזמן שנבחר. מוצגים רק רשומות ביומן שיש לכם הרשאה לראות.

  כדי לראות את כל המידע על רשומה בכרטיסייה הזו, לוחצים על עוד אפשרויות.

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

  הערה: אירועים שקשורים ל-AI גנרטיבי מוצגים בכרטיסייה Inputs/Outputs (קלט/פלט). מידע נוסף זמין במאמר בנושא צפייה באירועים של AI גנרטיבי.

• Stacktraces: רשימה של ה-stacktraces הזמינים.

• מטא-נתונים וקישורים: רשימה של מידע כללי, מידע על היקף המכשור וקישורים לסכימה.

  בקטע מטא-נתונים מוצגים פרטים כמו:

  • מזהה הטווח: מזהה הטווח הוא מספר שלם בגודל 64 ביט שאינו 0. פרטים נוספים זמינים במאמר TraceSpan.
  • מזהה של span הורה.
  • מזהה הפרויקט.
  • שעת התחלה ושעת סיום.

  • טבלה שמופיעים בה קישורים לטווחים אחרים. בטבלה הזו מפורטים הנתונים הבאים לגבי כל קישור:

    • צמדי המפתח/ערך של הטווח שמקושר.
    • מזהה המעקב של היחידה הלוגית למעקב שמקושרת. אם בשדה הזה מופיע Current trace, ה-span מקושר ל-span אחר באותו trace.

    מידע על קישורים מופיע בדף ההפניה של Links API.

  בקטעים Instrumentation scope ו-Schema information מוצגים השם והגרסה של ההיקף, ויש בהם קישורים לסכימה. הקטעים האלה מושמטים אם טווח הזמן לא מכיל את המידע הזה.

יכול להיות שבתפריט הנפתח פרטים תופיע גם כרטיסייה עם התווית קלט/פלט. בכרטיסייה הזו מוצגים אירועים שקשורים ל-AI גנרטיבי.

צפייה באירועים שקשורים ל-AI גנרטיבי

כדי לזהות טווחים שמכילים מאפיינים או אירועים שתואמים למוסכמות הסמנטיות של OpenTelemetry GenAI, מחפשים את הסמל GenAI,‏ :

• בכרטיסייה Attributes (מאפיינים) מוצגים מאפיינים שמצורפים לטווח. כדי להציג רק את המאפיינים של AI גנרטיבי, מפעילים את האפשרות רק מאפיינים של AI גנרטיבי.

• בכרטיסייה Inputs/Outputs מוצגים האירועים שתואמים למוסכמות האלה והמאפיינים המשויכים, שמוצגים גם בכרטיסייה Attributes. יש שתי הגדרות נתמכות:

  • הנחיות ותשובות מבוססות-טקסט שמצורפות לטווחים כמאפיינים, שהם צמדי מפתח/ערך שמתארים מאפיין או אירוע. לדוגמה, הערך של המפתח gen_ai.system מזהה את המערכת שמספקת את היכולות של AI גנרטיבי. המפתחות של מאפייני ה-AI הגנרטיבי מתחילים ב-gen_ai.

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

    בצילום המסך הבא אפשר לראות איך Inputs/Outputs מציג אירועים של AI גנרטיבי מבוסס-טקסט שמצורפים ל-spans:

    

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

הצגת שיחות לשרתי MCP מרוחקים

כדי לראות את טווחי הזמן שנוצרו על ידי שרתי MCP, מבצעים אחת מהפעולות הבאות:

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

• מוסיפים מסנן מאפיינים שהמפתח שלו הוא mcp.method.name והערך שלו הוא tools/call.

  המסנן הזה ספציפי למציאת טווחים שהשם שלהם תואם למוסכמות הסמנטיות של OpenTelemetry ל-MCP. השם דומה ל:

  tools/call NAME
  

  בדוגמה הקודמת, NAME מתייחס לנקודת הקצה שהופעלה. לדוגמה, יכול להיות שכתוב משהו כזה: roll_dice.

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

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

• הצגת נתוני מעקב בלוח בקרה בהתאמה אישית
• יצירה וניהול של היקפי מעקב
• שיתוף של עקבות וטווחים
• פתרון בעיות