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

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

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

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

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

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

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

מסוף Google Cloud

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

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

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

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

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

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

בטבלה 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