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

כל מכונה וירטואלית (VM) או מכונת Bare Metal משתמשת במדיניות תחזוקת המארח כדי לקבוע את אופן הפעולה של המכונה במהלך פעולת תחזוקה. במקרים מסוימים, יש אפשרות נוספת לצפייה בלוח הזמנים של התחזוקה מראש.

בדף הזה מוסבר איך לעקוב אחרי אירוע תחזוקה של מארח במכונות Compute Engine ולתכנן אותו.

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

• אם עדיין לא עשיתם את זה, תצטרכו להגדיר אימות. אימות הוא תהליך שבו מאמתים את הזהות שלכם כדי לקבל גישה לממשקי API ולשירותים של Cloud de Confiance by S3NS . כדי להריץ קוד או דוגמאות מסביבת פיתוח מקומית, אפשר לבצע אימות ל-Compute Engine באחת מהדרכים הבאות:

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

  המסוף

  כשמשתמשים במסוף Cloud de Confiance כדי לגשת לשירותים Cloud de Confiance by S3NS ולממשקי ה-API, לא צריך להגדיר אימות.

  gcloud

  1. התקינו את ה-CLI של Google Cloud ואז היכנסו ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם. אחרי שנכנסתם לחשבון, אתחלו את ה-CLI של Google Cloud באמצעות הפקודה הבאה:

     gcloud init

• הגדרת אזור ותחום כברירת מחדל

REST

כדי להשתמש בסביבת פיתוח מקומית בדוגמאות של API בארכיטקטורת REST שבדף הזה, צריך להשתמש בפרטי הכניסה שאתם נותנים ל-CLI של gcloud.

התקינו את ה-CLI של Google Cloud ואז היכנסו ל-CLI של gcloud באמצעות הזהות המאוחדת שלכם.

מידע נוסף מופיע במאמר אימות לשימוש ב-REST במסמכי האימות של Cloud de Confiance .

התפקידים הנדרשים

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

• Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1)
• כדי לקבל גישה לקריאה בלבד ליומני הביקורת System Event: מציג היומנים (roles/logging.viewer)

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

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

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

מגבלות

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

• משפחות של מכונות שעברו אופטימיזציה לשימוש במאיצים:

  • ‫GPUs:

    • A4

    • A4X

    • A3

    • A2

    • G4

    • G2

    • סוגי מכונות N1 עם מעבדי NVIDIA T4 GPU

    • סוגי מכונות N1 עם מעבדי NVIDIA P4 GPU

    • סוגי מכונות N1 עם מעבדי GPU של NVIDIA V100

  • מעבדי TPU:

    • TPU7x

    • ‫TPU v6e

    • ‫TPU v5p

• משפחות של מכונות למטרות כלליות:

  • C4D

  • C4A

  • C4

  • C3D

  • C3

• משפחות של מכונות שעברו אופטימיזציה לרשת:

  • C4N

  • M4N

• משפחות של מכונות שמותאמות לצריכת זיכרון גבוהה (memory-optimized):

  • X5

  • X4

  • ‫M4 ו-M4N

  • M3

  • M2

  • M1

• משפחות של מכונות שעברו אופטימיזציה לאחסון:

  • Z4D
  • Z3

• משפחות של מכונות וירטואליות מותאמות לצריכת מעבד גבוהה (compute-optimized):

  • H4D

  • H3

סקירה כללית על התראות לגבי פעולות תחזוקה

‫Google שולחת התראות לגבי תחזוקה של המארח בכמה דרכים. כשחלון התחזוקה נפתח, Cloud de Confiance by S3NS מתבצעת אוטומטית תחזוקה במכונה. מעקב אחרי חלונות הזמן לתחזוקה הקרובים של המכונה מאפשר לכם להכין את עומסי העבודה מראש כדי להתמודד עם תחזוקה קרובה עם מינימום שיבושים.

למכונות Compute שנתמכות בהתראות על אירועי תחזוקה יש את המאפיינים הבאים:

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

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

upcomingMaintenance:{
    "canReschedule":True
    "latestWindowStartTime": "2024-12-01T19:00:01Z"
    "machineType":"x4-960-16t-metal"
    "maintenanceStatus":"PENDING"
    "type":"SCHEDULED"
    "windowEndTime": "2024-12-01T22:00:00Z"
    "windowStartTime": "2024-12-01T19:00:00Z"
}

אם אין אירוע תחזוקה קרוב, תוצג הודעה דומה לזו:

{ "error": "no notifications have been received yet, try again later" }

הגדרות הסטטוס של פעולות תחזוקה

הגדרות הסטטוס הבאות מסבירות את התשובות לשאילתות לגבי תחזוקת מארח עבור מופע. הם מספקים מידע שקשור לאירוע התחזוקה. ב-Google Cloud CLI, ב-REST ובשרת המטא-נתונים נעשה שימוש באותן תגובות:

• ‫canReschedule: האם אפשר להפעיל את התחזוקה באופן ידני במהלך תקופת ההתראה של המכונה הזו.
  • ‫TRUE: אפשר לבצע תחזוקה שהופעלה על ידי לקוח במהלך תקופת ההודעה.
  • ‫FALSE: אי אפשר לבצע תחזוקה שמופעלת על ידי לקוח במופע הזה. לרוב זה קורה בתקופה שבה מתבצעת תחזוקה של המופע או אם סוג המופע לא תומך בתחזוקה לפי דרישה.
• ‫latestWindowStartTime: השעה המאוחרת ביותר שאליה אפשר להעביר את חלון הזמן לתחזוקה.
• ‫machineType: סוג המכונה של המופע, לדוגמה x4-960-16t-metal או c4-highmem-192.
• ‫maintenanceReason: הסיבה לאירוע תחזוקה דחוף. דוגמאות:
  • ‫FAILURE_GPU_TEMPERATURE: תחזוקה עקב טמפרטורת GPU גבוהה.
  • ‫FAILURE_MEMORY: תחזוקה בגלל שגיאות בזיכרון.
  • ‫FAILURE_NETWORK: תחזוקה בגלל שגיאות ברשת.
  • ‫FAILURE_DISK: תחזוקה בגלל שגיאות בדיסק.
• ‫maintenanceStatus: הסטטוס הנוכחי של אירוע התחזוקה.
  • ‫ONGOING: פעולת התחזוקה מתבצעת.
  • ‫PENDING: עבודות התחזוקה מתוזמנות, אבל עדיין לא התחילו.
• ‫type: סוג התחזוקה שצריך לבצע.
  • ‫NONE: לא מתוכננות עבודות תחזוקה למכונה הזו.
  • ‫SCHEDULED: במקרה של תחזוקה שגורמת להפרעה, Compute Engine מספק הודעה מראש של לפחות 7 ימים לרוב המכונות.
  • ‫UNSCHEDULED: מכיוון שהתחזוקה מייצגת עדכונים קריטיים או דחופים,‏ Compute Engine מנסה לספק התראה מוקדמת ככל האפשר, אבל בדרך כלל ההתראה קצרה בהרבה מזו שמתקבלת לגבי אירועי תחזוקה מתוזמנים.
• ‫windowEndTime: סוף חלון הזמן שבו מתבצעת התחזוקה.
• ‫windowStartTime: תחילת חלון הזמן שבו מתבצעת התחזוקה.

התנהגויות של סטטוס התחזוקה

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

• ‫canReschedule=True ו-maintenanceStatus=Pending – אפשר להפעיל ידנית את אירוע התחזוקה של המכונה לפני שעת ההתחלה המתוזמנת.
• ‫canReschedule=False ו-maintenanceStatus=Ongoing – עבודות התחזוקה מתבצעות ואי אפשר לשנות את המועד שלהן.
• ‫canReschedule=False ו-maintenanceStatus=Pending – המכונה שלכם לא תומכת באירועי תחזוקה שמופעלים באופן ידני.

הצגת התראות לגבי פעולות תחזוקה

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

באותן שיטות אפשר גם לראות אירועי תחזוקה שמתרחשים באופן לא צפוי. עם זאת, התראות על אירועי תחזוקה דחופים כוללות שדה type עם הערך UNSCHEDULED, ואפשר לראות את השדה הזה רק ב-Cloud Logging.

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

כדי לבדוק אם צפוי אירוע תחזוקה של המארח עבור המופע שלכם, אפשר להשתמש ב-Google Cloud CLI, ב-REST או לשלוח שאילתה לשרת המטא-נתונים.

gcloud compute instances describe INSTANCE_NAME \
   --zone=ZONE_NAME --format="yaml(resourceStatus.upcomingMaintenance)"

  resourceStatus:
    upcomingMaintenance:
      canReschedule: true
      latestWindowStartTime: '2025-01-15T12:00:01Z'
      machineType: x4-960-16t-metal
      maintenanceStatus: PENDING
      type: SCHEDULED
      windowEndTime: '2025-01-15T16:00:00Z'
      windowStartTime: '2025-01-15T12:00:00Z'

GET https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME

  upcomingMaintenance:{
    "canReschedule":True
    "latestWindowStartTime": "2023-12-01T19:00:01Z"
    "machineType": "x4-960-16t-metal"
    "maintenanceStatus":"PENDING"
    "type":"SCHEDULED"
    "windowEndTime": "2023-12-01T22:00:00Z"
    "windowStartTime": "2023-12-01T19:00:00Z"
  }

$ curl http://metadata.google.internal/computeMetadata/v1/instance/upcoming-maintenance?alt=json -H "Metadata-Flavor: Google"

בדיקה ב-Cloud Logging אם יש התראה לגבי אירוע תחזוקה

‫Compute Engine יוצר אירועים במערכת ביומני ביקורת ב-Cloud עבור מופע של אירועי תחזוקה. אפשר לראות את האירועים האלה לפני, במהלך ואחרי אירוע תחזוקה באמצעות Cloud Logging וLogs Explorer.

דוגמאות להתראות על תחזוקה

הודעה על אירוע תחזוקה של מכונה מופיעה בכלי Logs Explorer עם ערכים שדומים לערכים הבאים:

• methodName: "compute.instances.upcomingMaintenance"
• metadata:
  • maintenanceStatus: "PENDING"
  • machineType: ‏"x4-960-16t-metal"
  • windowStartTime: "2024-07-23T20:00:00Z"

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

• methodName: "compute.instances.upcomingMaintenance"
• metadata:
  • maintenanceStatus: "ONGOING"
  • machineType: ‏"x4-960-16t-metal"
  • windowStartTime: "2024-07-23T20:00:00Z"

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

• למקרים שבהם המכונות הווירטואליות מוגדרות להשתמש במיגרציה פעילה במהלך אירועי תחזוקה, יופיע אירוע מערכת עם methodName: "compute.instances.migrateOnHostMaintenance".
• במקרים שבהם המופעים מוגדרים להסתיים במהלך אירועי תחזוקה, אירוע מערכת עם methodName: "compute.instances.terminateOnHostMaintenance".

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

• methodName: "compute.instances.upcomingMaintenance"
• status: { message: "Maintenance window has completed for this instance. All maintenance notifications on the instance have been removed." }

הגדרת התראות לגבי הודעות על תחזוקת המארח

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

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

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

• איך מגדירים מדיניות תחזוקה למארחים
• איך מקבלים הודעות על מיגרציה פעילה
• איך מפעילים ידנית אירוע תחזוקה של מארח
• איך מנהלים מדיניות התראות מבוססת-יומנים באמצעות מסוף Cloud de Confiance Monitoring או באמצעות Monitoring API