Raccolta delle informazioni diagnostiche

Questo documento descrive come raccogliere informazioni su un'istanza di macchine virtuali (VM) utilizzando uno strumento di diagnostica. Prima di contattare l'assistenza, utilizza le informazioni raccolte dagli strumenti per la risoluzione di problemi di base.

Lo strumento esegue le seguenti operazioni:

  • Raccoglie informazioni solo dalla VM specificata.

  • Memorizza le informazioni solo nel tuo progetto.

  • Memorizza le informazioni per 10 giorni in un bucket Cloud Storage a cui, per impostazione predefinita, solo tu puoi accedere.

Prima di condividere le informazioni raccolte con l'Assistenza Google, segui questi passaggi:

  1. Esamina le informazioni relative a informazioni riservate o che consentono l'identificazione personale (PII).

  2. Se lo ritieni necessario, elimina o maschera le informazioni.

Informazioni diagnostiche raccolte dalla VM

Questo strumento di diagnostica raccoglie informazioni su quanto segue:

Per informazioni dettagliate su come Compute Engine raccoglie queste informazioni, consulta il repository pubblico.

Limitazioni

  • Puoi raccogliere informazioni diagnostiche solo dalle VM create in base a Windows Server.

Prima di iniziare

  • Per impostazione predefinita, Compute Engine installa lo strumento di diagnostica sulle versioni pubbliche delle immagini Windows Server successive a v20190714. In caso contrario, se la versione dell'immagine Windows Server è precedente a v20190714 o se utilizzi un'immagine personalizzata, installa lo strumento utilizzando il comando googet install google-compute-engine-diagnostics.
  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione verifica la tua identità per l'accesso a Google Cloud servizi e API. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il seguente comando: 

      gcloud init

      Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

    2. Set a default region and zone.

    REST

    Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali che fornisci a gcloud CLI.

      Installa Google Cloud CLI. Dopo l'installazione, inizializza Google Cloud CLI eseguendo il seguente comando: 

      gcloud init

      Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

    Per saperne di più, consulta Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .

Raccolta delle informazioni diagnostiche da una VM

Esegui lo strumento di diagnostica direttamente dalla VM o da remoto utilizzando Google Cloud CLI. Nelle VM basate su Windows, individua lo strumento di diagnostica nella directory C:\Program Files\Google\Compute Engine\diagnostics.

Autorizzazioni richieste per questa attività

Per eseguire questa attività, devi disporre delle seguenti autorizzazioni:

  • roles/iam.serviceAccountTokenCreator sul progetto

gcloud

  1. Concedi il ruolo iam.serviceAccountTokenCreator sul progetto:

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

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID progetto
    • EMAIL: l'indirizzo email a cui concedere il ruolo iam.serviceAccountTokenCreator

  2. Esporta le informazioni di diagnostica come oggetto in un bucket Cloud Storage.

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

    Il flag facoltativo --collect-process-traces specifica se lo strumento di diagnostica raccoglie una traccia di 10 minuti del sistema in esecuzione, che include l'attività della CPU, del disco, dei file e della rete. Sulle VM basate su Windows, questo utilizza Windows Performance Recorder.

    Sostituisci quanto segue:

    • VM_NAME: il nome della VM da cui raccogliere le informazioni di diagnostica

  3. Il completamento del processo di esportazione dei log potrebbe richiedere alcuni minuti. Visualizza lo stato utilizzando il comando gcloud compute instances get-serial-port-output.

  4. Compute Engine formatta il nome del bucket contenente le informazioni di diagnostica come diagnostic_logs_project_PROJECT_NUMBER. Visualizza o scarica il bucket utilizzando gcloud CLI o, nella consoleGoogle Cloud , dalla pagina Cloud Storage:

    Vai ad Archiviazione.

Passaggi successivi