‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

יצירה וניהול של היקפי מעקב

אתם יכולים ליצור ולנהל היקפי מעקב, שמאפשרים לדף Trace Explorer למצוא נתוני מעקב כשהם מאוחסנים בכמה פרויקטים. אם אתם רוצים רק להציג ולנתח את הטווחים שמקורם בפרויקט Google Cloud שלכם, אתם לא צריכים להגדיר היקפי מעקב.

מידע על הצגה של עקבות וטווחים זמין במאמר חיפוש עקבות ועיון בהם.

מידע על היקפי מעקב

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

כשיוצרים היקף מעקב, מציינים שם ורשימה של פרויקטים. המערכת כוללת באופן אוטומטי את תצוגת ברירת המחדל של כל פרויקט, עם הנתיב _Trace/Spans/_AllSpans. השדות של הנתיב _Trace,‏ Spans ו-_AllSpans מתייחסים למאגר נתונים של יכולת תצפית, למערך הנתונים שבו הנתונים מאוחסנים ולתצוגה של מערך הנתונים. בתצוגה _AllSpans יש גישה לכל נתוני המעקב שמאוחסנים בפרויקט.

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

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

אפשר להגדיר היקף מעקב אחד כ'ברירת מחדל'. כשמגדירים את הסיווג הזה, קורים הדברים הבאים:

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

אתם יכולים לשנות ולמחוק כל היקף של מעקב שיצרתם.

אפליקציות של מרכז האפליקציות והיקפי מעקב

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

יוצרים את היקף המעקב המותאם אישית בפרויקט שממנו צופים בנתוני המעקב. הפרויקט הזה הוא הפרויקט המארח או פרויקט הניהול של מרכז האפליקציות. לדוגמה, אם השם המוצג של תיקייה הוא My Folder, אז השם המוצג של פרויקט הניהול של התיקייה הוא My Folder-mp.

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

מגדירים את הפרויקט ואת תפקידי ה-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.

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.

Roles required to enable APIs

Enable the API

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

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

כדי ליצור ולהציג היקפי מעקב, צריך את ההרשאות הבאות:
- observability.traceScopes.{create, delete, get, list, update}
- observability.scopes.{get, update}
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.

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

המסוף

כשמשתמשים במסוף Google Cloud כדי לגשת Google Cloud לשירותים ולממשקי ה-API, לא צריך להגדיר אימות.

gcloud

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

הפעלת Cloud Shell

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

Terraform

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

התקינו את ה-CLI של Google Cloud.
אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.
אם אתם משתמשים במעטפת מקומית, אתם צריכים ליצור פרטי כניסה לאימות מקומי עבור חשבון המשתמש:
```
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 .

הצגת היקפי מעקב

המסוף

כדי להציג את היקפי המעקב:

נכנסים לדף Settings במסוף Google Cloud :
עוברים אל הגדרות.

אם משתמשים בסרגל החיפוש כדי למצוא את הדף הזה, בוחרים בתוצאה שבה הכותרת המשנית היא Monitoring.
בסרגל הכלים של מסוף Google Cloud , בוחרים את Google Cloud הפרויקט. בהגדרות של מרכז האפליקציות, בוחרים את פרויקט המארח או את פרויקט הניהול של מרכז האפליקציות.
לוחצים על הכרטיסייה Trace Scopes (היקפי מעקב).

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

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

אם מרחיבים את היקף המעקב, אפשר לראות את רשימת התצוגות שהיקף המעקב כולל. בכל שורה מופיע מזהה פרויקט לצד רשומה כמו _Trace/Spans/_AllSpans, שמזהה את מיקום האחסון שמוגדר כברירת מחדל לנתוני העקבות. השדות _Trace,‏ Spans ו-_AllSpans מתייחסים לקטגוריית הניראות (observability), לקבוצת הנתונים ולתצוגה של נתוני המעקב. התצוגה _AllSpans מתאימה לכל רשומה בדלי:

שם	תיאור	סוג	משאבים
`_Default`		`Trace scope`	`1`
`myscope`	`My description`	`Trace scope`	`2`
`_Trace/Spans/_AllSpans`	`myproject`	`Trace view`
`_Trace/Spans/_AllSpans`	`project-b`	`Trace view`

gcloud

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

‫LOCATION: המיקום של היקף המעקב. חובה להזין ערך בשדה הזה של global.
‫PROJECT_ID: מזהה הפרויקט.

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

‫Linux,‏ macOS או Cloud Shell

gcloud observability trace-scopes list \
 --location=LOCATION --project=PROJECT_ID

‏Windows (PowerShell)

gcloud observability trace-scopes list `
 --location=LOCATION --project=PROJECT_ID

Windows‏ (cmd.exe)

gcloud observability trace-scopes list ^
 --location=LOCATION --project=PROJECT_ID

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

name: projects/my-project/locations/global/traceScopes/_Default
resourceNames:
- projects/my-project
---
createTime: '2026-03-26T13:43:54.772326947Z'
description: a test
name: projects/my-project/locations/global/traceScopes/my-test-scope
resourceNames:
- projects/another-project
- projects/my-project
updateTime: '2026-03-26T13:43:54.772326947Z'

Terraform

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

REST

כדי להציג את כל היקפי המעקב בפרויקט Google Cloud , משתמשים בפקודה projects.locations.traceScopes.list. חובה לציין פרמטר של נתיב.

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

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes

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

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

התגובה היא מערך של אובייקטים מסוג TraceScope. כל אובייקט כולל שם ורשימה של משאבים.

כדי לקבל מידע על היקף ספציפי של מעקב, משתמשים בפקודה projects.locations.traceScopes.get.

יצירת היקף למעקב

הטווחים שמוצגים בדף Trace Explorer תלויים בתצוגות שחיפשתם, בתפקידי ה-IAM שלכם בתצוגות האלה, בהגדרת טווח הזמן ובמסננים שהחלתם.

אפשר ליצור 100 היקפי מעקב לכל פרויקט. היקף המעקב יכול לכלול עד 20 תצוגות.

המסוף

כדי ליצור היקף מעקב:

נכנסים לדף Settings במסוף Google Cloud :
עוברים אל הגדרות.

אם משתמשים בסרגל החיפוש כדי למצוא את הדף הזה, בוחרים בתוצאה שבה הכותרת המשנית היא Monitoring.
בסרגל הכלים של מסוף Google Cloud , בוחרים את Google Cloud הפרויקט. בהגדרות של מרכז האפליקציות, בוחרים את פרויקט המארח או את פרויקט הניהול של מרכז האפליקציות.
לוחצים על הכרטיסייה Trace Scopes (היקפי מעקב) ואז על Create trace scope (יצירת היקף מעקב).
לוחצים על הוספת פרויקטים ומשלימים את תיבת הדו-שיח.

הערה: כשבוחרים פרויקט, המערכת מוסיפה את תצוגת ברירת המחדל של הפרויקט לטווח.
בקטע Name trace scope (שם היקף המעקב), מזינים את השם והתיאור שרוצים שיוצגו בכרטיסייה Trace Scopes (היקפי מעקב).

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

לוחצים על Create trace scope (יצירת היקף של מעקב).

כברירת מחדל, הטבלה Trace scopes מציגה את היקפי המעקב שלכם בצורה מכווצת. בטבלה מפורטים השם, התיאור, הסוג ומספר המשאבים של כל היקף.

שם	תיאור	סוג	משאבים
`_Default`		`Trace scope`	`1`
`myscope`	`My description`	`Trace scope`	`2`
`_Trace/Spans/_AllSpans`	`myproject`	`Trace view`
`_Trace/Spans/_AllSpans`	`project-b`	`Trace view`

gcloud

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

‫TRACE_SCOPE_NAME: השם של היקף המעקב. לדוגמה, my-trace-scope.
‫DESCRIPTION: אופציונלי. תיאור ההיקף של ה-trace. התיאור צריך להיות בפורמט של מחרוזת.
‫RESOURCE_NAMES: רשימה מופרדת בפסיקים של השמות המלאים של הפרויקטים. לדוגמה, projects/my-project.
‫LOCATION: המיקום של היקף המעקב. חובה להזין ערך בשדה הזה של global.
‫PROJECT_ID: מזהה הפרויקט.

מריצים את הפקודה gcloud observability trace-scopes create:

‫Linux,‏ macOS או Cloud Shell

gcloud observability trace-scopes create TRACE_SCOPE_NAME \
 --description=DESCRIPTION \
 --resource-names=RESOURCE_NAMES \
 --location=LOCATION --project=PROJECT_ID

‏Windows (PowerShell)

gcloud observability trace-scopes create TRACE_SCOPE_NAME `
 --description=DESCRIPTION `
 --resource-names=RESOURCE_NAMES `
 --location=LOCATION --project=PROJECT_ID

Windows‏ (cmd.exe)

gcloud observability trace-scopes create TRACE_SCOPE_NAME ^
 --description=DESCRIPTION ^
 --resource-names=RESOURCE_NAMES ^
 --location=LOCATION --project=PROJECT_ID

אם הפקודה create מסתיימת ללא שגיאות, התגובה שלה כוללת את השם של היקף המעקב החדש:

Created traceScope [my-test-scope].

Terraform

מידע על החלה או הסרה של הגדרות ב-Terraform זמין במאמר פקודות בסיסיות ב-Terraform. מידע נוסף מופיע במאמרי העזרה על ספק Terraform.

כדי ליצור היקף מעקב בפרויקט באמצעות Terraform, משתמשים במשאב Terraform‏ google_observability_trace_scope.

בפקודה, מגדירים את השדות הבאים:

‫project: השם של הפרויקט, התיקייה או הארגון. לדוגמה, my-project. בהגדרות של מרכז האפליקציות, בוחרים את פרויקט המארח או את פרויקט הניהול של מרכז האפליקציות.

הערה: המערכת לא מוסיפה את הפרויקט להיקף. במקום זאת, המערכת מוסיפה את _AllSpansהתצוגה של הפרויקט במערך הנתונים Spans
.
‫trace_scope_id: מוגדר למזהה של היקף. לדוגמה, my-trace-scope.
‫location: מוגדר ל-"global".
‫resource_names: מערך של פרויקטים, שכל אחד מהם מצוין באמצעות השם המוגדר במלואו.
‫description: תיאור קצר. לדוגמה, 'היקף המשאבים לייצור'.

REST

כדי ליצור היקף של מעקב, משתמשים בפקודה projects.locations.traceScopes.create. חובה לציין פרמטר של נתיב ולספק אובייקט TraceScope. התגובה היא אובייקט TraceScope.

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

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes

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

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

שינוי היקף המעקב

אי אפשר לשנות את היקף המעקב שנקרא _Default. אתם יכולים לשנות את כל ההיקפים האחרים של המעקב.

המסוף

כדי לשנות את היקף המעקב:

נכנסים לדף Settings במסוף Google Cloud :
עוברים אל הגדרות.

אם משתמשים בסרגל החיפוש כדי למצוא את הדף הזה, בוחרים בתוצאה שבה הכותרת המשנית היא Monitoring.
בסרגל הכלים של מסוף Google Cloud , בוחרים את Google Cloud הפרויקט. בהגדרות של מרכז האפליקציות, בוחרים את פרויקט המארח או את פרויקט הניהול של מרכז האפליקציות.
לוחצים על הכרטיסייה Trace Scopes (היקפי מעקב).
מוצאים את היקף המעקב שרוצים לשנות, לוחצים על עוד, בוחרים באפשרות עריכת היקף ומשלימים את תיבת הדו-שיח.

gcloud

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

‫TRACE_SCOPE_NAME: השם של היקף המעקב. לדוגמה, my-trace-scope.
‫DESCRIPTION: אופציונלי. תיאור ההיקף של ה-trace. התיאור צריך להיות בפורמט של מחרוזת.
‫RESOURCE_NAMES: רשימה מופרדת בפסיקים של השמות המלאים של הפרויקטים. לדוגמה, projects/my-project.
‫LOCATION: המיקום של היקף המעקב. חובה להזין ערך בשדה הזה של global.
‫PROJECT_ID: מזהה הפרויקט.

מריצים את הפקודה gcloud observability trace-scopes update:

‫Linux,‏ macOS או Cloud Shell

gcloud observability trace-scopes update TRACE_SCOPE_NAME \
 --description=DESCRIPTION \
 --resource-names=RESOURCE_NAMES \
 --location=LOCATION --project=PROJECT_ID

‏Windows (PowerShell)

gcloud observability trace-scopes update TRACE_SCOPE_NAME `
 --description=DESCRIPTION `
 --resource-names=RESOURCE_NAMES `
 --location=LOCATION --project=PROJECT_ID

Windows‏ (cmd.exe)

gcloud observability trace-scopes update TRACE_SCOPE_NAME ^
 --description=DESCRIPTION ^
 --resource-names=RESOURCE_NAMES ^
 --location=LOCATION --project=PROJECT_ID

אם הפקודה update מצליחה, נתוני התגובה שלה מציגים את היקף המעקב המעודכן:

Updated traceScope [my-test-scope].
createTime: '2026-03-26T13:43:54.772326947Z'
description: A scope for testing
name: projects/my-project/locations/global/traceScopes/my-test-scope
resourceNames:
- projects/another-project
- projects/my-project
updateTime: '2026-03-26T13:48:05.262142872Z'

Terraform

כדי לשנות את היקף המעקב בפרויקט באמצעות Terraform, משתמשים במשאב Terraform‏ google_observability_trace_scope.

REST

כדי לשנות את היקף ה-trace, משתמשים בפקודה projects.locations.traceScopes.patch. צריך לציין פרמטר של נתיב, פרמטרים של שאילתה ולספק אובייקט TraceScope. פרמטרים של שאילתה מזהים את השדות שמשתנים. התגובה היא אובייקט TraceScope.

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

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes/TRACE_SCOPE_NAME

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

‫PROJECT_ID: מזהה הפרויקט. בהגדרות של מרכז האפליקציות, בוחרים את פרויקט המארח או את פרויקט הניהול של מרכז האפליקציות.
הערך של LOCATION_ID חייב להיות global.
‫TRACE_SCOPE_NAME: השם של היקף המעקב. לדוגמה, my-trace-scope.

מחיקת היקף מעקב

אי אפשר למחוק את היקף המעקב שנקרא _Default. אפשר למחוק את כל שאר היקפי המעקב.

המסוף

כדי למחוק היקף של מעקב:

נכנסים לדף Settings במסוף Google Cloud :
עוברים אל הגדרות.

אם משתמשים בסרגל החיפוש כדי למצוא את הדף הזה, בוחרים בתוצאה שבה הכותרת המשנית היא Monitoring.
בסרגל הכלים של מסוף Google Cloud , בוחרים את Google Cloud הפרויקט. בהגדרות של מרכז האפליקציות, בוחרים את פרויקט המארח או את פרויקט הניהול של מרכז האפליקציות.
לוחצים על הכרטיסייה Trace Scopes (היקפי מעקב).
מוצאים את היקף המעקב שרוצים למחוק, לוחצים על More, בוחרים באפשרות Delete scope וממלאים את תיבת הדו-שיח.

gcloud

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

‫TRACE_SCOPE_NAME: השם של היקף המעקב. לדוגמה, my-trace-scope.
‫LOCATION: המיקום של היקף המעקב. חובה להזין ערך בשדה הזה של global.
‫PROJECT_ID: מזהה הפרויקט.

מריצים את הפקודה gcloud observability trace-scopes delete:

‫Linux,‏ macOS או Cloud Shell

gcloud observability trace-scopes delete TRACE_SCOPE_NAME \
 --location=LOCATION --project=PROJECT_ID

‏Windows (PowerShell)

gcloud observability trace-scopes delete TRACE_SCOPE_NAME `
 --location=LOCATION --project=PROJECT_ID

Windows‏ (cmd.exe)

gcloud observability trace-scopes delete TRACE_SCOPE_NAME ^
 --location=LOCATION --project=PROJECT_ID

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

You are about to delete traceScope [my-test-scope]

Do you want to continue (Y/n)?  Y

Deleted traceScope [my-test-scope].

Terraform

כדי למחוק היקף של מעקב בפרויקט באמצעות Terraform, משתמשים במשאב Terraform‏ google_observability_trace_scope.

REST

כדי למחוק היקף של מעקב, משתמשים בפקודה projects.locations.traceScopes.delete. חובה לציין פרמטר של נתיב.

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

projects/PROJECT_ID/locations/LOCATION_ID/traceScopes/TRACE_SCOPE_NAME

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

‫PROJECT_ID: מזהה הפרויקט. בהגדרות של מרכז האפליקציות, בוחרים את פרויקט המארח או את פרויקט הניהול של מרכז האפליקציות.
הערך של LOCATION_ID חייב להיות global.
‫TRACE_SCOPE_NAME: השם של היקף המעקב. לדוגמה, my-trace-scope.

הגדרת היקף ברירת המחדל של המעקב

כשנפתח הדף Trace Explorer, המערכת מחפשת נתוני מעקב בתצוגות שמופיעות בהיקף ברירת המחדל של המעקב. אם אי אפשר לגשת להיקף ברירת המחדל, הדף יחפש נתוני מעקב בפרויקט. החיפוש הזה שווה להרצת שאילתה בתצוגה _AllSpans של הפרויקט במערך הנתונים שמוגדר כברירת מחדל.

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

המסוף

כדי להגדיר את היקף ברירת המחדל של המעקב:

נכנסים לדף Settings במסוף Google Cloud :
עוברים אל הגדרות.

אם משתמשים בסרגל החיפוש כדי למצוא את הדף הזה, בוחרים בתוצאה שבה הכותרת המשנית היא Monitoring.
בסרגל הכלים של מסוף Google Cloud , בוחרים את Google Cloud הפרויקט. בהגדרות של מרכז האפליקציות, בוחרים את פרויקט המארח או את פרויקט הניהול של מרכז האפליקציות.
לוחצים על הכרטיסייה Trace Scopes (היקפי מעקב).

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

היקף המעקב שבחרתם מוצג עם סמל ברירת המחדל, .

gcloud

כדי לראות ולעדכן את היקף יכולת התצפית:

כדי לראות את ההגדרות של היקף יכולת התצפית, מריצים את הפקודה gcloud observability scopes describe.

לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
- ‫OBSERVABILITY_SCOPE_ID: השם של אובייקט Scope. הערך הזה חייב להיות _Default.
- ‫LOCATION: שדה המיקום צריך להיות מוגדר ל-global.
- ‫PROJECT_ID: מזהה הפרויקט.
מריצים את הפקודה gcloud observability scopes describe:
‫Linux,‏ macOS או Cloud Shell
```
gcloud observability scopes describe OBSERVABILITY_SCOPE_ID \
   --location=LOCATION\
   --project=PROJECT_ID
```
‏Windows (PowerShell)
```
gcloud observability scopes describe OBSERVABILITY_SCOPE_ID `
   --location=LOCATION`
   --project=PROJECT_ID
```
Windows‏ (cmd.exe)
```
gcloud observability scopes describe OBSERVABILITY_SCOPE_ID ^
   --location=LOCATION^
   --project=PROJECT_ID
```
התגובה לפקודה תהיה דומה לזו:
```
logScope: logging.googleapis.com/projects/my-project/locations/global/logScopes/_Default
traceScope: projects/my-project/locations/global/traceScopes/_Default
name: projects/my-project/locations/global/scopes/_Default
```
כדי לעדכן את היקף יכולת התצפית, מריצים את הפקודה gcloud observability scopes update. בפקודה update אפשר לכלול את הדגל --log-scope, את הדגל --trace-scope או את שני הדגלים.

לפני השימוש בנתוני הפקודה הבאים, צריך להחליף את הנתונים הבאים:
- ‫OBSERVABILITY_SCOPE_ID: השם של אובייקט Scope. הערך הזה חייב להיות _Default.
- ‫LOG_SCOPE_FQN_ID: שם המשאב המלא של אוסף תצוגות יומן (log scope). השדה הזה הוא בפורמט הבא:
```
logging.googleapis.com/projects/PROJECT_ID/locations/LOCATION/logScopes/LOG_SCOPE_ID
```
  בביטוי הקודם, LOG_SCOPE_ID הוא המזהה של אוסף תצוגות יומן (log scope). לדוגמה, my-scope.
- ‫TRACE_SCOPE_FQN_ID: שם המשאב המלא של היקף המעקב. השדה הזה הוא בפורמט הבא:
```
projects/PROJECT_ID/locations/LOCATION/traceScopes/TRACE_SCOPE_NAME
```
  בביטוי הקודם, TRACE_SCOPE_NAME הוא השם של היקף המעקב. לדוגמה, my-trace-scope.
- ‫LOCATION: שדה המיקום צריך להיות מוגדר ל-global.
- ‫PROJECT_ID: מזהה הפרויקט.
מריצים את הפקודה gcloud observability scopes update:
‫Linux,‏ macOS או Cloud Shell
```
gcloud observability scopes update OBSERVABILITY_SCOPE_ID \
   --log-scope=LOG_SCOPE_FQN_ID\
   --trace-scope=TRACE_SCOPE_FQN_ID\
   --location=LOCATION\
   --project=PROJECT_ID
```
‏Windows (PowerShell)
```
gcloud observability scopes update OBSERVABILITY_SCOPE_ID `
   --log-scope=LOG_SCOPE_FQN_ID`
   --trace-scope=TRACE_SCOPE_FQN_ID`
   --location=LOCATION`
   --project=PROJECT_ID
```
Windows‏ (cmd.exe)
```
gcloud observability scopes update OBSERVABILITY_SCOPE_ID ^
   --log-scope=LOG_SCOPE_FQN_ID^
   --trace-scope=TRACE_SCOPE_FQN_ID^
   --location=LOCATION^
   --project=PROJECT_ID
```
לדוגמה, אם הערך של LOG_SCOPE_ID הוא my-log-scope והערך של TRACE_SCOPE_NAME הוא my-trace-scope, התגובה תהיה דומה לזו:
```
Updated scope [_Default].
logScope: logging.googleapis.com/projects/my-project/locations/global/logScopes/my-log-scope
traceScope: projects/my-project/locations/global/traceScopes/my-trace-scope
name: projects/my-project/locations/global/scopes/_Default
```

Terraform

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

REST

כדי לקבל ולהגדיר את אוסף תצוגות יומן (log scope) ברירת המחדל או את היקף ברירת המחדל של יומן מעקב באמצעות קריאה ל-API, צריך להגדיר את היקף ניראות (observability). בהיקף הניראות מפורטים אוסף תצוגות יומן (log scope) ברירת המחדל והיקף ברירת המחדל של המעקב:

כדי לקבל את היקף ברירת המחדל של יכולת הצפייה בפרויקט, שולחים בקשה לנקודת הקצה projects.locations.scopes.get. חובה לציין פרמטר של נתיב. התשובה היא אובייקט Scope שמפרט את היקף היומן שמוגדר כברירת מחדל ואת היקף המעקב שמוגדר כברירת מחדל.
כדי לעדכן את היקף ברירת המחדל של יכולת הצפייה בפרויקט, שולחים בקשה לנקודת הקצה projects.locations.scopes.patch. צריך לציין פרמטר של נתיב, פרמטרים של שאילתה ולספק אובייקט Scope. פרמטרים של שאילתה מזהים אילו שדות משתנים. התגובה היא אובייקט Scope.

פרמטר הנתיב בשתי נקודות הקצה הוא מהצורה הבאה:

projects/PROJECT_ID/locations/LOCATION/scopes/OBSERVABILITY_SCOPE_ID

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

‫PROJECT_ID: מזהה הפרויקט. בהגדרות של מרכז האפליקציות, בוחרים את פרויקט המארח או את פרויקט הניהול של מרכז האפליקציות.
‫LOCATION: בשדה המיקום צריך להזין global.
‫OBSERVABILITY_SCOPE_ID: השם של אובייקט Scope. הערך בשדה הזה חייב להיות _Default. אובייקט Scope עם השם _Default, שנוצר באופן אוטומטי, מאחסן מידע על אוסף תצוגות יומן (log scope) שמוגדר כברירת מחדל ועל היקף המעקב שמוגדר כברירת מחדל.

כדי לשלוח פקודה לנקודת קצה ל-API, אפשר להשתמש ב-APIs Explorer, שמאפשר לשלוח פקודה מדף הפניה. לדוגמה, כדי לקבל את היקף ברירת המחדל הנוכחי, אפשר לבצע את הפעולות הבאות:

לוחצים על projects.locations.scopes.get.
בווידג'ט Try this method (כדאי לנסות את השיטה הזו), מזינים את הפרטים הבאים בשדה name (שם):
```
    projects/PROJECT_ID/locations/global/scopes/_Default
    
```
לפני שמעתיקים את השדה הקודם, מחליפים את PROJECT_ID בשם הפרויקט.
לוחצים על Execute (ביצוע).

בתיבת הדו-שיח של ההרשאה, משלימים את השלבים הנדרשים.

התגובה אמורה להיראות כך:

    {
    "name": "projects/my-project/locations/global/scopes/_Default",
    "logScope": "logging.googleapis.com/projects/my-project/locations/global/logScopes/_Default"
    "traceScope": "projects/my-project/locations/global/traceScopes/_Default"
    }

מגבלות על היקפי מעקב

מגבלות על היקפי מעקב	ערך
המספר המקסימלי של היקפי מעקב לכל פרויקט	100
מספר הצפיות המקסימלי לכל היקף מעקב	20

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

חיפוש ועריכה של עקבות
‫Cloud Logging ו-Cloud Monitoring מכילים מבנים דומים שמאפשרים לכם לשלוט בנתוני היומן או בנתוני המדדים שאתם יכולים לראות או לעקוב אחריהם. מידע על ההיקפים האלה זמין במסמכים הבאים:

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

מידע על היקפי מעקב

אפליקציות של מרכז האפליקציות והיקפי מעקב

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

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

ההרשאות הנדרשות

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

המסוף

gcloud

Terraform

REST

הצגת היקפי מעקב

המסוף

gcloud

‫Linux,‏ macOS או Cloud Shell

‏Windows (PowerShell)

Windows‏ (cmd.exe)

Terraform

REST

יצירת היקף למעקב

המסוף

gcloud

‫Linux,‏ macOS או Cloud Shell

‏Windows (PowerShell)

Windows‏ (cmd.exe)

Terraform

REST

שינוי היקף המעקב

המסוף

gcloud

‫Linux,‏ macOS או Cloud Shell

‏Windows (PowerShell)

Windows‏ (cmd.exe)

Terraform

REST

מחיקת היקף מעקב

המסוף

gcloud

‫Linux,‏ macOS או Cloud Shell

‏Windows (PowerShell)

Windows‏ (cmd.exe)

Terraform

REST

הגדרת היקף ברירת המחדל של המעקב

המסוף

gcloud

‫Linux,‏ macOS או Cloud Shell

‏Windows (PowerShell)

Windows‏ (cmd.exe)

‫Linux,‏ macOS או Cloud Shell

‏Windows (PowerShell)

Windows‏ (cmd.exe)

Terraform

REST

מגבלות על היקפי מעקב

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

יצירה וניהול של היקפי מעקב