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 clienti Google Cloud, 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 clienti, 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.

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 ad API e servizi Google Cloud . Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine selezionando una delle seguenti opzioni:

    Seleziona la scheda relativa a come prevedi di utilizzare i campioni in questa pagina:

    Console

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

    gcloud

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

      gcloud init

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

  • Imposta una regione e una zona predefinite.

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 GitHub pubblico.

Limitazioni

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

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per eseguire lo strumento di diagnostica utilizzando Google Cloud CLI, chiedi all'amministratore di concederti il ruolo IAM Service Account Token Creator (roles/iam.serviceAccountTokenCreator) sul tuo progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Raccolta delle informazioni diagnostiche da una VM

Esegui lo strumento di diagnostica direttamente dalla VM o da remoto utilizzando Google Cloud CLI.

gcloud

  1. Se non l'hai ancora fatto, concedi il ruolo iam.serviceAccountTokenCreator nel progetto all'account utente o al account di servizio che eseguirà il comando gcloud compute diagnose export-logs:

    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 utilizzando il comando diagnose export-logs.

    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 VM_NAME con il nome della VM da cui raccogliere le informazioni diagnostiche.

  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

Localmente (solo Windows)

Per eseguire lo strumento di diagnostica da una VM Windows:

  1. Connettiti alla VM Windows.

  2. Apri una finestra del prompt dei comandi o di PowerShell con privilegi di amministratore.

  3. Vai alla directory contenente lo strumento di diagnostica:

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

  4. Esegui lo strumento di diagnostica:

    .\diagnostics.exe

    Al termine dell'esecuzione, lo strumento salva le informazioni diagnostiche raccolte nel file compresso logs.zip nella directory di lavoro corrente.

Flag facoltativi

  • -trace: acquisisce ulteriori informazioni di tracciamento. Lo strumento acquisisce una traccia di 10 minuti del sistema utilizzando Windows Performance Recorder, che include l'attività della CPU, del disco, dei file e della rete.

Passaggi successivi