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

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

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

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

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

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

  3. Enable the Observability API.

    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

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

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

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

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

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

    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 query (הפעלת שאילתה). אם בסרגל הכלים מוצגת האפשרות Run in BigQuery, לוחצים על Settings ובוחרים באפשרות Observability Analytics (default).
    2. אם התפריט תצוגות לא מוצג, עוברים לחלונית הניווט ולוחצים על תצוגות וסכימה.

  3. בתפריט תצוגות מפורטות, עוברים לקטע תצוגות מפורטות של 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 של ובוחרים את תצוגת ניתוח הנתונים שרוצים לשנות.

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

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

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

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

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

  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 (תצוגות ניתוח נתונים) ובוחרים את תצוגת ניתוח הנתונים שרוצים למחוק.
  4. בסרגל הכלים סכימה, לוחצים על הצגת אפשרויות של תצוגת ניתוח נתונים, בוחרים באפשרות מחיקת תצוגה ומשלימים את הפעולות בתיבת הדו-שיח.

מגבלות

המגבלות הבאות חלות על תצוגות ניתוח:

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

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