Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

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

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

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

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

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

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

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

מידע על היקף יכולת הצפייה

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

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

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

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

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

נכנסים לחשבון 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 Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. 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

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

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

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

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

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

gcloud

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

הפעלת 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.
מידע נוסף מופיע במאמר אימות לשימוש ב-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: אופציונלי. תיאור היקף העקבות. התיאור צריך להיות בפורמט של מחרוזת.
‫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: אופציונלי. תיאור היקף העקבות. התיאור צריך להיות בפורמט של מחרוזת.
‫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

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

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

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

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