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

בדף Trace Explorer אפשר לראות ייצוג מצטבר של נתוני העקבות, לסנן את נתוני העקבות ולעיין בעקבות ספציפיים. כברירת מחדל, 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.