פתרון בעיות במדיניות של VM Extension Manager ל-Ops Agent

כדי לאבחן בעיות בכללי המדיניות של VM Extension Manager שמנהלים את Ops Agent, אתם יכולים להשתמש בשיטות לפתרון בעיות שמתוארות במאמר הזה. למידע על פתרון בעיות ב-Ops Agent, קראו את המאמר פתרון בעיות ב-Ops Agent.

פקודות gcloud compute zone-vm-extension-policies נכשלות

אם פקודת gcloud compute zone-vm-extension-policies נכשלת, התשובה כוללת הצעות לפתרון בעיות. מתקנים את השגיאות בדגלים או בארגומנטים של הפקודה, לפי ההצעות שבהודעת השגיאה.

אם בפלט של הפקודה כתוב שאין מספיק הרשאות IAM, בדקו את התפקידים וההרשאות הנדרשים שמתוארים בקטע הקצאת התפקידים שנדרשים לשימוש ב-VM Extension Manager.

מדיניות התוסף נוצרה, אבל הסטטוס של סוכן תפעול הוא "לא זוהה"

יצרתם בהצלחה מדיניות תוספים, אבל ב-Ops Agent מופיע סטטוס "not detected" במכונה הווירטואלית.

יכול להיות ש-Ops Agent יוצג כ "לא זוהה" אם מתרחש אחד מהמקרים הבאים:

  • מדיניות התוסף לא מתקינה את סוכן תפעול.
  • בסוכן תפעול מותקן מתרחשת שגיאה שמונעת ממנו לפעול.

בקטעים הבאים מוסבר איך לאבחן את המקרים האלה.

איך מוודאים שסוכן התפעול הותקן על ידי המדיניות

כללי המדיניות של VM Extension Manager משתמשים בסוכן האורח של Compute Engine כדי לנהל את סוכן תפעול כתוסף של מכונה וירטואלית.

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

Logs Explorer

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

    נכנסים לדף Logs Explorer.

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

  2. מזינים את השאילתה הבאה ולוחצים על Run query:

    log_id("GCEGuestAgentManager")

Linux

מריצים את הפקודה הבאה במכונה הווירטואלית של Compute Engine:

journalctl -u google-guest-agent-manager

Windows

מריצים את הפקודה הבאה במכונה הווירטואלית של Compute Engine:

Get-Eventlog -Source google_guest_agent_manager -LogName Application

אם ביומנים מופיעה מחרוזת כמו Failed to install plugin "ops-agent-plugin" ..., או אם השאילתה לא מחזירה יומנים, סימן שמדיניות התוסף לא הצליחה להתקין את סוכן תפעול. לשלבים הבאים, ראו מדיניות התוספים לא מתקינה את סוכן תפעול.

אם מופיעים יומנים שמכילים מחרוזת כמו Successfully installed plugin "ops-agent_nnnnnnnn", סימן שמדיניות התוסף התקינה בהצלחה את סוכן התפעול. לשלבים הבאים, קראו את המאמר סוכן תפעול שהותקן "לא זוהה".

מדיניות התוספים לא מתקינה את סוכן תפעול

יכול להיות שמדיניות של תוסף לא תהיה יעילה אם מתקיים אחד מהתנאים הבאים:

סוכן תפעול שהותקן נמצא בסטטוס "לא זוהה"

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

אימות התצורה של סוכן תפעול

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

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

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

בדיקת יומני ניפוי באגים

Logs Explorer

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

    נכנסים לדף Logs Explorer.

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

  2. מזינים את השאילתה הבאה ולוחצים על Run query:

    severity>=DEBUG log_id("GCEGuestAgentManager") "The agent config file is not valid"‎

Linux

מריצים את הפקודה הבאה במכונה הווירטואלית של Linux ב-Compute Engine:

journalctl -u google-guest-agent-manager | grep "The agent config file is not valid"

Windows

מריצים את הפקודה הבאה ב-VM של Windows ב-Compute Engine:

Get-Eventlog -Source google_guest_agent_manager -LogName Application | Where-Object {$_.Message -like "*The agent config file is not valid*"}

אם מופיעים ביומנים רשומות עם המחרוזת The agent config file is not valid, סימן שההגדרה האישית של סוכן תפעול שסיפקתם כשיצרתם או עדכנתם את מדיניות התוסף לא תקינה.

כדי לפתור את הבעיה:

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

  • מעדכנים את מדיניות התוסף עם ההגדרה המתוקנת.

הפקודות systemctl status ב-Linux ו-Get-Service ב-Windows לא פועלות עם סוכן תפעול

אתם מריצים פקודה כמו sudo systemctl status google-cloud-ops-agent"*" אבל לא מוחזר מידע.

כש-Ops Agent מותקן ומנוהל על ידי VM Extension Manager, הוא לא מנוהל על ידי שירות ניהול המערכת של מערכת ההפעלה, כלומר systemd ב-Linux או Windows Service Manager ב-Windows.

כדי למצוא את פרטי הסטטוס של סוכן תפעול שמנוהל על ידי VM Extension Manager:

הפקודות systemctl restart ב-Linux ו-Restart-Service ב-Windows לא פועלות עם סוכן תפעול

אתם מריצים פקודה כמו sudo systemctl restart google-cloud-ops-agent, אבל סוכן תפעול לא מופעל מחדש.

כש-Ops Agent מותקן ומנוהל על ידי VM Extension Manager, הוא לא מנוהל על ידי שירות ניהול המערכת של מערכת ההפעלה, כלומר systemd ב-Linux או Windows Service Manager ב-Windows. לכן אי אפשר להפסיק או להפעיל את סוכן תפעול באופן ידני, ופקודות כמו אלה לא פועלות עם סוכן תפעול:

  • ‫Linux: ‏ sudo systemctl [stop|start|restart]
  • ‫Windows: ‏ Stop-Service, ‏ Start-Service, ‏ Restart-Service

כדי לעצור או להפעיל מחדש סוכן תפעול שמנוהל על ידי VM Extension Manager, צריך להסיר את ה-agent על ידי מחיקת מדיניות התוסף. למידע נוסף על עצירה או הפעלה מחדש של Ops Agent, קראו את המאמר הפעלה מחדש של Ops Agent שהותקן באמצעות מדיניות הרחבה.

מידע נוסף על פתרון בעיות

מידע נוסף על פתרון בעיות ביצירה ובשימוש בכללי מדיניות של VM Extension Manager זמין במאמר פתרון בעיות בתוספי VM.

למידע נוסף על פתרון בעיות ב-Ops Agent, קראו את המאמר פתרון בעיות ב-Ops Agent.