Coletando informações de diagnóstico

Este documento descreve como coletar informações sobre uma instância de máquina virtual (VM) usando uma ferramenta de diagnóstico. Use as informações coletadas pelas ferramentas para ajudar na solução de problemas básicos antes de entrar em contato com o suporte .

A ferramenta faz o seguinte:

  • Coleta informações somente da VM que você especifica.

  • Armazena as informações apenas no seu projeto.

  • Armazena as informações por 10 dias em um bucket do Cloud Storage , que, por padrão, somente você pode acessar.

Antes de compartilhar as informações coletadas com o Suporte do Google, faça o seguinte:

  1. Revise as informações em busca de informações confidenciais ou de identificação pessoal (PII).

  2. Exclua ou mascare as informações conforme necessário.

Informações de diagnóstico coletadas da VM

Esta ferramenta de diagnóstico coleta informações sobre o seguinte:

Para informações detalhadas sobre como o Compute Engine coleta essas informações, consulte o repositório público .

Limitações

  • Você só pode coletar informações de diagnóstico de VMs criadas com base no Windows Server.

Antes de começar

  • O Compute Engine instala a ferramenta de diagnóstico por padrão em versões públicas de imagens do Windows Server posteriores à v20190714 . Caso contrário, se a versão da imagem do Windows Server for anterior a v20190714 ou se você estiver usando uma imagem personalizada, instale a ferramenta usando o comando googet install google-compute-engine-diagnostics .
  • Se ainda não o fez, configure a autenticação. Autenticação é o processo pelo qual sua identidade é verificada para acesso a Google Cloud serviços e APIs. Para executar códigos ou amostras em um ambiente de desenvolvimento local, você pode se autenticar no Compute Engine selecionando uma das seguintes opções:

    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. After installing the Google Cloud CLI, initialize it by running the following command: 

      gcloud init

      If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

    2. Set a default region and zone.

      3. REST

      Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.

        After installing the Google Cloud CLI, initialize it by running the following command: 

        gcloud init

        If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

      Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.

Coletando informações de diagnóstico de uma VM

Execute a ferramenta de diagnóstico diretamente da VM ou remotamente usando a CLI do Google Cloud. Em VMs baseadas no Windows, encontre a ferramenta de diagnóstico no diretório C:\Program Files\Google\Compute Engine\diagnostics .

Permissões necessárias para esta tarefa

Para executar esta tarefa, você deve ter as seguintes permissões :

  • roles/iam.serviceAccountTokenCreator no projeto

gcloud

  1. Conceda o papel iam.serviceAccountTokenCreator no projeto:

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

    Substitua o seguinte:

    • PROJECT_ID : o ID do projeto
    • EMAIL : o endereço de e-mail para conceder a função iam.serviceAccountTokenCreator

  2. Exporte as informações de diagnóstico como um objeto para um bucket do Cloud Storage.

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

    O sinalizador opcional --collect-process-traces especifica se a ferramenta de diagnóstico coleta um rastreamento de 10 minutos do sistema em execução, que inclui atividade de CPU, disco, arquivo e rede. Em VMs baseadas no Windows, isso usa o Windows Performance Recorder .

    Substitua o seguinte:

    • VM_NAME : nome da VM da qual coletar informações de diagnóstico

  3. O processo de exportação de log pode levar alguns minutos para ser concluído. Visualize o status usando o comando gcloud compute instances get-serial-port-output .

  4. O Compute Engine formata o nome do bucket que contém as informações de diagnóstico como diagnostic_logs_project_ PROJECT_NUMBER . Visualize ou faça download do bucket usando a CLI gcloud ou, no console do Google Cloud, na página do Cloud Storage :

    Vá para armazenamento

O que vem a seguir