הגדרה וניהול של התראות

אתם יכולים להגדיר את Error Reporting כך שישלח התראות לערוצי ההתראות שנבחרו ב-Cloud Monitoring כשמתרחשים אירועי שגיאה.

Error Reporting שולח התראות במקרים הבאים:

• כשאירוע שגיאה מתרחש ב Google Cloud פרויקט ואי אפשר לקבץ את האירוע הזה עם שגיאות קודמות.

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

ניהול ערוצי התראות

אתם יוצרים, עורכים ומוחקים ערוצי התראות ב-Monitoring. אחרי שיוצרים ערוצי התראות, אפשר להגדיר את Error Reporting כך שישתמש בהם.

ב-Error Reporting אפשר לבחור מבין ארבעה סוגים של ערוצי התראות: אימייל, נייד, Slack ו-Webhooks.

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

כדי לקבל את ההרשאות שנדרשות להצגה ולהגדרה של ערוצי התראות באמצעות מסוף Google Cloud , צריך לבקש מהאדמין להקצות לכם את תפקיד ה-IAM‏ Monitoring Editor (roles/monitoring.editor) בפרויקט. להסבר על מתן תפקידים, קראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

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

יצירת ערוץ התראות

כדי ליצור ערוץ התראות באמצעות Google Cloud המסוף, פועלים לפי ההוראות הספציפיות לערוץ שמופיעות בטבלה הבאה:

אימייל

כדי להוסיף ערוץ התראות באימייל:

1. נכנסים לדף  Alerting במסוף Google Cloud :

   כניסה אל התראות

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

2. בסרגל הכלים של מסוף Google Cloud , בוחרים את Google Cloud הפרויקט. בהגדרות של מרכז האפליקציות, בוחרים את הפרויקט המארח או את פרויקט הניהול של מרכז האפליקציות.
3. לוחצים על עריכת ערוצי התראות.
4. בקטע אימייל, לוחצים על הוספת חדש.
5. מזינים כתובת אימייל אחת ותיאור.
6. לוחצים על Save.

אם משתמשים בכתובת אימייל קבוצתית כערוץ התראות למדיניות התראות, צריך להגדיר את הקבוצה כך שתקבל אימייל מכתובת [e-mail].

אפליקציה לנייד

אתם יכולים להשתמש באפליקצייתGoogle Cloud console לנייד כדי לעקוב אחרי משאבי Google Cloud console ופרטי המעקב מכל מקום.ההתראות מאפליקציית Google Cloud console לנייד נשלחות למכשיר ספציפי או למשתמש ספציפי:

• מכשיר מציין שההתראות נשלחות רק למכשיר הספציפי שבו נוצר ערוץ ההתראות.  בערוצי התראות בהיקף המכשיר, השדה שם לתצוגה כולל את פרטי המכשיר.
• משתמש מציין שההתראות נשלחות לכל המכשירים שמותקנת בהם אפליקציית Google Admin. Google Cloud

היקף ההתראות נקבע ב-Cloud Monitoring כשיוצרים את הערוץ. אי אפשר לבחור את ההיקף או לשנות אותו.

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

1. מתקינים את אפליקציית Google Cloud מסוף הניהול בנייד מחנות האפליקציות במכשיר הנייד.

2. בוחרים פרויקט לצפייה באפליקציה לנייד של מסוף Google Cloud .

   אחרי שבוחרים פרויקט, מתבצעת החלפת נתונים בין האפליקציה לבין הפרויקט שנבחר. Google Cloud אם לא קיים ערוץ התראות, הוא נוצר, וכעבור כמה דקות הוא מופיע בקטע מכשירים ניידים בדף ערוצי התראות.

כדי להוסיף את המכשיר הנייד שלכם כערוץ התראות למדיניות התראות, בקטע התראות של ההתראות, בוחרים באפשרות Google Cloud console (נייד) ואז בוחרים את המכשיר הנייד מהרשימה.

Slack

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

כדי להגדיר התראות ב-Slack:

1. ב-Slack: יוצרים סביבת עבודה וערוץ ב-Slack באתר של Slack. רושמים את כתובת ה-URL של הערוץ.

2. נכנסים לדף  Alerting במסוף Google Cloud :

   כניסה אל התראות

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

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

4. לוחצים על עריכת ערוצי התראות.

5. בקטע Slack, לוחצים על Add new (הוספת חדש) כדי לפתוח את דף הכניסה של Slack:

   1. בוחרים את סביבת העבודה ב-Slack.
   2. לוחצים על Allow (אישור) כדי לאפשר ל-Cloud Monitoring גישה לסביבת העבודה שלכם ב-Slack. הפעולה הזו תחזיר אתכם לדף ההגדרה של המעקב אחרי ערוץ ההתראות.
   3. בשדה שם ערוץ Slack, מזינים את השם של ערוץ Slack שבו רוצים להשתמש לקבלת התראות.
   4. בשדה Cloud Alerting Display Name, מזינים הצהרה תיאורית קצרה. הערך של השדה הזה מוצג בדף Notifications channel ב'מעקב'.
   5. (אופציונלי) כדי לבדוק את החיבור בין Cloud Monitoring לבין מרחב העבודה שלכם ב-Slack, לוחצים על שליחת התראה לבדיקה. אם החיבור יצליח, תופיע הודעה This is a test alert notification... בערוץ ההתראות ב-Slack שציינתם. כדי לוודא שההודעה התקבלה, בודקים את ערוץ ההתראות.

6. אם ערוץ Slack שבו רוצים להשתמש לקבלת התראות הוא ערוץ פרטי, צריך להזמין את אפליקציית Monitoring לערוץ באופן ידני:

   1. פותחים את Slack.

   2. עוברים לערוץ שציינתם כערוץ ההתראות למעקב.

   3. מזמינים את אפליקציית המעקב לערוץ על ידי הזנת ההודעה הבאה ושליחתה בערוץ:

      /invite @Google Cloud Monitoring

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

תגובות לפעולה מאתר אחר (webhook)

לפני שמגדירים ערוץ התראות מסוג Webhook, כדאי להביא בחשבון את הנקודות הבאות:

• ב-Webhooks יש תמיכה רק בנקודות קצה ציבוריות. נקודת קצה ציבורית נגישה באופן מלא מהאינטרנט הציבורי, למשל דרך HTTP ‏ (port:80) או HTTPS ‏ (port:443). שירות ההתראות צריך להיות מסוגל ליצור חיבור לנקודת הקצה, ובמקרה של HTTPS, לאמת את אישור האבטחה של השרת.
• אם פונקציית Cloud Run מוגדרת כנקודת קצה של webhook לערוץ התראות, צריך לוודא שלמשתמש שמפעיל את הפונקציה יש את הרשאת האימות הנדרשת. מידע נוסף זמין במאמרים אימות להפעלה והפעלת גישה לפונקציה.
• כדי לשלוח נתוני התראות מ-Monitoring ל-Microsoft Teams, צריך להשתמש בשירות ביניים כמו Power Automate או פונקציות Cloud Run. מגדירים את השירות כך שיקבל את ההתראה של ה-webhook של המעקב, ימיר את הנתונים לפורמט שתואם ל-Teams ויעביר את הנתונים לערוץ המתאים ב-Microsoft Teams.

הגדרת ערוצי התראות של Webhook

כדי להגדיר התראות של Webhooks:

1. ה-handler של ה-webhook: מזהים את כתובת ה-URL של נקודת הקצה הציבורית לקבלת נתוני webhook מ-Monitoring.

2. נכנסים לדף  Alerting במסוף Google Cloud :

   כניסה אל התראות

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

3. בסרגל הכלים של מסוף Google Cloud , בוחרים את Google Cloud הפרויקט. בהגדרות של מרכז האפליקציות, בוחרים את הפרויקט המארח או את פרויקט הניהול של מרכז האפליקציות.
4. לוחצים על עריכת ערוצי התראות.
5. בקטע Webhook, לוחצים על Add new (הוספת חדש).
6. משלימים את תיבת הדו-שיח.
7. לוחצים על בדיקת החיבור כדי לשלוח מטען ייעודי למטרה לבדיקה לנקודת הקצה של ה-Webhook. אפשר לעבור לנקודת הקצה המקבלת כדי לאמת את המסירה.
8. לוחצים על Save.

סכימת webhook

כדי לראות את מבנה סכמת ה-Webhook של Error Reporting, לוחצים על הקישור הבא:

מבנה הסכימה, גרסה 1.0

‫{
  "version": "1.0",
‫  "subject": מחרוזת, תיאור של קבוצת השגיאות החדשה או שנפתחה מחדש.
  "group_info": {
    "project_id": מחרוזת, הפרויקט שבבעלותו קבוצת השגיאות.
    "detail_link": מחרוזת, קישור לדף Error Reporting Details של קבוצת השגיאות.
  },
  "exception_info": {
    "type": מחרוזת, סוג החריגה שנרשמה ביומן האירועים.
    "message": מחרוזת, הודעת חריגה לגבי האירוע.
  },
  "event_info": {
    "log_message": string
    "request_method": string
    "request_url": string
    "referrer": string
    "user_agent": string
    "service": string
    "version": string
    "response_status": string
  },
}

אימות בסיסי

בנוסף לבקשת ה-Webhook שנשלחת על ידי Cloud Monitoring, האימות הבסיסי משתמש במפרט HTTP לשם המשתמש ולסיסמה. כדי להשתמש ב-Cloud Monitoring, השרת צריך להחזיר תגובה 401 עם הכותרת המתאימה WWW-Authenticate. למידע נוסף על אימות בסיסי, אפשר לעיין במאמרים הבאים:

• מפרט RFC
• אימות בסיסי

אימות באמצעות טוקן

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

https://www.myserver.com/stackdriver-hook?auth_token=1234-abcd

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

דוגמה לשרת ב-Python זמינה בשרת לדוגמה.

עריכה ומחיקה של ערוצי התראות

כדי לערוך או למחוק ערוץ התראות באמצעות מסוף Google Cloud :

1. נכנסים לדף  Alerting במסוף Google Cloud :

   כניסה אל התראות

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

2. לוחצים על עריכת ערוצי התראות.

   מרכז הבקרה ערוצי התראות מכיל קטע לכל סוג של ערוץ התראות. בכל קטע מפורטות כל ההגדרות של אותו סוג:

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

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

בחירת ערוצי התראות דרך Google Cloud המסוף

כדי לבחור ערוץ התראות קיים, צריך להיות לכם אחד מהתפקידים הבאים:

• משתמש ב-Error Reporting
• Error Reporting Admin
• עריכת פרויקטים
• Project Owner

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

1. נכנסים לדף Error Reporting במסוף Google Cloud :

   עבור אל Error Reporting

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

2. לוחצים על הגדרת התראות כדי לפתוח את הדף התראות על שגיאות.

3. בתפריט הנפתח ערוצי התראות, בוחרים את הערוצים שרוצים לשלוח אליהם את ההתראות.

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

4. אחרי שבוחרים את הערוצים, לוחצים על שמירה.

מידע נוסף

בהמשך מופיע מידע נוסף שרלוונטי ליצירה ולניהול של התראות ב-Error Reporting.

תוכן ההתראות

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

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

מתי נשלחות התראות

Error Reporting שולח התראה בשני מקרים:

• כשמתרחש אירוע שגיאה ואין קבוצת שגיאות קיימת.
• כשמתרחש אירוע שגיאה בקבוצת שגיאות קיימת, והסטטוס של קבוצת השגיאות מוגדר כResolved.

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

הגבלת שיעור ההתראות

Error Reporting משתמש ב<a href="https://cloud.google.com/error-reporting">כללים</a> הבאים כדי להגביל את מספר ההתראות שאתם עשויים לקבל בעקבות אירועי שגיאה:

• אפשר לשלוח לכל היותר 5 התראות לכל קבוצת שגיאות בחלון של 60 דקות.

• אם מתרחשים יותר מ-5 אירועי שגיאה באותה קבוצת שגיאות בחלון של 60 דקות, מתרחשים הדברים הבאים:

  • תקבלו התראה על כך שההתראות הבאות יושתקו למשך שש השעות הבאות.

  • נכתב רשומה ביומן עם רמת החומרה של האזהרה.

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

סטטוס הטיפול בבעיה

אם מתרחש אירוע שגיאה בקבוצת שגיאות עם סטטוס פתרון Resolved, גם אם אירועי שגיאה קודמים נמחקו, הסטטוס של קבוצת השגיאות מוגדר ל-Open ו-Error Reporting שולח התראה.

עם זאת, Error Reporting לא שולח התראות כשמתרחשים אירועי שגיאה וקבוצת השגיאות התואמת מושתקת.

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

התראות לנייד

Error Reporting שולח התראות בנייד לאפליקצייתGoogle Cloud ב-Android וב-iOS. כדי להפעיל את ההתראות בנייד, צריך קודם להתקין את האפליקציה בנייד:

הורדת Google Cloud האפליקציה