צפייה ביומני התוספים של מכונת ה-VM

כשמשתמשים ב-VM Extension Manager כדי לנהל תוספים במכונות Compute Engine (מכונות וירטואליות), הסוכן האורח בכל מכונה וירטואלית מתעד אירועים לגבי אכיפת התוסף. אתם יכולים להשתמש ב-Cloud Logging כדי לצפות ביומנים האלה ב-Logs Explorer, כדי לעקוב אחרי בעיות בתוספים של ה-VM ולפתור אותן.

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

  • אפשר לקרוא את התיעוד של VM Extension Manager.
  • איך משתמשים ב-Logs Explorer
  • אם עדיין לא עשיתם את זה, תצטרכו להגדיר אימות. אימות הוא תהליך שבו מאמתים את הזהות שלכם כדי לקבל גישה לממשקי API ולשירותים של Google Cloud . כדי להריץ קוד או דוגמאות מסביבת פיתוח מקומית, אפשר לבצע אימות ל-Compute Engine באחת מהדרכים הבאות:

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

    המסוף

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

    gcloud

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

      gcloud init

      אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

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

    • REST

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

      התקינו את ה-CLI של Google Cloud.

      אם אתם משתמשים בספק זהויות חיצוני (IdP), קודם אתם צריכים להיכנס ל-CLI של gcloud באמצעות המאגר המאוחד לניהול זהויות.

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

צפייה ביומנים של תוספים למכונות וירטואליות

כדי לראות את היומנים של תוסף למכונה וירטואלית, משתמשים במסוף Google Cloud , ב-Google Cloud CLI או ב-REST.

המסוף

  1. נכנסים לדף Logs Explorer במסוף Google Cloud .

    כניסה לדף Logs Explorer

  2. בשדה Query, מזינים את השאילתה הבאה:

    resource.type="gce_instance"
resource.labels.instance_id="INSTANCE_ID"
jsonPayload.@type="type.googleapis.com/google.compute.logging.agentcontrolplane.v1.VmExtensionEvent"
jsonPayload.extensionName="EXTENSION_NAME"
timestamp >= START_TIME
timestamp <= END_TIME

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

    • ‫INSTANCE_ID: המזהה של מופע המכונה הווירטואלית.
    • ‫EXTENSION_NAME: שם התוסף (לדוגמה, ops-agent).
    • ‫START_TIME: תחילת טווח התאריכים (לדוגמה, 2024-01-01T00:00:00Z).
    • ‫END_TIME: סוף טווח התאריכים (לדוגמה, 2024-02-01T00:00:00Z).

    שאילתה לדוגמה:

    resource.type="gce_instance"
resource.labels.instance_id="123456"
jsonPayload.@type="type.googleapis.com/google.compute.logging.agentcontrolplane.v1.VmExtensionEvent"
jsonPayload.extensionName="ops-agent"
timestamp >= "2024-01-01T00:00:00Z"
timestamp <= "2024-02-01T01:00:00Z"

  3. לוחצים על Run query.

gcloud

כדי לחפש ביומנים של תוסף VM, משתמשים בפקודה logging read. לדוגמה:

gcloud logging read 'resource.type="gce_instance" AND \
    resource.labels.instance_id="INSTANCE_ID" AND \
    jsonPayload.@type="type.googleapis.com/google.compute.logging.agentcontrolplane.v1.VmExtensionEvent" AND \
    jsonPayload.extensionName="YOUR_EXTENSION_NAME" AND \
    timestamp >= "START_TIME" AND \
    timestamp <= "END_TIME"'

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

  • ‫INSTANCE_ID: המזהה של מופע המכונה הווירטואלית.
  • ‫YOUR_EXTENSION_NAME: השם של התוסף (לדוגמה, ops-agent).
  • ‫START_TIME: תחילת טווח הזמן (לדוגמה, 2024-01-01T00:00:00Z).
  • ‫END_TIME: סוף טווח התאריכים (לדוגמה, 2024-02-01T00:00:00Z).

REST

שולחים בקשה אל Logging V2 API. גוף הבקשה חייב להכיל את הפרמטר filter. לדוגמה:

POST https://logging.googleapis.com/v2/entries:list

{
  "filter": "resource.type="gce_instance" AND
            "resource.labels.instance_id="INSTANCE_ID" AND
            "jsonPayload.@type="type.googleapis.com/google.compute.logging.agentcontrolplane.v1.VmExtensionEvent" AND
            "jsonPayload.extensionName="EXTENSION_NAME" AND
            "timestamp >= "START_TIME" AND
            "timestamp <= "END_TIME",
  "pageSize": 10,
  "resourceNames": [
    "projects/PROJECT_ID"
  ]
}

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

  • ‫INSTANCE_ID: המזהה של מופע המכונה הווירטואלית.
  • ‫EXTENSION_NAME: השם של התוסף (לדוגמה, ops-agent).
  • ‫START_TIME: תחילת טווח הזמן (לדוגמה, 2024-01-01T00:00:00Z).
  • ‫END_TIME: סוף טווח התאריכים (לדוגמה, 2024-02-01T00:00:00Z).
  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .

רשומה ביומן האירועים של תוסף ל-VM

הדוגמה הבאה היא רשומה ביומן של אירוע תוסף למכונה וירטואלית:

{
  "insertId": "rsiudxbck",
  "jsonPayload": {
    "eventMessage": "Enforcement State: Installing ops-agent@4bda61add3e5c989.; Extension Health: Plugin is running ok",
    "timestamp": "2026-03-23T16:13:40.496755675Z",
    "extensionName": "ops-agent",
    "revisionId": "4bda61add3e5c989",
    "@type": "type.googleapis.com/google.compute.logging.agentcontrolplane.v1.VmExtensionEvent",
    "eventType": "INSTALLED"
  },
  "resource": {
    "type": "gce_instance",
    "labels": {
      "project_id": "27654321",
      "instance_id": "1234567",
      "zone": "us-west1-a"
    }
  },
  "timestamp": "2026-03-23T16:13:40.496854498Z",
  "severity": "INFO",
  "logName": "projects/my-project/logs/compute.googleapis.com%2Fvm_extension_policies",
  "receiveTimestamp": "2026-03-23T16:13:40.906133199Z"
}

פרטים של רשומה ביומן

בטבלה הבאה מתוארים הפרמטרים שאפשר למצוא ביומני הרישום של תוסף המכונה הווירטואלית:

שדה תיאור
eventMessage הודעה שמתארת את האירוע, כולל מצב האכיפה והתקינות של התוסף.
extensionName שם התוסף (לדוגמה, ops-agent).

כאן אפשר לעיין ברשימת התוספים הנתמכים והשמות שלהם.
extensionVersion הגרסה של התוסף שנבחרה להתקנה. הגרסה הזו היא הגרסה שמוצמדת במדיניות התוסף, או הגרסה העדכנית אם לא הוצמדה גרסה.
revisionId קובץ בינארי ספציפי של גרסת תוסף. לכל גרסה של תוסף יכולות להיות כמה גרסאות כדי לתמוך במערכות הפעלה שונות, ו-Google בוחרת באופן אוטומטי את הגרסה הנכונה למכונה וירטואלית ספציפית. אם תספקו את מזהה הגרסה הזה לצוות התמיכה של Google, הם יוכלו לבדוק אם נבחר הקובץ הבינארי הנכון למכונה הווירטואלית.
eventType סוג האירוע. הוא יכול להיות אחד מהערכים הבאים:
  • ‫CRASHED: התוסף קרס. הערך הזה מציין שהתוסף הותקן והופעל בהצלחה, אבל אחר כך הפסיק לפעול.
  • ‫INSTALL_FAILED: התקנת התוסף נכשלה.
  • ‫INSTALLED: התוסף הותקן והופעל בהצלחה.
  • ‫ROLLBACK_FAILED: החזרה למצב הקודם של התוסף נכשלה.
  • ‫ROLLED_BACK: החזרה של התוסף למצב הקודם הצליחה.
  • ‫INCOMPATIBLE: אף אחת מהגרסאות המועמדות של התוסף לא עומדת בדרישות ההתקנה (לדוגמה, מערכת הפעלה או ארכיטקטורה).
  • ‫SERVICE_DISABLED: השירות שדורש את התוסף הזה מושבת.