תוויות מטא-נתונים של משאבים שיצאו משימוש

למשאבים במעקב ב-Cloud Monitoring יש קבוצה של תוויות שמשמשות לזיהוי מופע מסוים של סוג המשאב במעקב. התוויות האלה מתועדות לכל סוג של משאב במעקב ברשימת המשאבים במעקב.

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

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

ההשפעות של הוצאה משימוש

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

מדיניות התראות, תרשימים, כרטיסי ניקוד וקבוצות משאבים שמשתמשים בתוויות מטא-נתונים שלא הועברו באופן אוטומטי או ידני עד 31 ביולי 2020, כבר לא נתמכים ויכול להיות שהם יפסיקו לפעול.

פעולה נדרשת

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

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

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

תוויות מטא-נתונים שהוצאו משימוש

בטבלה הבאה מפורטים התוויות של מטא-נתוני המשאבים שהוצאו משימוש והתוויות שמחליפות אותן, אם יש כאלה.

סוג המשאב במעקב	תווית שהוצאה משימוש	תווית מקבילה
כל Google Cloud הסוגים	`metadata.system_labels.cloud_account`^*	`resource.labels.project_id`
`cloud_tasks_queue`	`metadata.system_labels.name` `metadata.system_labels.state`	`resource.labels.queue_id` none
`dataflow_job`	`metadata.system_labels.name` `metadata.system_labels.state`	`resource.labels.job_name` none
`gae_app`	`metadata.system_labels.gaeapp` `metadata.system_labels.gaemodule` `metadata.system_labels.gaeversion`	אין^† מומלץ `resource.labels.project_id` אין^† מומלץ `resource.labels.module_id` אין^† מומלץ `resource.labels.version_id`
`gce_disk`	`metadata.user_labels.name`^‡	`metadata.system_labels.name`
`gce_instance`	`metadata.user_labels.name`^‡	`metadata.system_labels.name`
`l7_lb_rule`	`metadata.system_labels.state`	ללא
`pubsub_topic`	`metadata.system_labels.name`^#	`metadata.system_labels.name`
`pubsub_subscription`	`metadata.system_labels.name`^#	`metadata.system_labels.name`
`vpn_gateway`	`metadata.system_labels.region`	`resource.labels.region`

^* תחביר המסננים ב-Cloud Monitoring לא מאפשר להשתמש בתווית resources.labels.project_id בצורה גמישה כמו בתווית metadata.system_labels.cloud_account. לדוגמה, אי אפשר:

אפשר להשתמש ב-OR כדי לשלב ביטוי עם התווית project_id וביטוי עם תוויות של מטא-נתונים.

משתמשים בפעולה != עם התווית project_id:

משתמשים בפונקציות starts_with או has_substring עם התווית project_id.

‫^† לגבי משאבי gae_app: תוויות המשאבים שצוינו דומות לתוויות המטא-נתונים שהוצאו משימוש, ולכן הן יכולות להיות תחליף טוב. אבל בגלל שהן רק דומות, הן לא הועברו אוטומטית.

‫^‡ למשאבי gce_disk ו-gce_instance: אם לא מגדירים את metadata.user_labels.name בדרך אחרת, המערכת מאכלסת אותו אוטומטית עם הערך מ-metadata.system_labels.name. ההוספה האוטומטית הזו הסתיימה גם היא ב-31 ביולי 2020. מדיניות התראות, תרשימים, כרטיסי ניקוד וקבוצות משאבים שמסננים לפי ערך metadata.user_labels.name שאוכלס אוטומטית הועברו לשימוש ב-metadata.system_labels.name.

‫^# במשאבי pubsub_topic ו-pubsub_subscription: פתרנו באג שהיה קיים זמן רב וגרם להמרה אוטומטית של metadata.system_labels.name לאותיות קטנות (לדוגמה, "My-Subscription" הפך ל-"my-subscription"). זה גרם להתנהגות לא צפויה במקרים שבהם למשתמשים היו כמה משאבים שהשמות שלהם באותיות קטנות היו זהים. התנהגות זו הסתיימה גם היא ב-31 ביולי 2020. אחרי התאריך הזה, תווית המערכת של המטא-נתונים name תשקף את השם בפועל של הנושא או המינוי (לדוגמה, "My-Subscription").

מה עליי לעשות?

יש שני שלבים כלליים:

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

חיפוש תוויות מטא-נתונים שהוצאו משימוש

אפשר להשתמש בסקריפט Python הזה כדי לזהות הפניות לתוויות מטא-נתונים שהוצאו משימוש: metadata_label_detection.py.

סיכום התחביר: python3 metadata_label_detection.py PROJECT_ID_OR_NUMBER

‫PROJECT_ID_OR_NUMBER יכול להיות מזהה פרויקט (לדוגמה, my-project) או מספר פרויקט (לדוגמה, 123456789). אל תכללו את הקידומת projects/.

כך משתמשים בסקריפט:

נכנסים למסוף Google Cloud .

כניסה למסוף Google Cloud
לוחצים על Activate Cloud Shell (הפעלת Cloud Shell) בחלק העליון של דף המסוף Google Cloud של הפרויקט.
בסרגל הכלים של Cloud Shell, לוחצים על Open Editor. אם סביבת העבודה של ספריית הבית שלכם לא פתוחה, פותחים אותה על ידי בחירה באפשרות קובץ ואז באפשרות פתיחת סביבת עבודה. בוחרים את סביבת העבודה עם שם המשתמש.
יוצרים קובץ חדש בשם metadata_label_detection.py על ידי בחירה באפשרות קובץ ואז באפשרות קובץ חדש. מדביקים את הטקסט של metadata_label_detection.py בעורך. שומרים את הקובץ על ידי בחירה באפשרות קובץ ואז באפשרות שמירה.
כדי לחזור לטרמינל, לוחצים על Open Terminal בסרגל הכלים של Cloud Shell.
בשורת הפקודה ב-Cloud Shell, מריצים את הפקודה הבאה כדי להתקין את יחסי התלות של הסקריפט:
```
sudo pip3 install google-cloud-monitoring=="1.*" google-cloud-monitoring-dashboards
```
אחרי שמתקינים את יחסי התלות, מריצים את סקריפט הגלאי:
```
python3 metadata_label_detection.py $GOOGLE_CLOUD_PROJECT
```

הסקריפט יוצר דוח כמו הקטע הבא:

‫

Alert "Test alert" (projects/PROJECT_ID/alertPolicies/8401129027900817186) is affected.
URL: https://console.cloud.google.com/monitoring/alerting/policies/8401129027900817186?project=PROJECT_ID
        metadata.system_labels.cloud_account is deprecated for non-AWS resource
types. Please manually remove the reference.

Group "Test group" (projects/PROJECT_ID/groups/4518177785663978371) might be affected,
depending on the type of resources it is used for.
URL: https://console.cloud.google.com/monitoring/groups/4518177785663978371?project=PROJECT_ID
        metadata.system_labels.name is deprecated for dataflow_job. Please
manually remove the reference if this group is used for dataflow_job resources.
        metadata.system_labels.name is deprecated for cloud_tasks_queue. Please
manually remove the reference if this group is used for cloud_tasks_queue resources.

Xy_chart "Test chart" in dashboard "Demo dashboard" (projects/PROJECT_ID/dashboards/2826428163455705326) is affected.
URL: https://console.cloud.google.com/monitoring/dashboards/custom/2826428163455705326?project=PROJECT_ID
        metadata.user_labels.name is deprecated for gce_instance. Please
manually remove the reference.

עדכון המסננים

כדי לעדכן את מדיניות ההתראות, התרשימים, כרטיסי הניקוד וקבוצות המשאבים:

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

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

חשוב לזכור שבמסננים משתמשים בתחילית resource.metadata במקום בתחילית metadata.system_labels.

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

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

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

מידע נוסף

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

תוויות: תוויות של מטא-נתונים של משאבים
מסננים: מסננים למעקב
סוגים ספציפיים של משאבים במעקב: רשימת משאבים במעקב

עריכה

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

כללי מדיניות התראות: ניהול כללי מדיניות
מרכזי בקרה ותרשימים באמצעות Google Cloud המסוף: ניהול מרכזי בקרה
מרכזי בקרה באמצעות Monitoring API: עדכון מרכזי בקרה
קבוצות משאבים: עריכה של קבוצה