הצגת רשימה של קטגוריות של נתוני מעקב וניהול של מערכי נתונים

אתם יכולים להשתמש ב-Observability API או ב-Google Cloud CLI כדי לראות את קטגוריות התצפית, לבדוק קבוצות נתונים ותצוגות וליצור קישורים לניתוח נתוני המעקב ששמורים באמצעות SQL. אפשר גם להשתמש ב-Terraform כדי ליצור קישורים.

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

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

מגדירים את הפרויקט ואת התפקידים בניהול הזהויות והרשאות הגישה (IAM), ובוחרים את הממשק שבו רוצים להשתמש.

הגדרת הפרויקט והתפקידים

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

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.

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 (roles/observability.viewer) ב-IAM בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

בוחרים את הממשק שבו רוצים להשתמש

הצגת רשימה של קטגוריות של ניראות

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

gcloud observability buckets list \
 --location=LOCATION --project=PROJECT_ID

gcloud observability buckets list `
 --location=LOCATION --project=PROJECT_ID

gcloud observability buckets list ^
 --location=LOCATION --project=PROJECT_ID

---
createTime: '2026-01-21T21:39:22.381083860Z'
description: Bucket for storing spans from Cloud Trace.
name: projects/my-project/locations/us/buckets/_Trace

projects/PROJECT_ID/locations/LOCATION

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID

{
  "buckets": [
    {
      "name": "projects/my-project/locations/us/buckets/_Trace",
      "description": "Trace Bucket",
      "createTime": "2025-01-01T15:42:30.988919645Z",
      "updateTime": "2025-02-04T15:42:30.988919645Z",
      "retentionDays": 30
    }
  ]
}

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

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

gcloud observability buckets datasets list \
 --bucket=projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID \
 --location=LOCATION \
 --project=PROJECT_ID

gcloud observability buckets datasets list `
 --bucket=projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID `
 --location=LOCATION `
 --project=PROJECT_ID

gcloud observability buckets datasets list ^
 --bucket=projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID ^
 --location=LOCATION ^
 --project=PROJECT_ID

---
createTime: '2026-01-21T21:39:22.381083860Z'
description: Dataset for storing spans from Cloud Trace.
name: projects/my-project/locations/us/buckets/_Trace/datasets/Spans

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID

{
  "datasets": [
    {
      "name": "projects/my-project/locations/us/buckets/_Trace/datasets/Spans",
      "description": "Trace Spans",
      "createTime": "2025-01-01T15:42:30.988919645Z",
      "updateTime": "2025-02-04T15:42:30.988919645Z",
    }
  ]
}

הצגת רשימת התצוגות במערך נתונים

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

gcloud observability buckets datasets views list \
 --dataset=projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID \
 --bucket=BUCKET_ID \
 --location=LOCATION \
 --project=PROJECT_ID

gcloud observability buckets datasets views list `
 --dataset=projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID `
 --bucket=BUCKET_ID `
 --location=LOCATION `
 --project=PROJECT_ID

gcloud observability buckets datasets views list ^
 --dataset=projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID ^
 --bucket=BUCKET_ID ^
 --location=LOCATION ^
 --project=PROJECT_ID

---
createTime: '2026-01-21T21:39:22.381083860Z'
displayName: _AllSpans
name: projects/pamstestproject1/locations/us/buckets/_Trace/datasets/Spans/views/_AllSpans
updateTime: '2026-01-21T21:39:22.381083860Z'

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/views

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/views/OBS_VIEW_ID

{
  "views": [
    {
      "name": "projects/my-project/locations/us/buckets/_Trace/datasets/Spans/views/_AllSpans",
      "filter": "",
      "createTime": "2025-01-01T15:42:30.988919645Z",
      "updateTime": "2025-02-04T15:42:30.988919645Z",
    }
  ]
}

הצגת רשימת הקישורים בקבוצת נתונים

בקטע הזה מוסבר איך להציג את הקישורים במערכי הנתונים של ניראות הנתונים. קישור יכול לאפשר לכם לשלוח שאילתות לנתונים באמצעות שירותי BigQuery, או לאפשר לשירות Google Cloud לשלוח שאילתות לקבוצת משנה של הנתונים האלה.

gcloud observability buckets datasets links list \
 --dataset=projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID\
 --bucket=BUCKET_ID \
 --location=LOCATION \
 --project=PROJECT_ID

gcloud observability buckets datasets links list `
 --dataset=projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID`
 --bucket=BUCKET_ID `
 --location=LOCATION `
 --project=PROJECT_ID

gcloud observability buckets datasets links list ^
 --dataset=projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID^
 --bucket=BUCKET_ID ^
 --location=LOCATION ^
 --project=PROJECT_ID

---
createTime: '2026-04-02T21:23:09.272323714Z'
name: projects/my-project/locations/us/buckets/_Trace/datasets/Spans/links/mydataset

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/links/LINK_ID

{
  "links": [
    {
      "name": "projects/my-project/locations/us/buckets/_Trace/datasets/Spans/links/my_link",
      "description": "My link for traces to BigQuery",
      "createTime": "2025-01-12T15:42:30.988919645Z"
    }
  ]
}

יצירת קישור במערך נתונים

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

כשיוצרים קישור במערך נתונים של ניראות, קורים הדברים הבאים:

• יכול להיות ש-Google Cloud Observability ייצור את חשבונות השירות הבאים או ישנה את הקצאות התפקידים שלהם ב-IAM:

  • חשבון שירות למעקב: נדרש כדי ליצור קישור למערך נתונים מקושר ב-BigQuery. כדי ש-Google Cloud Observability ייצור את חשבון השירות הזה, צריך להפעיל את Cloud Monitoring API.

  • חשבון שירות של Cloud Observability: נדרש כדי ליצור קישור במערך נתונים של ניראות (observability).

  • חשבון שירות של Cloud Logging: נדרש כדי ליצור קישור בקטגוריית יומנים.

• ביומני הביקורת מתועדות הבקשה ליצירת קישור והבקשה ממנהל סוכני השירות להקצות לחשבון השירות של Monitoring את התפקיד סוכן שירות של Monitoring ב-IAM. ביומנים האלה מתועד גם הסיום של הפעולה הממושכת.

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

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

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Monitoring and Observability APIs, if any are 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 APIs

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

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Monitoring and Observability APIs, if any are 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 APIs

1. כדי לקבל את ההרשאות שנדרשות ליצירת קישור במערך נתונים של ניראות, בקשו מהאדמין להקצות לכם את התפקיד עריכת ניראות (roles/observability.editor) ב-IAM בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

יצירת מערך נתונים מקושר ב-BigQuery

gcloud observability buckets datasets links create \
  projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/links/LINK_ID \
 --dataset=DATASET_ID\
 --bucket=BUCKET_ID \
 --location=LOCATION \
 --project=PROJECT_ID

gcloud observability buckets datasets links create `
  projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/links/LINK_ID `
 --dataset=DATASET_ID`
 --bucket=BUCKET_ID `
 --location=LOCATION `
 --project=PROJECT_ID

gcloud observability buckets datasets links create ^
  projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID/links/LINK_ID ^
 --dataset=DATASET_ID^
 --bucket=BUCKET_ID ^
 --location=LOCATION ^
 --project=PROJECT_ID

Create request issued for: [mydataset]
Waiting for operation [projects/my-project/locations/us/operations/operation-1775164903749-64e80c9817833-9ff804b6-c3e9cbe7] to complete...done.
Created link [mydataset].

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID/datasets/DATASET_ID

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

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

• חיפוש ועיון בנתוני מעקב

• שליחת שאילתות וניתוח של נתוני מעקב באמצעות SQL

• הגדרת ברירות מחדל לקטגוריות של ניראות: הגדרת מיקום אחסון שמוגדר כברירת מחדל ומפתח הצפנה בניהול הלקוח (CMEK) שמוגדר כברירת מחדל לקטגוריות של ניראות.