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

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

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

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

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

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

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

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

הצגת ההתראות

כדי לראות את ההתראות בפרויקט, משתמשים במסוף Google Cloud , ב-gcloud CLI או ב-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-id",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "resource": {
    "type": "k8s_cluster",
    "labels": {
      "location": "us-central1",
      "cluster_name": "example_cluster",
      "project_id": "my-project"
    }
  },
  "log": {
    "extracted_labels": {
      "title": "my title"
    }
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "test-policy"
  },
  "summaryText": "[ALERT] test-policy for Kubernetes Cluster with {cluster_name=example_cluster, location=us-central1, project_id=my-project}"
}

gcloud alpha monitoring alerts list

gcloud alpha monitoring alerts list

gcloud alpha monitoring alerts list

{
  "alerts": [
    {
      "name": "projects/my-project/alerts/my-alert-id",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "resource": {
        "type": "k8s_cluster",
        "labels": {
          "location": "us-central1",
          "cluster_name": "example_cluster",
          "project_id": "my-project"
        }
      },
      "log": {
        "extracted_labels": {
          "title": "my title"
        }
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "test-policy"
      },
      "summaryText": "[ALERT] test-policy for Kubernetes Cluster with {cluster_name=example_cluster, location=us-central1, project_id=my-project}"
    }
  ]
}

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-id",
  "state": "OPEN",
  "open_time": "2025-06-11T09:53:46Z",
  "resource": {
    "type": "k8s_cluster",
    "labels": {
      "location": "us-central1",
      "cluster_name": "example_cluster",
      "project_id": "my-project"
    }
  },
  "log": {
    "extracted_labels": {
      "title": "my title"
    }
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "test-policy"
  },
  "summaryText": "[ALERT] test-policy for Kubernetes Cluster with {cluster_name=example_cluster, location=us-central1, project_id=my-project}"
}

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-id",
      "state": "OPEN",
      "open_time": "2025-06-11T09:53:46Z",
      "resource": {
        "type": "k8s_cluster",
        "labels": {
          "location": "us-central1",
          "cluster_name": "example_cluster",
          "project_id": "my-project"
        }
      },
      "log": {
        "extracted_labels": {
          "title": "my title"
        }
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "test-policy"
      },
      "summaryText": "[ALERT] test-policy for Kubernetes Cluster with {cluster_name=example_cluster, location=us-central1, project_id=my-project}"
    }
  ]
}

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

חקירת התראה

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

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

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

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

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

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

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

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

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

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

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

ניהול התראות

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

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

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

• check_circle נסגר: התראה שנסגרה באופן ידני או באופן אוטומטי אחרי שתקופת הסגירה האוטומטית הסתיימה.

אישור התראות

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

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

1. בטבלה Alerts בדף Alerting, לוחצים על See all alerts.

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

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

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

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

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

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

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

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

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

אתם יכולים לאפשר לשירות Monitoring לסגור את ההתראה בשבילכם, או לסגור אותה בעצמכם.

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

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

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

1. בטבלה Alerts בדף Alerting, לוחצים על See all alerts.

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

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

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

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

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

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

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