A recolher informações de diagnóstico

Este documento descreve como recolher informações sobre uma instância de máquina virtual (VM) através de uma ferramenta de diagnóstico. Use as informações recolhidas pelas ferramentas para ajudar na resolução de problemas básicos antes de contactar o apoio técnico.

A ferramenta faz o seguinte:

  • Recolhe informações apenas da VM que especificar.

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

  • Armazena as informações durante 10 dias num contentor do Cloud Storage, ao qual, por predefinição, só o utilizador pode aceder.

Antes de partilhar as informações recolhidas com o apoio técnico da Google, faça o seguinte:

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

  2. Elimine ou oculte as informações conforme necessário.

Informações de diagnóstico recolhidas da VM

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

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

Limitações

  • Só pode recolher 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 predefinição em versões públicas de imagens do Windows Server posteriores a v20190714. Caso contrário, se a versão da imagem do Windows Server for anterior a v20190714 ou estiver a usar uma imagem personalizada, instale a ferramenta através do comando googet install google-compute-engine-diagnostics.
  • Se ainda não o tiver feito, configure a autenticação. A autenticação valida a sua identidade para aceder a Google Cloud serviços e APIs. Para executar código ou exemplos a partir de um ambiente de desenvolvimento local, pode autenticar-se 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. Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: 

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

    2. Set a default region and zone.

    REST

    Para usar os exemplos da API REST nesta página num ambiente de desenvolvimento local, usa as credenciais que fornece à CLI gcloud.

      Instale a CLI Google Cloud. Após a instalação, inicialize a CLI gcloud executando o seguinte comando: 

      gcloud init

      Se estiver a usar um fornecedor de identidade (IdP) externo, primeiro tem de iniciar sessão na CLI gcloud com a sua identidade federada.

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

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

Execute a ferramenta de diagnóstico diretamente a partir da VM ou remotamente através da 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.

Autorizações necessárias para esta tarefa

Para realizar esta tarefa, tem de ter as seguintes autorizações:

  • roles/iam.serviceAccountTokenCreator no projeto

gcloud

  1. Conceda a função de 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 email ao qual conceder a função de iam.serviceAccountTokenCreator

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

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

    A flag --collect-process-traces opcional especifica se a ferramenta de diagnóstico recolhe um rastreio de 10 minutos do sistema em execução, que inclui a atividade da CPU, do disco, dos ficheiros e da rede. Em VMs baseadas no Windows, isto usa o Windows Performance Recorder.

    Substitua o seguinte:

    • VM_NAME: nome da VM a partir da qual recolher informações de diagnóstico

  3. O processo de exportação de registos pode demorar alguns minutos a ser concluído. Veja o estado através do comando gcloud compute instances get-serial-port-output.

  4. O Compute Engine formata o nome do contentor que contém as informações de diagnóstico como diagnostic_logs_project_PROJECT_NUMBER. Veja ou transfira o contentor através da CLI gcloud ou, na Google Cloud consola, na página Cloud Storage:

    Aceda ao armazenamento

O que se segue?