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

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

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

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

התכונה הזו נתמכת רק בפרויקטים של 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.

מסוף Google Cloud

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

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

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

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

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

חיפוש התראות ישנות יותר

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

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

סינון ההתראות

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

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

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

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

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

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

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

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

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

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

ניהול התראות

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

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

אישור התראות

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

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

בטבלה Alerts (התראות) בדף Alerting (התראות), לוחצים על See all alerts (הצגת כל ההתראות).
בדף Alerts (התראות), מאתרים את ההתראה שרוצים לאשר ומבצעים אחת מהפעולות הבאות:
- לוחצים על אפשרויות נוספות ואז בוחרים באפשרות אישור.
- פותחים את דף הפרטים של ההתראה ולוחצים על אישור ההתראה.

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

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

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

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

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

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

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

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

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

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

בטבלה Alerts (התראות) בדף Alerting (התראות), לוחצים על See all alerts (הצגת כל ההתראות).
בדף Alerts (התראות), מאתרים את ההתראה שרוצים לסגור ומבצעים אחת מהפעולות הבאות:
- לוחצים על הצגת פרטים נוספים ואז בוחרים באפשרות סגירת ההתראה.
- פותחים את הדף פרטי ההתראה של ההתראה הרלוונטית ואז לוחצים על סגירת ההתראה.

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

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

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

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

כדי ליצור ולנהל מדיניות התראות באמצעות 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