Raccolta delle informazioni diagnostiche

Questo documento descrive come raccogliere informazioni sull'istanza di una macchina virtuale (VM) utilizzando uno strumento di diagnostica. Utilizza le informazioni raccolte dagli strumenti per facilitare la risoluzione dei problemi di base prima di contattare l'assistenza.

Lo strumento svolge le seguenti operazioni:

  • Raccoglie informazioni solo dalla VM che hai specificato.

  • Archivia le informazioni solo nel tuo progetto.

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

Prima di condividere le informazioni raccolte con l'Assistenza Google:

  1. Controlla le informazioni per verificare la presenza di informazioni riservate o che consentono l'identificazione personale (PII).

  2. Elimina o maschera le informazioni in base alle esigenze.

Informazioni diagnostiche raccolte dalla VM

Questo strumento di diagnostica raccoglie informazioni su:

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

  • Compute Engine installa lo strumento di diagnostica per impostazione predefinita sulle versioni pubbliche delle immagini Windows Server successive al giorno v20190714. Altrimenti, se la versione dell'immagine di Windows Server è precedente alla v20190714 o se utilizzi un'immagine personalizzata, installa lo strumento usando il comando googet install google-compute-engine-diagnostics.
  • Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale viene verificata l'identità per l'accesso ai servizi e alle API Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti in Compute Engine nel seguente modo.

    Seleziona la scheda relativa a come prevedi di utilizzare gli esempi in questa pagina:

    Console

    Quando utilizzi la console Google Cloud per accedere ai servizi e alle API di Google Cloud, non devi configurare l'autenticazione.

    gcloud

    1. Installa Google Cloud CLI, quindi initialize eseguendo questo comando: 

      gcloud init
    2. Imposta una regione e una zona predefinite.

    REST

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

      Installa Google Cloud CLI, quindi initialize eseguendo questo comando: 

      gcloud init

Raccolta di informazioni diagnostiche da una VM

Esegui lo strumento di diagnostica direttamente dalla VM o da remoto utilizzando Google Cloud CLI. Sulle VM basate su Windows, trova 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 nel 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 diagnostiche 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 CPU, disco, file e attività di rete. Nelle VM basate su Windows viene utilizzato il Registratore delle prestazioni di Windows.

    Sostituisci quanto segue:

    • VM_NAME: nome della VM da cui raccogliere informazioni diagnostiche

  3. Il 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 gsutil tool oppure, nella console Google Cloud, dalla pagina Cloud Storage:

    Vai ad Spazio di archiviazione

Passaggi successivi