התראות לגבי כללי מדיניות התראות שמבוססים על מדדים

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

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

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

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

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

• אפשר להציג התראות באמצעות Google Cloud CLI או Cloud Monitoring API: כלי להצגת התראות ב-Monitoring (roles/monitoring.alertViewer)
• צפייה בהתראות באמצעות מסוף Google Cloud :
  • כלי לצפייה באירועים ב-Cloud Monitoring Console (roles/monitoring.cloudConsoleIncidentViewer)
  • צפייה בחשבונות Stackdriver (roles/stackdriver.accounts.viewer)
• ניהול התראות באמצעות מסוף Google Cloud :
  • עריכת אירועים במסוף Cloud Monitoring (roles/monitoring.cloudConsoleIncidentEditor)
  • צפייה בחשבונות Stackdriver (roles/stackdriver.accounts.viewer)

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

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

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

הצגת ההתראות

כדי לראות את ההתראות בפרויקט, משתמשים במסוף Google Cloud , ב-ה-CLI של gcloud או ב-Monitoring API.

gcloud alpha monitoring alerts describe ALERT_NAME

gcloud alpha monitoring alerts describe ALERT_NAME

gcloud alpha monitoring alerts describe ALERT_NAME

{
  "name": "projects/my-project/alerts/my-alert-id1",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "close_time": "2025-06-13T10:11:36Z",
  "resource": {
    "type": "gce_instance",
    "labels": {
      "zone": "us-west1",
      "instance_id": "123456789",
      "project_id": "my-project"
    }
  },
  "metric": {
    "labels": {
      "instance_name": "my-instance1"
    },
    "type": "compute.googleapis.com/instance/cpu/usage_time"
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "my-policy"
  },
  "summaryText": "[ALERT] VM Instance - CPU usage on my-project my-instance1"
}

gcloud alpha monitoring alerts list

gcloud alpha monitoring alerts list

gcloud alpha monitoring alerts list

{
  "alerts": [
    {
      "name": "projects/my-project/alerts/my-alert-id1",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "close_time": "2025-06-13T10:11:36Z",
      "resource": {
        "type": "gce_instance",
        "labels": {
          "zone": "us-west1",
          "instance_id": "123456789",
          "project_id": "my-project"
        }
      },
      "metric": {
        "labels": {
          "instance_name": "my-instance1"
        },
        "type": "compute.googleapis.com/instance/cpu/usage_time"
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "my-policy"
      },
      "summaryText": "[ALERT] VM Instance - CPU usage on my-project my-instance1"
    }
  ]
}

GET https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts/ALERT_ID

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     "https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts/ALERT_ID"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts/ALERT_ID" | Select-Object -Expand Content

{
  "name": "projects/my-project/alerts/my-alert-id1",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "close_time": "2025-06-13T10:11:36Z",
  "resource": {
    "type": "gce_instance",
    "labels": {
      "zone": "us-west1",
      "instance_id": "123456789",
      "project_id": "my-project"
    }
  },
  "metric": {
    "labels": {
      "instance_name": "my-instance1"
    },
    "type": "compute.googleapis.com/instance/cpu/usage_time"
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "my-policy"
  },
  "summaryText": "[ALERT] VM Instance - CPU usage on my-project my-instance1"
}

GET https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: PROJECT_ID" \
     "https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts"

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_ID" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://monitoring.googleapis.com/v3/projects/PROJECT_ID/alerts" | Select-Object -Expand Content

{
  "alerts": [
    {
      "name": "projects/my-project/alerts/my-alert-id1",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "close_time": "2025-06-13T10:11:36Z",
      "resource": {
        "type": "gce_instance",
        "labels": {
          "zone": "us-west1",
          "instance_id": "123456789",
          "project_id": "my-project"
        }
      },
      "metric": {
        "labels": {
          "instance_name": "my-instance1"
        },
        "type": "compute.googleapis.com/instance/cpu/usage_time"
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "my-policy"
      },
      "summaryText": "[ALERT] VM Instance - CPU usage on my-project my-instance1"
    }
  ]
}

--data-urlencode "filter=(open_time>=\"`date -u -d "1 hour ago" +"%Y-%m-%dT%H:%M:%SZ"`\")"

--data-urlencode "filter=(open_time>=\"`date -u -d "1 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\" AND state=open)"

--data-urlencode "filter=(open_time>=\"`date -u -d "2 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\" AND open_time<=\"`date -u -d "1 DAY ago" +"%Y-%m-%dT%H:%M:%SZ"`\")"

--data-urlencode "filter=(policy.user_labels.app=\"my-gke-app\")"

$baseUrl = "https://monitoring.googleapis.com/v3/projects/my-project/alerts"
$filterValue = (Get-Date).AddHours(-1).ToString("yyyy-MM-ddTHH:mm:ssZ")
$filter = 'open_time >= "' + $filterValue + '"'
$encodedFilter = [System.Uri]::EscapeDataString($filter)
$url = $baseUrl + "?filter=" + $encodedFilter

חקירת התראה

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

עיון בנתוני המדדים

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

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

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

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

אפשר גם לנתח את נתוני המדדים בצורה מפורטת יותר באמצעות Metrics Explorer. כדי לעשות זאת, עוברים לתרשים Alert Metrics ולוחצים על query_stats Explore Data. כברירת מחדל, הכלי Metrics Explorer מצבר ומסנן את נתוני המדדים כדי שהתרשים של המדד יתאים לסדרת הזמנים שמוצגת בציר הזמן של מדדי ההתראות.

עיון ברשומות ביומן

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

• כדי להציג את רשומות היומן ב-Logs Explorer, לוחצים על View in Logs Explorer (הצגה ב-Logs Explorer) ובוחרים פרויקט להגדרת ההיקף. כלי Logs Explorer מספק כלים נוספים לניתוח נתוני רשומות ביומן, כמו ציר זמן שבו מוצג מתי נוצרו רשומות קשורות ביומן.
• כדי לראות ולערוך את השאילתה שמשמשת לסינון רשומות היומן ב-Metrics Explorer, לוחצים על query_stats Explore Data.

צפייה בפרטי הבקשה

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

הצגת מידע משלים

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

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

אם לא הגדרתם תיעוד למדיניות ההתראות, בחלונית תיעוד תוצג ההודעה 'לא הוגדר תיעוד'.

עיון בהתראות קשורות

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

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

ניהול התראות

התראות יכולות להיות באחד מהסטטוסים הבאים:

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

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

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

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

אישור התראות

מומלץ לסמן התראה כמאושרת כשמתחילים לבדוק את הסיבה להתראה.

כדי לסמן התראה כמאושרת:

1. בטבלה Alerts (התראות) בדף Alerting (התראות), לוחצים על See all alerts (הצגת כל ההתראות).

2. בדף Alerts (התראות), מאתרים את ההתראה שרוצים לאשר ומבצעים אחת מהפעולות הבאות:

   • לוחצים על more_vert אפשרויות נוספות ואז בוחרים באפשרות אישור.
   • פותחים את דף הפרטים של ההתראה ולוחצים על אישור ההתראה.

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

• יוצרים השהיה למדיניות ההתראות.
• משביתים את מדיניות ההתראות.

העברת מדיניות התראות למצב נודניק

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

כדי ליצור דחייה של התראה שמוצגת:

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

2. בוחרים את משך הדחייה. אחרי שבוחרים את משך הדחייה, הדחייה מתחילה מיד.

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

סגירת ההתראות

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

המערכת סוגרת אוטומטית התראה אם מתרחש אחד מהמקרים הבאים:

• תנאים להערכת ערכי סף של מדדים:

  • התקבלה תצפית שמציינת שלא חל חריגה מהסף.

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

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

• תנאים של היעדר מדדים:

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

• תנאי התחזית:

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

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

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

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

כדי לסגור התראה:

1. בטבלה Alerts (התראות) בדף Alerting (התראות), לוחצים על See all alerts (הצגת כל ההתראות).

2. בדף Alerts (התראות), מאתרים את ההתראה שרוצים לסגור ומבצעים אחת מהפעולות הבאות:

   • לוחצים על more_vert הצגת פרטים נוספים ואז בוחרים באפשרות סגירת ההתראה.
   • פותחים את הדף פרטי ההתראה של ההתראה הרלוונטית ואז לוחצים על סגירת ההתראה.

אם מופיעה ההודעה Unable to close alert with active conditions, אי אפשר לסגור את ההתראה כי התקבלו נתונים במהלך תקופת ההתראה האחרונה.

אם מופיעה ההודעה Unable to close alert. Please try again in a few minutes., המשמעות היא שלא ניתן לסגור את ההתראה בגלל שגיאה פנימית.

שמירת נתונים ומגבלות

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

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

• כדי ליצור ולנהל מדיניות התראות באמצעות Monitoring API או משורת הפקודה, אפשר לעיין במאמר ניהול מדיניות התראות באמצעות API.

• במאמר בנושא התנהגות של מדיניות התראות שמבוססת על מדדים מוסבר בהרחבה על מדיניות התראות.