אירועים שקשורים למדיניות התראות מבוססת-SQL

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

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

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

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

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

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

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

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

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

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

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

צפייה באירועים

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

מסוף Google Cloud

כדי להציג את רשימת האירועים ב Google Cloud פרויקט:

נכנסים לדף Alerting במסוף Google Cloud :
עוברים אל התראות

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

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

ייפתח הדף פרטי האירוע. מידע נוסף על הדף פרטי האירוע מופיע בקטע חקירת אירוע במסמך הזה.

חיפוש אירועים ישנים יותר

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

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

סינון תקריות

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

כדי לסנן את טבלת האירועים:

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

gcloud

אפשר להשתמש ב-gcloud כדי לקבל תקריות ולרשום תקריות.

קבלת אירוע

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

‫ALERT_NAME: שם המשאב של ההתראה. לדוגמה, projects/my-project/alerts/my-alert-id.

מריצים את הפקודה gcloud alpha monitoring alerts describe:

‫Linux,‏ macOS או Cloud Shell

gcloud alpha monitoring alerts describe ALERT_NAME

‏Windows (PowerShell)

gcloud alpha monitoring alerts describe ALERT_NAME

Windows‏ (cmd.exe)

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": "sql_alert"
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "test-policy"
  },
  "summaryText": "The row count SQL Condition for \"test-policy\" is above the threshold of 1."
}

הצגת רשימת אירועים

אפשר להציג רשימה של אירועים בפרויקט ולסנן את התוצאות באמצעות ה-CLI של gcloud.

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

‫PROJECT_ID: מזהה הפרויקט.

מריצים את הפקודה gcloud alpha monitoring alerts list:

‫Linux,‏ macOS או Cloud Shell

gcloud alpha monitoring alerts list

‏Windows (PowerShell)

gcloud alpha monitoring alerts list

Windows‏ (cmd.exe)

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": "sql_alert"
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "test-policy"
      },
      "summaryText": "The row count SQL Condition for \"test-policy\" is above the threshold of 1."
    }
  ]
}

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

‫--filter: הזנת ביטוי סינון כדי לסנן התראות לפי זמן או לפי תווית. לדוגמה, אפשר לסנן לפי זמן באמצעות --filter='close_time>="2025-09-10T00:00:00Z"' או לפי תווית באמצעות --filter='resource.labels.key="value"'.
‫--sort-by: רשימה מופרדת בפסיקים של שדות שלפיהם הפלט ימוין. לדוגמה, --sort-by=open_time.
‫--uri: הפקודה מוציאה רשימה של מזהי URI של משאבים במקום פלט ברירת המחדל.
‫--limit: מגדירים את הדגל הזה לערך 2 או לערך גבוה יותר כדי להגביל את מספר ההתראות שמוחזרות. אל תשתמשו בדגל הזה יחד עם הדגל --filter.

Monitoring API

אפשר להשתמש ב-Monitoring API כדי לקבל אירועים ולרשום אירועים.

קבלת אירוע

כדי לקבל פרטים על אירוע יחיד באמצעות Monitoring API, משתמשים בשיטה alerts.get.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט.
‫ALERT_ID: מזהה ההתראה.

ה-method של ה-HTTP וכתובת ה-URL:

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

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‏Curl (Linux,‏ macOS או Cloud Shell)

מריצים את הפקודה הבאה:

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"

‎PowerShell (Windows)

מריצים את הפקודה הבאה:

$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": "sql_alert"
  },
  "policy": {
    "name": "projects/my-project/alertPolicies/POLICY_1",
    "displayName": "test-policy"
  },
  "summaryText": "The row count SQL Condition for \"test-policy\" is above the threshold of 1."
}

הצגת רשימת אירועים

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

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

‫PROJECT_ID: מזהה הפרויקט.

ה-method של ה-HTTP וכתובת ה-URL:

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

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‏Curl (Linux,‏ macOS או Cloud Shell)

מריצים את הפקודה הבאה:

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"

‎PowerShell (Windows)

מריצים את הפקודה הבאה:

$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": "sql_alert"
      },
      "policy": {
        "name": "projects/my-project/alertPolicies/POLICY_1",
        "displayName": "test-policy"
      },
      "summaryText": "The row count SQL Condition for \"test-policy\" is above the threshold of 1."
    }
  ]
}

משתמשי Curl יכולים להוסיף את הדגל --data-urlencode ואחריו ביטוי מסנן כדי לסנן התראות לפי זמן או לפי תווית. דוגמאות:

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

--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"`\")"

הצגה וסינון של התראות לפי תווית משתמש. בדוגמה הזו, מסננים לפי תווית משתמש עם השם app והערך my-gke-app:

‫

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

משתמשי Powershell יכולים להשתמש בדוגמה הבאה כדי להוסיף מסנן מבוסס-זמן לכתובת ה-URL של הבקשה:

$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

חקירת תקרית

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

בדיקת תוצאות של שאילתות

בחלונית Total slot time consumed per day מוצג משך הזמן שבו משבצות BigQuery שהוזמנו הקדישו להרצת שאילתות SQL עבור מדיניות ההתראות ב-24 השעות האחרונות.

בחלונית SQL query results מוצגת רשימה של סיכומי תוצאות השאילתה מכל פעם שהכלי Log Analytics הפעיל את שאילתת ה-SQL מהתנאי של מדיניות ההתראות. כברירת מחדל, הרשימה מסוננת כך שיוצגו רק שאילתות שתואמות לתנאי של מדיניות ההתראות.

כדי לראות את השאילתה ואת טבלת התוצאות של השאילתה מזמן ספציפי שבו Log Analytics הריץ את השאילתה, לוחצים על ערך מהעמודה Query run time (זמן הרצת השאילתה).
כדי לעבור בין הצגת תוצאות של שאילתות שתואמות לתנאי מדיניות ההתראות לבין הצגת כל השאילתות שהופעלו על ידי Log Analytics ממדיניות ההתראות, לוחצים על הצגת שאילתות שתואמות לתנאי ההתראה בלבד.

הצגת מידע נוסף

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

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

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

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

ניהול אירועים

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

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

אישור תקריות

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

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

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

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

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

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

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

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

סגירת אירועים

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

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

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

כדי לסגור אירוע:

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

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

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

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

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

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

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

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

צפייה באירועים

מסוף Google Cloud

חיפוש אירועים ישנים יותר

סינון תקריות

gcloud

קבלת אירוע

‫Linux,‏ macOS או Cloud Shell

‏Windows (PowerShell)

Windows‏ (cmd.exe)

הצגת רשימת אירועים

‫Linux,‏ macOS או Cloud Shell

‏Windows (PowerShell)

Windows‏ (cmd.exe)

Monitoring API

קבלת אירוע

‏Curl (Linux,‏ macOS או Cloud Shell)

‎PowerShell (Windows)

הצגת רשימת אירועים

‏Curl (Linux,‏ macOS או Cloud Shell)

‎PowerShell (Windows)

חקירת תקרית

בדיקת תוצאות של שאילתות

הצגת מידע נוסף

עיון באירועים קשורים

ניהול אירועים

אישור תקריות

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

סגירת אירועים

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

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

אירועים שקשורים למדיניות התראות מבוססת-SQL