יצירת כללי מדיניות להתראות על סף מדד

מדיניות התראות לפי סף של מדדים ב-Cloud Monitoring שולחת התראות כשערכי המדדים חוצים את הסף שהגדרתם לחלון בדיקה חוזרת מסוים. לדוגמה, אפשר להגדיר מדיניות התראות שתיצור התראה כשניצול המעבד (CPU) חורג מ-80% למשך חמש דקות לפחות.

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

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

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

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

  1. כדי לקבל את ההרשאות שנדרשות ליצירה ולשינוי של מדיניות התראות באמצעות מסוף Google Cloud , צריך לבקש מהאדמין להקצות לכם את התפקיד עריכת מעקב (roles/monitoring.editor) ב-IAM בפרויקט. להסבר על מתן תפקידים, קראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

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

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

  3. מגדירים את ערוצי ההתראות שבהם רוצים להשתמש כדי לקבל התראות. למטרות יתירות, מומלץ ליצור כמה סוגים של ערוצי התראות. למידע נוסף, קראו את המאמר יצירה וניהול של ערוצי התראות.

יצירת מדיניות התראות

כדי ליצור מדיניות התראות שמשווה את הערך של המדד הזה לסף סטטי:

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

    נכנסים לדף Alerting.

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

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

  4. בוחרים את סדרת הזמנים למעקב:

    1. לוחצים על Select a metric, מנווטים בתפריטים כדי לבחור סוג משאב וסוג מדד, ואז לוחצים על Apply.

      התפריט Select a metric מכיל תכונות שעוזרות למצוא את סוגי המדדים הזמינים:

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

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

    2. אופציונלי: כדי לעקוב אחרי קבוצת משנה של סדרות הזמן שתואמות לסוגי המדדים והמשאבים שבחרתם בשלב הקודם, לוחצים על Add filter. בתיבת הדו-שיח של המסנן, בוחרים את התווית שלפיה רוצים לסנן, את ההשוואה ואת ערך המסנן. לדוגמה, המסנן zone =~ ^us.*.a$ משתמש בביטוי רגולרי כדי להתאים את כל הנתונים של סדרות זמנים ששם האזור שלהן מתחיל ב-us ומסתיים ב-a. למידע נוסף, קראו את המאמר סינון של סדרת הזמנים שנבחרה.

    3. אופציונלי: כדי לשנות את אופן היישור של הנקודות בסדרה של זמנים, בקטע Transform data מגדירים את השדות Rolling window ו-Rolling window function. לדוגמה, חלון של 15 דקות עם max מפיק את הערך המקסימלי מ-15 הדקות האחרונות.

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

      אם בוחרים באפשרות count או mean בשדה פונקציית חלון זמן דינמי, צריך לוודא שהפונקציה תואמת לסוג המדד. הפונקציה count סופרת נקודות על הגרף, לא את הערכים שלהן, והפונקציה mean מחשבת את הממוצע של השינויים בכל דגימה במדדי DELTA. כדי לקבל התראה על הנפח הכולל או על הקצב של מדד DELTA, צריך לבחור במקום זאת באפשרות sum,‏ delta או rate. במאמר Aligner מפורטים סוגי המדדים וסוגי הערכים הנתמכים.

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

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

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

      כדי לשלב את כל סדרות הזמנים:

      1. בקטע Across time series, לוחצים על Expand.
      2. מגדירים את השדה Time series aggregation לערך שהוא לא none. לדוגמה, כדי להציג את הערך הממוצע של סדרת הזמנים, בוחרים באפשרות mean.
      3. מוודאים שהשדה Time series group by ריק.

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

      1. בקטע Across time series, לוחצים על Expand.
      2. מגדירים את השדה Time series aggregation לערך שהוא לא none.
      3. בשדה סדרת זמנים לקיבוץ לפי, בוחרים את התוויות שלפיהן רוצים לקבץ.

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

    5. לוחצים על הבא.

  5. מגדירים את הטריגר של התנאי:

    1. משאירים את ערך ברירת המחדל Threshold בשדה Condition type.

    2. אופציונלי: מעדכנים את התפריט Alert trigger, שכולל את הערכים הבאים:

      • ‫Any time series violates: הגדרת ברירת המחדל. כל סדרת זמן שחורגת מהסף למשך כל חלון הבדיקה החוזרת גורמת לעמידה בתנאי.

      • ‫Percent of time series violates: אחוז מסוים מסדרת הזמן צריך לחרוג מהסף במשך כל חלון הבדיקה החוזרת כדי שהתנאי יתקיים. לדוגמה, אתם יכולים לקבל התראה כש-50% מסדרות הזמן שבמעקב חורגות מהסף במשך כל חלון הבדיקה החוזרת.

      • Number of time series violates: מספר ספציפי של סדרות זמן שצריכות לחרוג מהסף בכל חלון הבדיקה החוזרת כדי שהתנאי יתקיים. לדוגמה, אתם יכולים לקבל התראה כש-32 מסדרות הזמן שבמעקב חורגות מהסף במשך כל חלון הבדיקה החוזרת.

      • ‫All time series violate: כל הסדרות העיתיות צריכות לחרוג מהסף במשך כל חלון הבדיקה החוזרת כדי שהתנאי יתקיים.

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

    3. בשדות Threshold position ו-Threshold value, מציינים מתי ערך המדד חורג מהסף. לדוגמה, אם מגדירים את הערכים האלה ל-Above threshold ול-0.3, כל מדידה שגבוהה מ-0.3 חורגת מהסף.

    4. אופציונלי: כדי לבחור כמה זמן המדידות צריכות לחרוג מהסף לפני שתישלח התראה מ-Monitoring, מרחיבים את Advanced options ומשתמשים בתפריט Retest window.

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

    5. אופציונלי: כדי לציין איך המערכת תעריך את התנאי כשנתונים יפסיקו להגיע, מרחיבים את Advanced options ומשתמשים בתפריט Evaluation missing data.

      התפריט Evaluation missing data מושבת כשהערך של Retest window הוא No retest.

      Google Cloud מסוף
      השדה "הערכה של נתונים חסרים"      		 סיכום פרטים
      נתונים חסרים התראות פתוחות נשארות פתוחות.
      התראות של חדשות Google חדשות לא נפתחות.

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

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

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

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

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

      אם התנאים לא מתקיימים, הם ימשיכו לא להתקיים גם כשהנתונים יפסיקו להגיע.

    6. לוחצים על הבא.

  6. אופציונלי: יצירת מדיניות התראות עם כמה תנאים.

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

    כדי ליצור מדיניות התראות עם כמה תנאים:

    1. כדי להוסיף עוד תנאים, לוחצים על Add alert condition ומגדירים את התנאי.
    2. לוחצים על הבא ומגדירים איך התנאים ישולבו.
    3. לוחצים על Next כדי לעבור להגדרת ההתראות והתיעוד.

  7. מגדירים את ההתראה ומוסיפים תוויות משתמש:

    1. מרחיבים את התפריט Notifications and name ובוחרים את ערוצי ההתראות. למטרות יתירות, מומלץ להוסיף למדיניות ההתראות כמה סוגים של ערוצי התראות. מידע נוסף זמין במאמר ניהול ערוצי התראות.

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

    3. אופציונלי: כדי לקבל התראה כשההתראה נסגרת, בוחרים באפשרות Notify on alert closure. כברירת מחדל, כשיוצרים מדיניות התראות באמצעות מסוף Google Cloud , נשלחת התראה רק כשנוצרת התראה.

    4. אופציונלי: כדי לשנות את משך הזמן ש-Monitoring ממתין לפני סגירת ההתראה אחרי שהנתונים מפסיקים להגיע, בוחרים אפשרות מהתפריט Alert autoclose duration. כברירת מחדל, כשנתונים מפסיקים להגיע, מערכת Monitoring ממתינה שבעה ימים לפני שהיא סוגרת התראה פתוחה.

    5. אופציונלי: כדי לשייך את מדיניות ההתראה לאפליקציה ב-App Hub, בקטע Application labels בוחרים אפליקציה ושירות או עומס עבודה. התוויות האלה מוצגות בהתראות ובהודעות.

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

    7. אופציונלי: כדי להוסיף תוויות בהתאמה אישית למדיניות ההתראות, בקטע Policy user labels:

      1. לוחצים על Add label, ובשדה Key מזינים שם לתווית. שמות של תוויות צריכים להתחיל באות קטנה, והם יכולים להכיל אותיות קטנות, ספרות, קווים תחתונים ומקפים. לדוגמה, מזינים severity.
      2. לוחצים על Value ומזינים ערך בשביל התווית. ערכי התוויות יכולים להכיל אותיות קטנות, ספרות, קווים תחתונים ומקפים. לדוגמה, מזינים critical.

      במאמר הוספת תוויות להתראות מוסבר איך משתמשים בתוויות מדיניות כדי לנהל את ההתראות.

  8. אופציונלי: בקטע Documentation, מזינים את התוכן שרוצים לכלול בהתראה.

    כדי לעצב את התיעוד, אתם יכולים להשתמש בטקסט פשוט, ב-Markdown ובמשתנים. אפשר גם להוסיף קישורים שיעזרו למשתמשים לנפות באגים בהתראה, כמו קישורים למדריכים פנימיים, ללוחות בקרה ב- Google Cloud ולדפים חיצוניים. לדוגמה, תבנית התיעוד הבאה מתארת התראה על ניצול מעבד (CPU) במשאב gce_instance, וכוללת כמה משתנים שמפנים למדיניות ההתראה ולמשאבי ה-REST של התנאי. תבנית התיעוד מפנה את הקוראים לדפים חיצוניים כדי לעזור בניפוי באגים.

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

    תצוגה מקדימה

    ## CPU utilization exceeded

### Summary

The ${metric.display_name} of the ${resource.type}
${resource.label.instance_id} in the project ${resource.project} has
exceeded 90% for over 15 minutes.

### Additional resource information

Condition resource name: ${condition.name}  
Alerting policy resource name: ${policy.name}  

### Troubleshooting and Debug References

Repository with debug scripts: example.com  
Internal troubleshooting guide: example.com  
${resource.type} dashboard: example.com

    פורמט בהתראה

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

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

  9. לוחצים על Alert name ומזינים שם למדיניות ההתראות.

  10. לוחצים על Create policy.

סינון של סדרת הזמנים שנבחרה

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

מסנן מורכב מתווית, מאופרטור השוואה ומערך. לדוגמה, כדי להתאים את כל סדרות הזמנים שהתווית zone שלהן מתחילה ב-"us-central1", אפשר להשתמש במסנן zone=~"us-central1.*", שמשתמש בביטוי רגולרי כדי לבצע את ההשוואה.

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

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

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

אופרטורמשמעותדוגמה
= שוויון resource.labels.zone = "us-central1-a"
!= אי שוויון resource.labels.zone != "us-central1-a"
=~ שוויון של ביטוי רגולרי2 monitoring.regex.full_match("^us.*")
!=~ אי-שוויון של ביטוי רגולרי2 monitoring.regex.full_match("^us.*")
starts_with הערך מתחיל ב- resource.labels.zone = starts_with("us")
ends_with הערך מסתיים ב: resource.labels.zone = ends_with("b")
has_substring הערך מכיל resource.labels.zone = has_substring("east")
one_of אחת resource.labels.zone = one_of("asia-east1-b", "europe-north1-a")
!starts_with הערך לא מתחיל ב- resource.labels.zone != starts_with("us")
!ends_with הערך לא מסתיים ב- resource.labels.zone != ends_with("b")
!has_substring הערך לא מכיל resource.labels.zone != has_substring("east")
!one_of הערך לא נכלל ברשימה resource.labels.zone != one_of("asia-east1-b", "europe-north1-a")

פתרון בעיות

בקטע הזה מפורטים טיפים לפתרון בעיות.

המדד לא מופיע בתפריט של המדדים הזמינים

כדי לעקוב אחרי מדד שלא מופיע בתפריט Select a metric, מבצעים אחת מהפעולות הבאות:

  • כדי ליצור מדיניות התראה שעוקבת אחרי מדד של Google Cloud , מרחיבים את התפריט Select a metric ולוחצים על ‎ Active‎. כשהאפשרות מושבתת, בתפריט מופיעים כל המדדים של שירותיGoogle Cloud וכל המדדים עם נתונים.

  • כדי להגדיר תנאי לסוג מדד מותאם אישית לפני שסוג המדד הזה יוצר נתונים, צריך לציין את סוג המדד באמצעות מסנן Monitoring:

    1. בחירה באפשרות ? בכותרת הקטע Select metric, ואז בוחרים באפשרות Direct filter mode בהסבר הקצר.

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

מעקב אחרי קצב השינוי

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

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

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

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