הגדרת היקפי ניראות (observability) לשאילתות של כמה פרויקטים

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

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

היקפי ההרשאות מספקים צבירה בזמן הקריאה

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

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

כברירת מחדל, נתוני היומן מאוחסנים בפרויקט, בחשבון לחיוב, בתיקייה או בארגון ב- Google Cloud שמהם הנתונים מגיעים. עם זאת, אתם יכולים להגדיר את Logging כך שינתב את נתוני היומן מהמשאב שבו הם נוצרו למיקום אחר, כמו פרויקט אחר או מאגר יומנים מרכזי. בכל המקרים, צריך להגדיר אוסף תצוגות יומן בהתאמה אישית. מומלץ שהיקף היומן יכלול רשימה של תצוגות יומנים במקום פרויקטים. תצוגת יומן מספקת גישת קריאה לקבוצת משנה של רשומות בתוך מאגר יומנים. לדוגמה, אם נתוני היומן מאוחסנים בשלושה פרויקטים, תוכלו להגדיר את תצוגת היומן כך שתכלול את התצוגה _Default/_AllLogs לכל אחד מהפרויקטים האלה.

איך Google Cloud Observability משתמש בהיקפים

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

דוגמאות:

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

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

ב-Monitoring מתבצע אימות של תפקיד ה-IAM שלכם בפרויקט שממנו נשלחה השאילתה. נניח שהיקף המדדים בפרויקט בשם AllEnv כולל את הפרויקטים הבאים: AllEnv,‏ Prod ו-Staging. נניח גם שקיבלתם את התפקיד "צפייה ב-Monitoring" בפרויקט AllEnv. בתרשימים שיוצרים בדף Metrics Explorer כשמשתמשים בפרויקט AllEnv, מוצגים באופן אוטומטי נתוני המדדים של שלושת הפרויקטים.

היקפי ההרשאות של Google Cloud Observability

בקטע הזה מוסבר על ההיקפים שבהם משתמשים ב-Google Cloud Observability.

היקף הניראות (observability)

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

אם לא מגדירים את היקף הניראות, קורים הדברים הבאים:

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

היקף הניטור לא חל על נתוני המדדים.

מתי להגדיר את היקף הניראות

כדאי להגדיר את היקף הניראות בתרחישים הבאים:

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

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

מגבלות שקשורות להיקפי תצפית

תיאור	ערך מקסימלי
מספר היקפי התצפית בכל פרויקט	1

אוספי תצוגות יומן (log scopes)

הדף Logs Explorer ומרכזי הבקרה שמציגים נתוני יומנים משתמשים באוספי תצוגות יומן:

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

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

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

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

מתי כדאי ליצור אוספי תצוגות יומנים (log scopes) בהתאמה אישית

יוצרים אוספי תצוגות יומן (log scope) מותאמים אישית להגדרות הבאות:

• אתם מנתבים את נתוני היומנים לקטגוריית יומנים מרכזית.
• אתם מאחסנים נתוני יומנים בכמה פרויקטים.
• אתם משתמשים ב-Application Monitoring, שירות שיוצר מרכזי בקרה לאפליקציות ב-App Hub.

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

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

שיטות מומלצות להגדרת אוספי תצוגות יומן

• לכלול רק תצוגות של יומנים.
• אל תגדירו היקף שכולל גם פרויקטים וגם תצוגות של יומנים.

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

תיאור	ערך מקסימלי
מספר אוספי תצוגות היומן בכל פרויקט	100
מספר הפרויקטים בכל אוסף תצוגות יומן	5
מספר תצוגות היומנים או הפרויקטים בכל אוסף תצוגות יומן	100

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

היקף המדדים בפרויקט

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

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

מתי להגדיר את היקפי המדדים בפרויקטים

צריך להגדיר את היקף המדדים בפרויקט בכל אחד מהמקרים הבאים:

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

מגבלות שקשורות להיקפי המדדים בפרויקט

תיאור	ערך מקסימלי
מספר היקפי המדדים בכל פרויקט	1
מספר הפרויקטים בכל היקף מדדים בפרויקט	375

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

היקפי הרשאות של Trace

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

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

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

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

כדאי ליצור היקפי מעקב בהתאמה אישית כשיש לכם אפליקציות שמסתמכות על משאבים בפרויקטים שונים ב- Google Cloud .

שיטות מומלצות להגדרת היקפי מעקב

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

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

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

מידע נוסף זמין במאמר יצירה וניהול של היקפי מעקב.

הגדרת היקף הניראות (observability)

הקטע הזה לא רלוונטי לתיקיות או לארגונים.

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

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

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

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

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

   • כדי ליצור ולראות אוספי תצוגות יומן, ולקבל את אוסף תצוגות היומן שמוגדר כברירת מחדל: כותב הגדרות של יומנים (roles/logging.configWriter) בפרויקט
   • כדי לשנות את היקף המדדים בפרויקט: אדמין של Monitoring ‏ (roles/monitoring.admin) בפרויקט ובכל פרויקט שרוצים להוסיף להיקף המדדים בפרויקט
   • כדי ליצור ולהציג היקפי מעקב, וכדי לקבל ולהגדיר היקפי ברירת מחדל: עריכת היקפי תצפית (roles/observability.scopesEditor) בפרויקט

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

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

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

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

   • logging.logScopes.{create, delete, get, list, update}
   • monitoring.metricsscopes.{link, get, list}
   • observability.traceScopes.{create, delete, get, list, update}
   • observability.scopes.{get, update}

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

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

המסוף

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

gcloud

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

הפעלת Cloud Shell

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

REST

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

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

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

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

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

המסוף

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

1. נכנסים לדף  Settings במסוף Google Cloud :

   עוברים אל הגדרות.

   אם אתם משתמשים בשורת החיפוש כדי למצוא את הדף הזה, בחרו בתוצאה שכותרת המשנה שלה היא Monitoring.

2. בסרגל הכלים של מסוף Google Cloud , בוחרים את הפרויקט ב- Google Cloud . להגדרות של App Hub, בוחרים את הפרויקט המארח או את פרויקט הניהול של App Hub.

3. מגדירים את אוסף תצוגות היומן שמוגדר כברירת מחדל:

   1. לוחצים על הכרטיסייה Log Scopes.

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

   2. מוצאים את הרשומה שרוצים להגדיר כברירת מחדל, לוחצים על  More ובוחרים באפשרות Set as default.

4. הגדרת היקף המדדים בפרויקט:

   1. לוחצים על הכרטיסייה היקף המדדים בפרויקט.
   2. בחלונית Google Cloud Projects, לוחצים על Add Projects וממלאים את הפרטים בתיבת הדו-שיח. למידע נוסף, קראו את המאמר הגדרת היקפי המדדים בפרויקט.

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

   1. בוחרים בכרטיסייה Trace Scopes ואז:

      היקפי המעקב הקיימים מופיעים ברשימה. הרשומה עם הסמל "Default" (ברירת מחדל), , היא היקף המעקב שמוגדר כברירת מחדל. אם רוצים ליצור היקף מעקב, לוחצים על Create log scope ומשלימים את תיבת הדו-שיח. מידע נוסף זמין במאמר יצירה וניהול של היקפי מעקב.

   2. מוצאים את הרשומה שרוצים להגדיר כברירת מחדל, לוחצים על  More ובוחרים באפשרות Set as default.

gcloud

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

1. כדי לראות את ההגדרות של היקף הניראות, מריצים את הפקודה 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
   

2. כדי לעדכן את היקף הניראות, מריצים את הפקודה gcloud observability scopes update. בפקודה update, אפשר לכלול את הדגל --log-scope, את הדגל --trace-scope או את שניהם.

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

   • ‫OBSERVABILITY_SCOPE_ID: השם של אובייקט Scope. הערך הזה חייב להיות _Default.
   • ‫LOG_SCOPE_FQN_ID: השם המלא של המשאב של אוסף תצוגות היומן. השדה הזה הוא בפורמט הבא:

     logging.googleapis.com/projects/PROJECT_ID/locations/LOCATION/logScopes/LOG_SCOPE_ID

     בביטוי שלמעלה, LOG_SCOPE_ID הוא המזהה של אוסף תצוגות היומן. לדוגמה, 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
   

REST

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

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

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

projects/PROJECT_ID/locations/LOCATION/scopes/OBSERVABILITY_SCOPE_ID

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

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

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

1. לוחצים על projects.locations.scopes.get.
2. בווידג'ט Try this method, מזינים את הערך הבא בשדה name:

       projects/PROJECT_ID/locations/global/scopes/_Default
       

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

3. לוחצים על Execute.
4. בתיבת הדו-שיח של ההרשאה, משלימים את השלבים הנדרשים.

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

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

מידע נוסף על היקפים

מידע נוסף על היקפי הרשאות זמין במסמכים הבאים:

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