יצירה, שאילתה וניהול של תצוגות ניתוח

תצוגה מקדימה

השימוש במוצר או בתכונה כפוף לתנאי השימוש במוצרים בגרסת טרום-GA, בחלק "תנאים כלליים לשירות" של התנאים הספציפיים לשירות. השימוש בתכונות ובמוצרים בגרסת טרום-GA הוא "כפי שהם" (As is), ויכול להיות שהתמיכה בהם תהיה מוגבלת. מידע נוסף זמין בקטע תיאור שלבי ההשקה.

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

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

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

נכנסים לחשבון 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.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. 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.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

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

   • ‫Observability View Accessor (roles/observability.viewAccessor) בתצוגות הניראות שרוצים לשלוח אליהן שאילתות. התפקיד הזה תומך בתנאי IAM, שמאפשרים להגביל את ההרשאה לתצוגה ספציפית. אם לא מצרפים תנאי להענקת התפקיד, לחשבון המשתמש תהיה גישה לכל תצוגות הנתונים של יכולת התצפית. תצוגות ה-Observability זמינות ב-Public Preview.
   • Observability Analytics User (roles/observability.analyticsUser) on your project. התפקיד הזה כולל את ההרשאות שנדרשות לשמירה ולהרצה של שאילתות פרטיות, ולהרצה של שאילתות משותפות.
   • מציג היומנים (roles/logging.viewer) בפרויקט.

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

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

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

יצירת תצוגת ניתוח

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

כדי ליצור תצוגת ניתוח:

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

   עוברים אל Observability Analytics

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

2. מגדירים את הדף Observability Analytics:
   1. מוודאים שבסרגל הכלים מוצגת האפשרות Run query (הפעלת שאילתה). אם בסרגל הכלים מוצגת האפשרות Run in BigQuery, לוחצים על Settings ובוחרים באפשרות Observability Analytics (default).
   2. אם התפריט תצוגות לא מוצג, עוברים לחלונית הניווט ולוחצים על תצוגות וסכימה.

3. מזינים ומאמתים את השאילתה שרוצים לשמור כתצוגת ניתוח נתונים.

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

   1. בתפריט Views, עוברים לקטע Traces ובוחרים באפשרות _Trace.Spans._AllSpans.

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

      חלונית Query מתעדכנת עם שאילתת SQL.

   3. מעדכנים את השאילתה עד שמרוצים מתוצאות השאילתה.

4. יוצרים תצוגת ניתוח:

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

   2. מזינים שם ותיאור לתצוגה המפורטת של הניתוח.

      השם מוגבל ל-100 תווים ויכול לכלול רק אותיות, ספרות, קווים תחתונים ומקפים. אי אפשר לשנות את השם אחרי שיוצרים את תצוגת הניתוח.

   3. לוחצים על Save.

   המערכת יוצרת את התצוגה המפורטת של Analytics ומציגה אותה בחלונית Views, בקטע Analytics Views של data_table.

שליחת שאילתה לתצוגת ניתוח נתונים

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

FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`

השדות בביטויים הקודמים מייצגים את המשמעויות הבאות:

• ‫PROJECT_ID: מזהה הפרויקט.
• ‫LOCATION: המיקום של התצוגה המפורטת ב-Analytics.
• ‫ANALYTICS_VIEW_ID: המזהה של תצוגת הניתוח, שמוגבל ל-100 תווים ויכול לכלול רק אותיות, ספרות, קווים תחתונים ומקפים.

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

הצגת תצוגות מפורטות ב-Analytics

כדי להציג את תצוגות הניתוח ב Google Cloud פרויקט:

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

   עוברים אל Observability Analytics

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

2. מגדירים את הדף Observability Analytics:
   1. מוודאים שבסרגל הכלים מוצגת האפשרות Run query (הפעלת שאילתה). אם בסרגל הכלים מוצגת האפשרות Run in BigQuery, לוחצים על Settings ובוחרים באפשרות Observability Analytics (default).
   2. אם התפריט תצוגות לא מוצג, עוברים לחלונית הניווט ולוחצים על תצוגות וסכימה.

3. בתפריט תצוגות מפורטות, עוברים לקטע תצוגות מפורטות של Analytics data_table.

קבלת פרטים על תצוגות מפורטות של נתוני Analytics

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

• שם.
• תאריך יצירה.
• עדכון אחרון.
• סכימה.
• שאילתה.

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

1. בוחרים את תצוגת הניתוח שרוצים לראות את המידע שלה.
2. בסרגל הכלים Schema לוחצים על View analytics view options ובוחרים באפשרות View details.

שינוי תצוגת ניתוח נתונים

כדי לשנות תצוגת ניתוח נתונים:

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

   עוברים אל Observability Analytics

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

2. מגדירים את הדף Observability Analytics:
   1. מוודאים שבסרגל הכלים מוצגת האפשרות Run query (הפעלת שאילתה). אם בסרגל הכלים מוצגת האפשרות Run in BigQuery, לוחצים על Settings ובוחרים באפשרות Observability Analytics (default).
   2. אם התפריט תצוגות לא מוצג, עוברים לחלונית הניווט ולוחצים על תצוגות וסכימה.

3. בתפריט Views, עוברים לקטע Analytics Views של data_table ובוחרים את תצוגת הנתונים ב-Analytics שרוצים לשנות.

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

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

5. אחרי שמסיימים לבצע את השינויים, לוחצים על החלפת התצוגה השמורה.

מחיקת תצוגת ניתוח

הערה: אם כתבתם שאילתות על תצוגת נתונים של Analytics ומחקתם את תצוגת הנתונים, השאילתות האלה ייכשלו.

כדי למחוק תצוגת ניתוח נתונים:

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

   עוברים אל Observability Analytics

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

2. מגדירים את הדף Observability Analytics:
   1. מוודאים שבסרגל הכלים מוצגת האפשרות Run query (הפעלת שאילתה). אם בסרגל הכלים מוצגת האפשרות Run in BigQuery, לוחצים על Settings ובוחרים באפשרות Observability Analytics (default).
   2. אם התפריט תצוגות לא מוצג, עוברים לחלונית הניווט ולוחצים על תצוגות וסכימה.

3. בתפריט Views (תצוגות), עוברים לקטע Analytics Views (תצוגות Analytics) data_table ובוחרים את תצוגת Analytics שרוצים למחוק.
4. בסרגל הכלים סכימה, לוחצים על הצגת אפשרויות של תצוגת ניתוח נתונים, בוחרים באפשרות מחיקת תצוגה ומשלימים את הפעולות בתיבת הדו-שיח.

מגבלות

המגבלות הבאות חלות על תצוגות מפורטות של נתונים:

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

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

• שאילתה וניתוח של עקבות.
• יצירת תרשים של תוצאות שאילתת SQL.
• שמירה ושיתוף של שאילתות
• דוגמאות לשאילתות SQL.