‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

ניהול אירועים עבור מדיניות התראות מבוססת-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 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 , ב-CLI של gcloud (גרסת Preview ציבורית) או ב-Monitoring API (גרסת Preview ציבורית).

מסוף Google Cloud

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

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

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

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

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

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

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

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

סינון תקריות

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

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

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

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 יכולים להשתמש בדוגמה הבאה כדי להוסיף מסנן מבוסס-זמן לכתובת האתר של הבקשה:

$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 מוצגת רשימה של סיכומי תוצאות השאילתה מכל פעם ש-Observability Analytics הפעיל את שאילתת ה-SQL מהתנאי של מדיניות ההתראות. כברירת מחדל, הרשימה מסוננת כך שיוצגו רק שאילתות שתואמות לתנאי של מדיניות ההתראות.

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

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

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

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

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

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

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

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

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

אישור תקריות

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

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

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

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

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

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

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

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

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

אתם יכולים לאפשר ל-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