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

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

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

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

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

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

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

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

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

דוגמאות:

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

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

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

היקפי Google Cloud Observability

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

היקף הניראות

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

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

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

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

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

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

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

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

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

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

היקפי היומן

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

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

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

אוסף תצוגות יומן (log scope) יכול לכלול תצוגות יומן, פרויקטים, תיקיות וארגונים.

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

מתי כדאי ליצור היקפי יומן מותאמים אישית

יוצרים היקפי יומן מותאמים אישית להגדרות הבאות:

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

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

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

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

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

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

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

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

היקף המדדים

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

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

מתי מגדירים את היקפי המדדים

מגדירים את היקף המדדים אם מתקיים אחד מהתנאים הבאים:

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

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

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

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

היקפי המעקב

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

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

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

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

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

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

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

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

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

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

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

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

התפקידים שלכם בניהול זהויות והרשאות גישה (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.

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.

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.

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

1. כדי לקבל את ההרשאות שדרושות ליצירה ולהצגה של היקפי הרשאות, צריך לבקש מהאדמין להקצות לכם את תפקידי ה-IAM הבאים:

   • כדי ליצור ולהציג אוספי תצוגות יומן (log scope) וכדי לקבל את אוסף תצוגות היומן (log scope) שמוגדר כברירת מחדל: Logs Configuration Writer (roles/logging.configWriter) on your project
   • כדי לשנות היקף למעקב אחרי מדדים: אדמין של Monitoring (roles/monitoring.admin) בפרויקט ובכל פרויקט שרוצים להוסיף להיקף למעקב אחרי מדדים.
   • כדי ליצור ולהציג היקפי מעקב, וכדי לקבל ולהגדיר היקפים שמוגדרים כברירת מחדל: Observability Scopes Editor (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}

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

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

   המסוף

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

   gcloud

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

   הפעלת 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 .

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

המסוף

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

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

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

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

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

3. הגדרת אוסף תצוגות יומן (log scope) ברירת המחדל:

   1. לוחצים על הכרטיסייה היקפי יומן.

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

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

4. מגדירים את היקף המדדים:

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

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

   1. לוחצים על הכרטיסייה Trace Scopes (היקפי מעקב) ופועלים לפי השלבים הבאים:

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

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

gcloud

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

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

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: שם המשאב המלא של אוסף תצוגות יומן (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
   

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

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

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

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

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