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

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

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

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

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

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

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

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

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

דוגמאות:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

היקפי המעקב

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

מגדירים את הפרויקט ואת תפקידי ה-IAM ובוחרים את הממשק שבו רוצים להשתמש.

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

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

  3. Verify that billing is enabled for your Google Cloud project.

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

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

  6. Verify that billing is enabled for your Google Cloud project.

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

  8. כדי לקבל את ההרשאות שצריך בשביל ליצור ולראות היקפים, אתם צריכים לבקש מהאדמין לתת לכם את התפקידים הבאים ב-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"
        }
        

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

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