Diagnosedaten erfassen

In diesem Dokument wird beschrieben, wie Sie mithilfe eines Diagnosetools Informationen zu einer VM-Instanz erfassen. Verwenden Sie die von den Tools erfassten Informationen, um grundlegende Fehler zu beheben, bevor Sie sich an Cloud Customer Care wenden.

Das Tool führt folgende Schritte aus:

  • Erfasst nur Informationen von der von Ihnen angegebenen VM.

  • Speichert die Informationen nur in Ihrem Projekt.

  • Die Informationen werden 10 Tage lang in einem Cloud Storage-Bucket gespeichert, auf den standardmäßig nur Sie zugreifen können.

Bevor Sie die erfassten Informationen an den Kundendienst weitergeben, gehen Sie so vor:

  1. Prüfen Sie die Informationen auf vertrauliche oder personenidentifizierbare Informationen.

  2. Löschen oder maskieren Sie die Informationen nach Bedarf.

Hinweis

  • Compute Engine installiert das Diagnosetool standardmäßig auf öffentlichen Versionen von Windows Server-Images, die neuer als v20190714 sind. Andernfalls, wenn Ihre Windows Server-Image-Version älter als v20190714 ist oder Sie ein benutzerdefiniertes Image verwenden, installieren Sie das Tool mit dem Befehl googet install google-compute-engine-diagnostics.
  • Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben. Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Google Cloud Dienste und APIs überprüft. Zum Ausführen von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei der Compute Engine authentifizieren:

    Wählen Sie den Tab für die gewünschte Verwendung der Beispiele auf dieser Seite aus:

    Console

    Wenn Sie über die Google Cloud Console auf Dienste und APIs von Google Cloud zugreifen, müssen Sie die Authentifizierung nicht einrichten.

    gcloud

    1. Installieren Sie die Google Cloud CLI. Initialisieren Sie die Google Cloud CLI nach der Installation mit dem folgenden Befehl: 

      gcloud init

      Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  • Legen Sie eine Standardregion und -zone fest.

Von der VM erfasste Diagnoseinformationen

Das Diagnosetool erfasst Informationen zu folgenden Themen:

Ausführliche Informationen dazu, wie Compute Engine diese Informationen erfasst, finden Sie im öffentlichen GitHub-Repository.

Beschränkungen

  • Sie können Diagnoseinformationen nur von VMs erfassen, die basierend auf Windows Server erstellt wurden.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Ersteller von Dienstkonto-Tokens (roles/iam.serviceAccountTokenCreator) für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Ausführen des Diagnosetools mit der Google Cloud CLI benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Wenn Sie Diagnoseinformationen an eine Supportanfrage anhängen möchten, benötigen Sie außerdem die Rolle „Tech Support Editor“ (roles/cloudsupport.techSupportEditor).

Diagnosedaten von einer VM erfassen

Führen Sie das Diagnosetool entweder direkt auf der VM oder remote über die Google Cloud CLI aus.

gcloud

  1. Weisen Sie dem Nutzerkonto oder Dienstkonto, das den Befehl gcloud compute diagnose export-logs ausführt, die Rolle iam.serviceAccountTokenCreator für das Projekt zu, falls noch nicht geschehen:

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

    Ersetzen Sie Folgendes:

    • PROJECT_ID: die Projekt-ID
    • EMAIL: E-Mail-Adresse, der die Rolle iam.serviceAccountTokenCreator zugewiesen werden soll.

  2. Exportieren Sie die Diagnoseinformationen mit dem Befehl diagnose export-logs als Objekt in einen Cloud Storage-Bucket.

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

    Das optionale Flag --collect-process-traces gibt an, ob das Diagnosetool einen 10-Minuten-Trace des laufenden Systems erfasst, einschließlich CPU-, Laufwerks-, Datei- und Netzwerkaktivität. Auf Windows-basierten VMs wird dafür der Windows Performance Recorder verwendet.

    Ersetzen Sie VM_NAME durch den Namen der VM, von der Diagnoseinformationen erfasst werden sollen.

  3. Der Logexport kann einige Minuten dauern. Rufen Sie den Status mit dem Befehl gcloud compute instances get-serial-port-output auf.

  4. Compute Engine formatiert den Namen des Buckets mit den Diagnoseinformationen als diagnostic_logs_project_PROJECT_NUMBER. Sie können den Bucket mit der gcloud CLI oder in derGoogle Cloud Console über die Seite Cloud Storage ansehen oder herunterladen:

    „Speicherplatz“ öffnen

Lokal (nur Windows)

So führen Sie das Diagnosetool auf einer Windows-VM aus:

  1. Stellen Sie eine Verbindung zur Windows-VM her.

  2. Öffnen Sie eine Eingabeaufforderung oder ein PowerShell-Fenster mit Administratorberechtigungen.

  3. Wechseln Sie zu dem Verzeichnis, das das Diagnosetool enthält:

    cd "C:\Program Files\Google\Compute Engine\diagnostics"

  4. Diagnosetool ausführen:

    .\diagnostics.exe

    Nachdem das Tool ausgeführt wurde, werden die erfassten Diagnoseinformationen in der komprimierten Datei logs.zip in Ihrem aktuellen Arbeitsverzeichnis gespeichert.

Optionale Flags

  • -trace: Erfasst zusätzliche Tracing-Informationen. Das Tool erfasst mit dem Windows Performance Recorder einen 10-minütigen Trace des Systems, der CPU-, Laufwerks-, Datei- und Netzwerkaktivitäten umfasst.

Diagnoseinformationen an eine Supportanfrage anhängen

Wenn Sie einen offenen Fall bei Cloud Customer Care haben, können Sie Diagnoseinformationen direkt an den Fall anhängen, wenn Sie sie erfassen. So müssen Sie das Archiv nicht aus Cloud Storage herunterladen und selbst an die Anfrage anhängen.

Die Diagnoseinformationen werden ohne Überprüfungsschritt an den Fall angehängt. Wenn Sie die Informationen prüfen oder vertrauliche oder personenidentifizierbare Informationen entfernen müssen, bevor Sie sie weitergeben, sollten Sie diese Option nicht verwenden. Erfassen Sie stattdessen die Informationen wie unter Diagnosedaten von einer VM erfassen beschrieben, prüfen Sie das Archiv in Cloud Storage und hängen Sie es dann an den Fall an.

Bevor Sie Diagnoseinformationen an eine Supportanfrage anhängen, sollten Sie Folgendes beachten:

  • Ihre Organisation hat einen Customer Care-Tarif, mit dem Sie technische Supportanfragen erstellen können (Standardsupport, erweiterter Support oder Premium-Support).
  • Sie haben die Rolle „Technischer-Support-Bearbeiter“ (roles/cloudsupport.techSupportEditor). Wenn die Anfrage zu einer Organisation gehört, benötigen Sie die Rolle für die Organisation.
  • Die Cloud Support API ist im Projekt aktiviert.
  • Der Fall ist offen.

So hängen Sie Diagnoseinformationen an eine Supportanfrage an:

  1. Prüfen Sie, ob die Komponente Alpha-Befehle installiert ist:

    gcloud components install alpha

  2. Führen Sie den Befehl gcloud alpha compute diagnose export-logs mit dem Flag --support-case aus.

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

    Ersetzen Sie Folgendes:

    • INSTANCE_NAME: der Name der Windows Server-Compute-Instanz.
    • ZONE ist die Zone der Instanz.
    • CASE_NUMBER: die Nummer einer offenen Supportanfrage.

    Mit dem Befehl wird geprüft, ob die Anfrage vorhanden ist und ob Sie Anhänge hinzufügen können, bevor die Erfassung beginnt. Anschließend wird gewartet, bis die Instanz die Diagnoseinformationen erfasst hat. Das kann einige Minuten dauern. Danach wird das Archiv in den Fall hochgeladen. Das Archiv verbleibt auch im Cloud Storage-Bucket, genau wie wenn Sie das Flag --support-case weglassen.

Nächste Schritte