המערכת אוספת פרטי אבחון

במאמר הזה מוסבר איך לאסוף מידע על מכונה וירטואלית (VM) באמצעות כלי אבחון. אתם יכולים להשתמש במידע שהכלים אוספים כדי לפתור בעיות בסיסיות לפני שאתם פונים ל-Cloud Customer Care.

הכלי מבצע את הפעולות הבאות:

  • אוסף מידע רק מהמכונה הווירטואלית שציינתם.

  • המידע נשמר רק בפרויקט שלכם.

  • שומר את המידע למשך 10 ימים בקטגוריה של Cloud Storage, שרק לכם יש גישה אליה כברירת מחדל.

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

  1. בודקים אם המידע מכיל פרטים סודיים או פרטים אישיים מזהים (PII).

  2. מוחקים או מסתירים את המידע לפי הצורך.

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

  • כלי האבחון מותקן ב-Compute Engine כברירת מחדל בגרסאות ציבוריות של קובצי אימג' של Windows Server שמאוחרות מ-v20190714. אחרת, אם גרסת ה-image של Windows Server היא לפני v20190714, או אם אתם משתמשים ב-image בהתאמה אישית, התקינו את הכלי באמצעות הפקודה googet install google-compute-engine-diagnostics.
  • אם עדיין לא עשיתם את זה, תצטרכו להגדיר אימות. אימות הוא התהליך שבו מאמתים את הזהות שלכם כדי לקבל גישה לממשקי API ולשירותים של Google Cloud . כדי להריץ קוד או דוגמאות מסביבת פיתוח מקומית, אפשר לבצע אימות ל-Compute Engine באחת מהדרכים האלה:

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

    המסוף

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

    gcloud

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

      gcloud init

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

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

פרטי אבחון שנאספו מה-VM

כלי האבחון הזה אוסף מידע על:

למידע מפורט על האופן שבו Compute Engine אוסף את המידע הזה, עיינו במאגר הציבורי של GitHub.

מגבלות

  • אפשר לאסוף פרטי אבחון רק ממכונות וירטואליות שנוצרו על סמך Windows Server.

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

כדי לקבל את ההרשאות שנדרשות להפעלת כלי האבחון באמצעות Google Cloud CLI, בקשו מהאדמין להקצות לכם את התפקיד יצירת אסימונים בחשבון שירות (roles/iam.serviceAccountTokenCreator) ב-IAM בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

כדי לצרף מידע לאבחון לבקשת תמיכה, אתם צריכים גם את התפקיד "עריכת בקשות לתמיכה טכנית" (roles/cloudsupport.techSupportEditor).

איסוף פרטי אבחון מ-VM

מריצים את כלי האבחון ישירות מה-VM או מרחוק, באמצעות Google Cloud CLI.

gcloud

  1. אם עדיין לא עשיתם את זה, מקצים את התפקיד iam.serviceAccountTokenCreator בפרויקט לחשבון המשתמש או לחשבון השירות שיריץ את הפקודה gcloud compute diagnose export-logs:

    gcloud projects add-iam-policy-binding PROJECT_ID \
        --member user:EMAIL \
        --role roles/iam.serviceAccountTokenCreator
    

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

    • ‫PROJECT_ID: מזהה הפרויקט
    • ‫EMAIL: כתובת האימייל שרוצים לתת לה את התפקיד iam.serviceAccountTokenCreator
  2. מייצאים את מידע האבחון כאובייקט לקטגוריה של Cloud Storage באמצעות הפקודה diagnose export-logs.

    gcloud compute diagnose export-logs VM_NAME \
      [--collect-process-traces]
    

    הדגל האופציונלי --collect-process-traces מציין אם כלי האבחון אוסף מעקב של 10 דקות אחרי המערכת שפועלת, כולל פעילות של המעבד, הדיסק, הקבצים ופעילות ברשת. במכונות וירטואליות מבוססות-Windows, נעשה שימוש ב-Windows Performance Recorder.

    מחליפים את VM_NAME בשם של המכונה הווירטואלית שממנה רוצים לאסוף את פרטי האבחון.

  3. תהליך הייצוא של היומן עשוי להימשך כמה דקות. כדי לראות את הסטטוס, משתמשים בפקודה gcloud compute instances get-serial-port-output.

  4. ‫Compute Engine מעצב את השם של הקטגוריה שמכילה את פרטי האבחון בפורמט diagnostic_logs_project_PROJECT_NUMBER. אפשר להציג או להוריד את הקטגוריה באמצעות ה-CLI של gcloud, או במסוףGoogle Cloud מהדף Cloud Storage:

    לאחסון

באופן מקומי (Windows בלבד)

כדי להריץ את כלי האבחון מתוך מכונה וירטואלית של Windows:

  1. מתחברים ל-Windows VM.

  2. פותחים את שורת הפקודה או את החלון של PowerShell עם הרשאות אדמין.

  3. עוברים לספרייה שמכילה את כלי האבחון:

    cd "C:\Program Files\Google\Compute Engine\diagnostics"
    
  4. מפעילים את כלי האבחון:

    .\diagnostics.exe
    

    בסיום ההפעלה של הכלי, נתוני האבחון שנאספו נשמרים בקובץ הדחוס logs.zip בספריית העבודה הנוכחית.

דגלים אופציונליים

  • ‫-trace: מתעד מידע נוסף על המעקב. הכלי מתעד מעקב של 10 דקות אחרי המערכת באמצעות Windows Performance Recorder, שכולל פעילות של המעבד, הדיסק, הקבצים ופעילות ברשת.

צירוף פרטי אבחון לבקשת תמיכה

אם יש לכם בקשת תמיכה פתוחה ב-Cloud Customer Care, אתם יכולים לצרף את פרטי האבחון ישירות לבקשה כשאתם אוספים אותם. כך לא תצטרכו להוריד את הארכיון מ-Cloud Storage ולצרף אותו לבקשת התמיכה בעצמכם.

פרטי האבחון מצורפים לפנייה בלי שלב בדיקה. אם אתם צריכים לבדוק את המידע או להסיר מידע סודי או פרטים אישיים מזהים (PII) לפני השיתוף, אל תשתמשו באפשרות הזו. במקום זאת, אספו את המידע כמו שמתואר במאמר איסוף פרטי אבחון מ-VM, בדקו את הארכיון ב-Cloud Storage ואז צרפו אותו לבקשה.

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

  • לארגון שלכם יש חבילת שירות לקוחות שמאפשרת ליצור בקשות לתמיכה טכנית (תמיכת Standard,‏ Enhanced או Premium).
  • יש לכם את התפקיד "עריכת בקשות לתמיכה טכנית" (roles/cloudsupport.techSupportEditor). אם הבקשה שייכת לארגון, צריך את התפקיד ברמת הארגון.
  • Cloud Support API מופעל בפרויקט.
  • הפנייה פתוחה.

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

  1. מוודאים שהתקנתם את רכיב פקודות אלפא:

    gcloud components install alpha
    
  2. מריצים את הפקודה gcloud alpha compute diagnose export-logs עם הדגל --support-case:

    gcloud alpha compute diagnose export-logs INSTANCE_NAME \
        --zone=ZONE \
        --support-case=CASE_NUMBER
    

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

    • ‫INSTANCE_NAME: השם של מכונת Windows Server.
    • ‫ZONE: האזור של המכונה.
    • ‫CASE_NUMBER: המספר של בקשת תמיכה פתוחה.

    לפני תחילת האיסוף, הפקודה בודקת שהבקשה קיימת ושאפשר להוסיף לה קבצים. לאחר מכן, הסקריפט ממתין עד שהמכונה תסיים לאסוף את נתוני האבחון, פעולה שיכולה להימשך כמה דקות, ומעלה את הארכיון לבקשת התמיכה. הארכיון נשאר בקטגוריה של Cloud Storage, כמו כשמשמיטים את הדגל --support-case.

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