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

תצוגות Analytics ב-Observability Analytics מאפשרות לכם להגדיר שאילתת SQL עם סכימה מותאמת אישית על נתוני Cloud Trace, כדי שתוכלו לפשט ולעשות שימוש חוזר בהמרות מורכבות. אחרי שיוצרים תצוגת ניתוח נתונים, אפשר להריץ שאילתות על התוצאות שלה באמצעות פסוקית FROM בשאילתות SQL אחרות, בדיוק כמו שמריצים שאילתות על תצוגות של נתוני תצפית.

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

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

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

  2. 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.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. 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

  5. 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.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. 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

    8.

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

    • Observability View Accessor (roles/observability.viewAccessor) on the observability views that you want to query. התפקיד הזה תומך בתנאי IAM, שמאפשרים להגביל את ההרשאה לתצוגה ספציפית. אם לא מצרפים תנאי למתן התפקיד, לחשבון המשתמש תהיה גישה לכל תצוגות הנתונים של יכולת התצפית.
    • משתמש עם הרשאת ניתוח נתוני יכולת צפייה (roles/observability.analyticsUser) בפרויקט. התפקיד הזה כולל את ההרשאות שנדרשות לשמירה ולהרצה של שאילתות פרטיות, ולהרצה של שאילתות משותפות.

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

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

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

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

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

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

    עוברים אל Observability Analytics

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

FROM `analytics_view.PROJECT_ID.LOCATION.ANALYTICS_VIEW_ID`

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

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

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

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

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

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

    עוברים אל Observability Analytics

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

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

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

איך מקבלים פרטים על תצוגת ניתוח נתונים

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

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

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

  1. בוחרים את תצוגת הניתוח שרוצים לראות את המידע שלה.
  2. בסרגל הכלים Schema, לוחצים על אפשרויות תצוגת ניתוח נתונים ובוחרים באפשרות הצגת פרטים.

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

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

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

    עוברים אל Observability Analytics

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

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

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

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

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

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

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

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

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

    עוברים אל Observability Analytics

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

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

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

מגבלות

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

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

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