מעבר אל Observability Analytics

אם אתם משתמשים ב-trace sinks כדי לייצא נתונים מ-Cloud Trace אל BigQuery, אתם צריכים לעבור אל Observability Analytics. מאגרי נתוני מעקב הוצאו משימוש ויוסרו ב-18 בפברואר 2027 או אחריו. בעזרת Observability Analytics, אתם יכולים לשלוח שאילתות ישירות לנתוני המעקב באמצעות אותה שפת שאילתות SQL כמו ב-BigQuery, בלי לנהל את יעדי הייצוא.

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

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

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

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API, if it is not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Observability API, if it is not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

1. כדי לקבל את ההרשאות שדרושות לטעינת הדף Observability Analytics, להפעלת שאילתות וליצירת מערך נתונים מקושר של BigQuery, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים בפרויקט:

   • אדמין ב-Cloud Trace (roles/cloudtrace.admin)
   • עורך יכולת הצפייה (roles/observability.editor)
   • BigQuery User (roles/bigquery.user)

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

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

2. במסוף Google Cloud , מפעילים את Cloud Shell.

   הפעלת Cloud Shell

   בחלק התחתון של Google Cloud המסוף יתחיל סשן של Cloud Shell ותופיע הודעה של שורת הפקודה. Cloud Shell היא סביבת מעטפת שבה ה-CLI של Google Cloud מותקן ומוגדרים ערכים לפרויקט הקיים. הסשן יופעל תוך כמה שניות.

מעבר אל Observability Analytics

1. צריך לבצע את הפעולות שמפורטות בקטע לפני שמתחילים במסמך הזה. הפעולות האלה כוללות הפעלה של Observability API.

2. כדי לוודא שיש לכם גישה לנתוני המעקב, אתם יכולים להשתמש ב-Observability Analytics:

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

      עוברים אל Observability Analytics

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

   2. בתפריט תצוגות, עוברים לקטע מעקב ובוחרים באפשרות _Trace.Spans._AllSpans.

      החלונית Schema מתעדכנת ומציגה את הסכימה.

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

   3. בחלונית סכימה, בוחרים באפשרות שאילתה.

      השדה של עורך השאילתות מתעדכן. הסעיף FROM מציג רשומה שדומה לרשומה הבאה:

      `PROJECT_ID.us._Trace.Spans._AllSpans`
      

   4. בסרגל הכלים, לוחצים על Run Query (הפעלת שאילתה).

      אם בסרגל הכלים מוצגת האפשרות הפעלה ב-BigQuery, לוחצים על הגדרות ובוחרים באפשרות Analytics (ברירת מחדל).

   בדקתם שאתם יכולים לשלוח שאילתות לנתוני העקבות באמצעות הדף Observability Analytics.

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

4. מוחקים מאגרי נתונים של עקבות ומערכי נתונים מיותרים:

   1. כדי להציג רשימה של יעד קיים של נתוני מעקב, מריצים את הפקודה gcloud alpha trace sinks list:

      gcloud alpha trace sinks list
      

   2. לכל יעד, מריצים את הפקודה gcloud alpha trace sinks delete:

      gcloud alpha trace sinks delete SINK_NAME
      

   3. אופציונלי: מוחקים מערכי נתונים מיותרים ב-BigQuery. מידע על מחיקת מערך נתונים ב-BigQuery זמין במאמר מחיקת מערכי נתונים.

השוואת סכימות

בקטע הזה מוסבר על ההבדלים בין סכימות של Observability Analytics לבין סכימות של ייצוא מבוסס-יעד.

שם	Analytics	מדור קודם
מזהה מעקב	trace_id	extendedFields.traceId
מזהה יחידה לוגית למעקב	span_id	span.spanId
מזהה יחידה לוגית למעקב הורה	parent_span_id	span.parentSpanId
שם ה-Span	name	span.displayName.value
סוג הטווח	kind לערכים, אפשר לעיין ב-OpenTelemetry: SpanKind.	span.spanKind הערכים מופיעים בדף SpanKind מאמרי העזרה של ה-API של Cloud Trace.
שעת ההתחלה של הטווח	start_time	span.startTime
שעת הסיום של טווח הזמן	end_time	span.endTime
מאפיינים	לכל אחד מהמאפיינים span,‏ resource ו-instrumentation יש פורמט ייחודי. השדות האלה הם מסוג JSON data type ב-BigQuery. דוגמאות: attributes["somekey"] resource.attributes["somekey"] instrumentation_scope.attributes["somekey"]	כל המאפיינים משתמשים באותו פורמט: span.attributes.attributeMap.ATTRIBUTE_KEY דוגמאות: span.attributes.attributeMap._http_method span.attributes.attributeMap.g_co_agent span.attributes.attributeMap.rpc_service span.attributes.attributeMap.rpc_method

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

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