הגדרת התראות מבוססות-יומן למכשיר לגיבוי או לשחזור

בדף הזה מוסבר איך להגדיר התראה מבוססת-יומן למכשיר גיבוי/שחזור של שירות Backup and DR באמצעות Logs Explorer במסוף Google Cloud .

ממשק Logs Explorer ליצירה ולעריכה של התראות מבוססות-יומן כולל את השלבים הבאים:

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

מידע נוסף על Logs Explorer זמין במאמר הצגה וניתוח של יומנים.

הרשאות ותפקידים

כדי ליצור התראות מבוססות-יומן ולנהל אותן בכלי Logs Explorer, התפקיד שלכם בניהול הזהויות והרשאות הגישה (IAM) צריך לכלול את קבוצת ההרשאות שמתוארת במאמר הרשאות להתראות מבוססות-יומן.

יצירת התראה מבוססת-יומן עבור מכשיר גיבוי או שחזור

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

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

1. במסוף Google Cloud , בוחרים באפשרות Logging ואז באפשרות Logs Explorer.

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

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

   logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events"
   jsonPayload.eventId=10046
   

3. בכותרת של החלונית Query results, לוחצים על Create alert. אם החלון צר מדי, האפשרות יצירת התראה מופיעה בתפריט פעולות במקום זאת.

4. בחלונית פרטי ההתראה, נותנים להתראה שם ותיאור:

   1. מזינים שם להתראה בשדה שם מדיניות ההתראה. השם הזה יוצג בכותרת של ההתראה.
   2. בשדה Documentation (תיעוד), מזינים את התיאור של ההתראה. במאמר הזה מוסבר איך לעצב את התוכן בשדה הזה ולשפר אותו באמצעות Markdown ומשתנים. כוללים את כתובת ה-URL של מסוף הניהול של המכשיר בשדה התיעוד. אפשר גם להוסיף את הפתרון העקיף כדי לפתור את הבעיה באירוע.

5. לוחצים על הבא.

6. בחלונית Choose logs to include in the alert (בחירת יומנים שיכללו בהתראה):

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

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

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

7. לוחצים על הבא.

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

9. לוחצים על הבא.

10. בוחרים ערוץ התראות אחד או יותר להתראה, למשל, בוחרים ערוץ התראות באימייל. אם כבר הגדרתם ערוץ התראות באימייל, תוכלו לבחור אותו מהרשימה. אם לא, לוחצים על Manage notification channels ומוסיפים ערוץ אימייל. מידע על יצירת ערוצי התראות זמין במאמר יצירה וניהול של ערוצי התראות.

11. לוחצים על Save.

    מומלץ להגדיר התראות עבור מזהי אירועים חשובים.

בדיקת ההתראה שמבוססת על יומן

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

1. עוברים לדף העזר logEntries.write או לוחצים על הכפתור הבא:

   מעבר אל logEntries.write

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

     "entries": [
     {
       "jsonPayload": {
         "eventId": 10046,
         "errorMessage": "this is a manually generated error message created for testing"
       },
       "resource": {
         "type": "backupdr.googleapis.com/BackupRecoveryAppliance",
       },
       "severity": "ERROR",
       "logName": "projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events",
     }
     ]
   

3. מעתיקים את רשומת היומן שהגדרתם קודם.

4. בחלונית Try this API, פועלים לפי השלבים הבאים:

   1. מחליפים את התוכן בשדה גוף הבקשה ב-APIs Explorer ברשומה ביומן שהעתקתם בשלב הקודם.
   2. לוחצים על Execute. אם תתבקשו, תצטרכו לבצע את תהליך האימות.

   אם הקריאה logEntries.write מצליחה, מקבלים קוד תגובה מסוג HTTP 200 וגוף תגובה ריק, {}. מידע נוסף על APIs Explorer זמין במאמר שימוש ב-APIs Explorer. השימוש ב-APIs Explorer זהה גם לשימוש ב-Cloud Logging API.

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

   • הערך logName מציין את הכניסה לאירוע של מכשיר הגיבוי או השחזור בפרויקט בענן שלכם.
   • ערך החומרה של רשומת היומן הזו הוא ERROR.
   • ‫jsonPayload מכיל אירוע של בריכה מלאה 10046.

   אחרי שכותבים את הרשומה ביומן, מתרחש הרצף הבא:

   1. רשומת היומן החדשה מופיעה ב'Logs Explorer' ומפעילה את ההתראה.
   2. אירוע נפתח ב-Cloud Monitoring.
   3. תקבלו הודעה על התקרית. אם הגדרתם ערוץ התראות באימייל, ההתראה תוצג.

אפשר ללחוץ על View incident (הצגת האירוע) בהודעת האימייל כדי לראות את האירוע ב-Cloud Monitoring. מידע נוסף על אירועים, כולל איך לאשר ולסגור אותם, זמין במאמר בנושא ניהול אירועים להתראות שמבוססות על יומנים.

יצירת כמה כללי מדיניות להתראות

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

1. אירועים שנדרשת השתתפות דחופה בהם, ולכן צריך לשלוח התראות בתדירות גבוהה יותר. לדוגמה, צריך לדווח על מזהה האירוע 43901 (משימת צילום תמונת מצב נכשלה) כל 30 דקות. משתמשים בשאילתה הבאה כדי ליצור את ההתראה.

       Policyname = 'Snapshot job has failed'
       Notification rate limit = 30 min
       logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events" AND jsonPayload.eventId=43901
   

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

       Policyname = 'Backup Plan Violation has occurred'
       Notification rate limit = 1 day
       logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events" AND jsonPayload.eventId=10085
   

3. אירועים שלא משפיעים על המשתמשים ואפשר להתעלם מהם. לדוגמה, אפשר להתעלם ממזהי האירועים 10229 (שגיאות חריגה מנפח האחסון) ו-42356 (זוהו שינויים בקובץ), כי אלה תוצאות חיוביות שגויות. משתמשים בשאילתה הבאה כדי ליצור את ההתראה.

       Policyname = 'Backup/DR event has occurred'
       Notification rate limit = 6 hr
       logName="projects/PROJECT_ID/logs/backupdr.googleapis.com%2Fbackup_recovery_appliance_events" AND NOT jsonPayload.eventId=(10085 OR 10229 OR 42356 OR 43901)