ניהול PMU במכונות Compute Engine

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

  • שינוי סוג ה-PMU שמופעל במופע של Compute. השינוי הזה שימושי כשרוצים לעקוב אחרי סוגים שונים של אירועי CPU ברמה נמוכה.

  • השבתה של PMU במופע של Compute. הפעולה הזו שימושית כשכבר לא צריך לגשת למוני הביצועים ב-PMU.

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

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

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

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

    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 .

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

כדי לקבל את ההרשאות שנדרשות לשינוי סוג ה-PMU שמופעל במכונת Compute או להשבתה שלו, צריך לבקש מהאדמין להקצות לכם ב-IAM את התפקיד אדמין מכונות של Compute ‏ (v1) (roles/compute.instanceAdmin.v1) בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

ההרשאות הנדרשות

כדי לשנות את סוג ה-PMU שמופעל במכונת חישוב או להשבית אותו, נדרשות ההרשאות הבאות:

  • כדי לעדכן מכונת חישוב: compute.instances.update במכונת החישוב

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

שינוי סוג ה-PMU במופע של מכונת חישוב

לפני שמשנים את סוג ה-PMU במכונה קיימת מסוג A4X,‏ C4A,‏ C4 או M4, צריך להציג את פרטי מכונת החישוב באמצעות Google Cloud CLI או API בארכיטקטורת REST. בפלט של הפקודה או של בקשת ה-API, מוודאים את הדברים הבאים:

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

  2. אם רוצים להפעיל את סוג ה-PMU המשופר, צריך לוודא שמופע Compute משתמש באחד מסוגי המכונות הבאים. כדי לעשות זאת, בודקים את הערך של השדה machineType:

    • סוג מכונה C4 עם 144 או 288 יחידות vCPU

    • אחד מסוגי המכונות הבאים של M4:

      • m4-megamem-112

      • m4-megamem-224

      • m4-ultramem-56

      • m4-ultramem-112

      • m4-ultramem-224

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

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

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

gcloud

  1. יוצרים קובץ YAML ריק.

  2. כדי לייצא את המאפיינים של מכונת Compute לקובץ ה-YAML שיצרתם, משתמשים בפקודה gcloud compute instances export:

    gcloud compute instances export INSTANCE_NAME \
    --destination=YAML_FILE \
    --zone=ZONE

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫INSTANCE_NAME: השם של מכונת ה-Compute.

    • ‫YAML_FILE: הנתיב לקובץ ה-YAML שיצרתם בשלב הקודם.

    • ‫ZONE: האזור שבו קיימת מכונת ה-Compute.

  3. בקובץ ההגדרות של YAML, מאתרים את השדה performanceMonitoringUnit ומשנים את הערך שלו כדי לציין סוג אחר של PMU:

    advancedMachineFeatures:
  performanceMonitoringUnit: PMU_TYPE

    מחליפים את PMU_TYPE באחד מהערכים הבאים:

    • סוג PMU ארכיטקטוני: ARCHITECTURAL

    • סוג PMU רגיל: STANDARD

    • סוג PMU משופר: ENHANCED

  4. כדי לעדכן את מכונת ה-Compute ולהפעיל אותה מחדש, משתמשים בפקודה gcloud compute instances update-from-file עם הדגל --most-disruptive-allowed-action שמוגדר לערך RESTART:

    gcloud compute instances update-from-file INSTANCE_NAME \
    --most-disruptive-allowed-action=RESTART \
    --source=YAML_FILE \
    --zone=ZONE

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫INSTANCE_NAME: השם של מכונת ה-Compute.

    • ‫YAML_FILE: הנתיב לקובץ ה-YAML עם נתוני ההגדרה ששיניתם בשלב הקודם.

    • ‫ZONE: האזור שבו קיימת מכונת ה-Compute.

REST

  1. כדי להציג את המאפיינים של מכונת חישוב קיימת, שולחים בקשת GET אל ה-method‏ instances.get:

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

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫PROJECT_ID: מזהה הפרויקט שבו נמצאת מכונת ה-Compute.

    • ‫ZONE: האזור שבו קיימת מכונת ה-Compute.

    • ‫INSTANCE_NAME: השם של מכונת Compute קיימת.

  2. כדי לעדכן את מכונת החישוב ולהפעיל אותה מחדש, שולחים בקשת PUT אל ה-method‏ instances.update באופן הבא:

    • בכתובת ה-URL של הבקשה, כוללים את פרמטר השאילתה mostDisruptiveAllowedAction שמוגדר לערך RESTART.

    • בגוף הבקשה, משתמשים בGET פלט הבקשה מהשלב הקודם. עם זאת, בשדה advancedMachineFeatures, צריך לשנות את הערך של השדה performanceMonitoringUnit לסוג ה-PMU שבחרתם.

    בקשת PUT דומה לבקשה הבאה:

    PUT https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME?mostDisruptiveAllowedAction=RESTART

{
  "advancedMachineFeatures": {
    "performanceMonitoringUnit": "PMU_TYPE"
  },
  ...
}

    מחליפים את PMU_TYPE באחד מהערכים הבאים:

    • סוג PMU ארכיטקטוני: ARCHITECTURAL

    • סוג PMU רגיל: STANDARD

    • סוג PMU משופר: ENHANCED

מידע נוסף על עדכון המאפיינים של מופע חישוב זמין במאמר בנושא עדכון מאפייני מופע.

השבתת ה-PMU במכונת חישוב

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

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

gcloud

  1. יוצרים קובץ YAML ריק.

  2. כדי לייצא את המאפיינים של מכונת Compute לקובץ ה-YAML שיצרתם, משתמשים בפקודה gcloud compute instances export:

    gcloud compute instances export INSTANCE_NAME \
    --destination=YAML_FILE \
    --zone=ZONE

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫INSTANCE_NAME: השם של מכונת ה-Compute.

    • ‫YAML_FILE: הנתיב לקובץ ה-YAML שיצרתם בשלב הקודם.

    • ‫ZONE: האזור שבו קיימת מכונת ה-Compute.

  3. מסירים את השדה performanceMonitoringUnit מקובץ התצורה של YAML. אם השדה advancedMachineFeatures ריק, צריך להסיר אותו גם כן.

    advancedMachineFeatures:
  performanceMonitoringUnit: PMU_TYPE

  4. כדי לעדכן את מכונת ה-Compute ולהפעיל אותה מחדש, משתמשים בפקודה gcloud compute instances update-from-file עם הדגל --most-disruptive-allowed-action שמוגדר לערך RESTART:

    gcloud compute instances update-from-file INSTANCE_NAME \
    --most-disruptive-allowed-action=RESTART \
    --source=YAML_FILE \
    --zone=ZONE

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫INSTANCE_NAME: השם של מכונת ה-Compute.

    • ‫YAML_FILE: הנתיב לקובץ ה-YAML עם נתוני ההגדרה ששיניתם בשלב הקודם.

    • ‫ZONE: האזור שבו קיימת מכונת ה-Compute.

REST

  1. כדי להציג את המאפיינים של מכונת חישוב קיימת, שולחים בקשת GET אל ה-method‏ instances.get:

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

    מחליפים את מה שכתוב בשדות הבאים:

    • ‫PROJECT_ID: מזהה הפרויקט שבו קיימת מכונת ה-Compute.

    • ‫ZONE: האזור שבו קיימת מכונת ה-Compute.

    • ‫INSTANCE_NAME: השם של מכונת Compute קיימת.

  2. כדי לעדכן את מכונת החישוב ולהפעיל אותה מחדש, שולחים בקשת PUT אל ה-method‏ instances.update. בבקשה, מבצעים את הפעולות הבאות:

    • בכתובת ה-URL של הבקשה, כוללים את פרמטר השאילתה mostDisruptiveAllowedAction שמוגדר לערך RESTART.

    • בגוף הבקשה, משתמשים בGET פלט הבקשה מהשלב הקודם. עם זאת, צריך להסיר את השדה performanceMonitoringUnit, ואם אין שדות אחרים בשדה advancedMachineFeatures, צריך להסיר גם את השדה advancedMachineFeatures.

    בקשת PUT דומה לבקשה הבאה:

    PUT https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/INSTANCE_NAME?mostDisruptiveAllowedAction=RESTART

{
  ~"advancedMachineFeatures": {
    ...
  }~,
  ...
}

מידע נוסף על עדכון המאפיינים של מופע חישוב זמין במאמר בנושא עדכון מאפייני מופע.

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