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

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

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

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

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

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

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

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

gcloud

הערה: אתם צריכים להשתמש ב-CLI של gcloud בגרסה 586.0.0 ואילך.

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

הפעלת Cloud Shell

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

Terraform

כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של Terraform שבדף הזה, מתקינים ומפעילים את ה-CLI של gcloud, ואז מגדירים את Application Default Credentials באמצעות פרטי הכניסה של המשתמש.

1. התקינו את ה-CLI של Google Cloud.

2. אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

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

   gcloud auth application-default login

   אם אתם משתמשים ב-Cloud Shell, אתם לא צריכים לעשות את זה.

   אם מוחזרת שגיאת אימות ואתם משתמשים בספק זהויות חיצוני (IdP), ודאו ש נכנסתם ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

למידע נוסף, ראו הגדרת ADC לסביבת פיתוח מקומית במאמרי העזרה בנושא אימות Google Cloud .

REST

כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של API בארכיטקטורת REST שבדף הזה, צריך להשתמש בפרטי הכניסה שאתם נותנים ל-CLI של gcloud.

התקינו את ה-CLI של Google Cloud.

אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

מידע נוסף מופיע במאמר אימות לשימוש ב-REST במסמכי האימות של Google Cloud .

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

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

gcloud

הערה: אתם צריכים להשתמש ב-CLI של gcloud בגרסה 586.0.0 ואילך.

לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:

• ‫LOCATION: המיקום של הקטגוריות של נתוני התצפית. כדי להציג רשימה של כל קטגוריות הנתונים של יכולת הצפייה, בלי קשר למיקום, צריך להגדיר את המיקום למקף (-).
• ‫PROJECT_ID: מזהה הפרויקט.

מריצים את הפקודה gcloud observability buckets list:

‫Linux,‏ macOS או Cloud Shell

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

‏Windows (PowerShell)

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

Windows‏ (cmd.exe)

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

Terraform

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

REST

כדי להציג רשימה של קטגוריות של נתונים שניתן לצפייה בהם בפרויקט ובמיקום ספציפי, משתמשים בשיטה projects.locations.buckets.list.

צריך לציין את פרמטר האב, שמופיע בפורמט הבא:

projects/PROJECT_ID/locations/LOCATION

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

• ‫PROJECT_ID: מזהה הפרויקט.
• ‫LOCATION: המיקום של קטגוריית ה-Observability. אם מגדירים את LOCATION למקף (-), מוצגות כל קטגוריות ה-Observability בפרויקט.

התגובה היא מערך של אובייקטים מסוג Bucket. לכל אובייקט, הערך של השדה name הוא בפורמט הבא:

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
    }
  ]
}

אפשר להשתמש ב-Observability API כדי לקבל מידע נוסף על קטגוריית הנתונים שמזהה שלה הוא BUCKET_ID. לדוגמה, אתם יכולים לראות את קבוצות הנתונים בדלי, ואת התצוגות והקישורים בכל קבוצת נתונים. מידע נוסף מופיע במאמרי העזרה של Observability API.

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

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

gcloud

הערה: אתם צריכים להשתמש ב-CLI של gcloud בגרסה 586.0.0 ואילך.

לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:

• ‫BUCKET_ID: המזהה של קטגוריית הנתונים של יכולת התצפית. לדוגמה, המזהה יכול להיות _Trace.
• ‫LOCATION: המיקום של מאגר הנתונים של יכולת התצפית.
• ‫PROJECT_ID: מזהה הפרויקט.

מריצים את הפקודה gcloud observability buckets datasets list:

‫Linux,‏ macOS או Cloud Shell

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

‏Windows (PowerShell)

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

Windows‏ (cmd.exe)

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

Terraform

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

REST

כדי להציג את רשימת מערכי הנתונים של קטגוריית נתונים לצורך ניטור, משתמשים בשיטה projects.locations.buckets.datasets.list.

צריך לציין את פרמטר האב, שמופיע בפורמט הבא:

projects/PROJECT_ID/locations/LOCATION/buckets/BUCKET_ID

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

• ‫PROJECT_ID: מזהה הפרויקט.
• ‫LOCATION: המיקום של קטגוריית ה-Observability.
• ‫BUCKET_ID: המזהה של קטגוריית הנתונים של יכולת התצפית. לדוגמה, המזהה יכול להיות _Trace.

התגובה היא מערך של אובייקטים מסוג Dataset. לכל אובייקט, הערך של השדה name הוא בפורמט הבא:

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",
    }
  ]
}

אתם יכולים להשתמש ב-Observability API כדי לקבל מידע על מערך הנתונים שמזהה שלו הוא DATASET_ID. לדוגמה, אפשר להציג את התצוגות והקישורים בכל מערך נתונים. מידע נוסף מופיע במאמרי העזרה של Observability API.

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

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

gcloud

הערה: אתם צריכים להשתמש ב-CLI של gcloud בגרסה 586.0.0 ואילך.

לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:

• ‫DATASET_ID: מזהה קבוצת הנתונים. נתוני העקבות מאוחסנים במערך נתונים בשם Spans.
• ‫BUCKET_ID: המזהה של קטגוריית הנתונים של יכולת התצפית. לדוגמה, המזהה יכול להיות _Trace.
• ‫LOCATION: המיקום של מאגר הנתונים של יכולת התצפית.
• ‫PROJECT_ID: מזהה הפרויקט.

מריצים את הפקודה gcloud observability buckets datasets views list:

‫Linux,‏ macOS או Cloud Shell

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

‏Windows (PowerShell)

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

Windows‏ (cmd.exe)

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'

Terraform

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

REST

כדי להציג את התצוגות בקבוצת נתונים, משתמשים ב-method‏ projects.locations.buckets.datasets.views.list.

צריך לציין את הפרמטר הראשי, שמופיע בפורמט הבא:

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

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

• ‫PROJECT_ID: המזהה של הפרויקט.
• ‫LOCATION: המיקום של קטגוריית ה-Observability.
• ‫BUCKET_ID: המזהה של קטגוריית הניטור. לדוגמה, המזהה יכול להיות _Trace.
• ‫DATASET_ID: המזהה של מערך הנתונים ששולחים אליו שאילתה. לדוגמה, המזהה יכול להיות Spans.

התגובה היא מערך של אובייקטים מסוג View. לכל אובייקט, הערך של השדה name הוא בפורמט הבא:

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

בביטוי שלמעלה, המזהה של תצוגה מיוצג על ידי OBS_VIEW_ID. לדוגמה, הערך בשדה הזה יכול להיות _AllSpans.

זוהי דוגמה לתגובה:

{
  "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",
    }
  ]
}

מידע נוסף מופיע במאמרי העזרה של Observability API.

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

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

gcloud

הערה: אתם צריכים להשתמש ב-CLI של gcloud בגרסה 586.0.0 ואילך.

לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:

• ‫DATASET_ID: מזהה קבוצת הנתונים. נתוני העקבות מאוחסנים במערך נתונים בשם Spans.
• ‫BUCKET_ID: המזהה של קטגוריית הנתונים של יכולת התצפית. לדוגמה, המזהה יכול להיות _Trace.
• ‫LOCATION: המיקום של מאגר הנתונים של יכולת התצפית.
• ‫PROJECT_ID: מזהה הפרויקט.

מריצים את הפקודה gcloud observability buckets datasets links list:

‫Linux,‏ macOS או Cloud Shell

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

‏Windows (PowerShell)

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

Windows‏ (cmd.exe)

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

Terraform

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

REST

כדי להציג את הקישורים במערך נתונים, משתמשים בשיטה projects.locations.buckets.datasets.links.list.

צריך לציין את פרמטר האב, שמופיע בפורמט הבא:

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

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

• ‫PROJECT_ID: מזהה הפרויקט.
• ‫LOCATION: המיקום של קטגוריית הניראות.
• ‫BUCKET_ID: המזהה של קטגוריית הנתונים של יכולת התצפית. לדוגמה, המזהה הזה יכול להיות _Trace.
• ‫DATASET_ID: המזהה של מערך הנתונים ששולחים אליו שאילתה. לדוגמה, המזהה יכול להיות Spans.

התגובה היא מערך של אובייקטים מסוג Link. לכל אובייקט, הערך של השדה name הוא בפורמט הבא:

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

‫LINK_ID הוא השם של מערך הנתונים ב-BigQuery. השדה הזה חייב להיות ייחודי בפרויקט Google Cloud .

זוהי דוגמה לתשובה:

{
  "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"
    }
  ]
}

מידע נוסף מופיע במאמרי העזרה של Observability API.

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

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

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

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

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

  • חשבון שירות של Cloud 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.

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

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

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

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

gcloud

הערה: אתם צריכים להשתמש ב-CLI של gcloud בגרסה 586.0.0 ואילך.

לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:

• ‫LINK_ID: השם של מערך הנתונים ב-BigQuery.
• ‫DATASET_ID: מזהה קבוצת הנתונים. נתוני העקבות מאוחסנים במערך נתונים בשם Spans.
• ‫BUCKET_ID: המזהה של קטגוריית הנתונים של יכולת התצפית. לדוגמה, המזהה יכול להיות _Trace.
• ‫LOCATION: המיקום של מאגר הנתונים של יכולת התצפית.
• ‫PROJECT_ID: מזהה הפרויקט.

מריצים את הפקודה gcloud observability buckets datasets links create:

‫Linux,‏ macOS או Cloud Shell

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

‏Windows (PowerShell)

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

Windows‏ (cmd.exe)

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 מפעילה פעולה ממושכת. זו דוגמה לתגובה שמתקבלת כשהפקודה מסתיימת ללא שגיאות:

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

Terraform

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

• ‫project: מזהה הפרויקט.
• ‫location: המיקום של הקישור. המיקום הזה צריך להיות זהה למיקום של דלי הנתונים של יכולת התצפית.
• ‫bucket: המזהה של קטגוריית הנתונים של יכולת התצפית. לדוגמה, _Trace.
• ‫dataset: המזהה של מערך הנתונים של יכולת התצפית. לדוגמה, Spans.
• ‫link_id: המזהה של מערך הנתונים ב-BigQuery.

אפשר גם לעדכן ולמחוק קישורים.

REST

כדי ליצור קישור למערך נתונים ב-BigQuery, שולחים בקשה לנקודת הקצה projects.locations.buckets.datasets.links.create.

צריך לציין את פרמטר האב, שמופיע בפורמט הבא:

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

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

• ‫PROJECT_ID: מזהה הפרויקט.
• ‫LOCATION: המיקום של קטגוריית ה-Observability.
• ‫BUCKET_ID: המזהה של קטגוריית הנתונים של יכולת התצפית. לדוגמה, המזהה יכול להיות _Trace.
• ‫DATASET_ID: המזהה של מערך הנתונים ששולחים אליו שאילתה. לדוגמה, המזהה יכול להיות Spans.

הפקודה הזו דורשת פרמטר של שאילתה וגוף בקשה:

• צריך לציין את פרמטר השאילתה, linkId, ולהגדיר אותו לשם של מערך הנתונים ב-BigQuery. לדוגמה, linkId="my_link". השם של מערך הנתונים ב-BigQuery צריך להיות ייחודי לפרויקט ב- Google Cloud , באורך של עד 100 תווים ויכול לכלול רק אותיות, ספרות וקווים תחתונים.

• גוף הבקשה הוא אובייקט Link. הערך של השדה name הוא בפורמט הבא:

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

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

  השדה LINK_ID הוא השם של מערך הנתונים ב-BigQuery.

התגובה היא אובייקט Operation. האובייקט הזה מכיל מידע על התקדמות השיטה. כשהשיטה מסתיימת, אובייקט Operation מכיל נתוני סטטוס.

במאמרי העזרה של Observability API יש רשימה מלאה של נקודות הקצה של Observability API.

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

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

• צפייה בטלמטריה וניתוח שלה

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