Neste documento, você verá como coletar informações sobre uma instância de máquina virtual (VM) usando uma ferramenta de diagnóstico. Use as informações que as ferramentas coletam 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 especificada.
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:
Revise as informações em busca de informações confidenciais ou de identificação pessoal (PII, na sigla em inglês).
Exclua ou mascare as informações conforme necessário.
Informações de diagnóstico coletadas da VM
Com essa ferramenta de diagnóstico, é possível coletar informações sobre o seguinte:
Discos:
- Informações do objeto Instrumentação de Gerenciamento do Windows (WMI) sobre discos, partições e volumes
Eventos:
- Eventos do Windows:, incluindo eventos do aplicativo e do sistema
Redes:
Programas:
- Informações de objeto do WMI sobre processos, tarefas programadas, serviços e Google Kubernetes Engine (GKE)
Sistema:
- Informações do objeto WMI sobre usuários , configurações do protocolo da área de trabalho remota (RDP, na sigla em inglês) usando este script e a saída dos registros bcdedit, driverquery, msinfo32, pnputil e systeminfo e memory dump
Para informações detalhadas sobre como o Compute Engine coleta essas informações, consulte o repositório público (em inglês).
Limitações
- Só é possível 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
das imagens do Windows Server posteriormente a
v20190714
. Caso contrário, se a versão de imagem do Windows Server for anterior av20190714
ou se você estiver usando uma imagem personalizada, instale a ferramenta usando o comandogooget install google-compute-engine-diagnostics
. -
Configure a autenticação, caso ainda não tenha feito isso.
A autenticação é
o processo de verificação da sua identidade para acesso a serviços e APIs do Google Cloud.
Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no
Compute Engine da seguinte maneira.
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
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
-
roles/iam.serviceAccountTokenCreator
no projeto Conceda o papel
iam.serviceAccountTokenCreator
no projeto:gcloud projects add-iam-policy-binding PROJECT_ID \ --member user:EMAIL \ --role roles/iam.serviceAccountTokenCreator
Substitua:
PROJECT_ID
: o ID do projeto;EMAIL
: endereço de e-mail para conceder o papeliam.serviceAccountTokenCreator
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]
A sinalização
--collect-process-traces
opcional especifica se a ferramenta de diagnóstico coleta um trace de 10 minutos do sistema em execução, o que inclui atividade de CPU, disco, arquivo e rede. Em VMs baseadas em Windows, usa o Gravador de desempenho do Windows.Substitua:
VM_NAME
: nome da VM da qual as informações de diagnóstico serão coletadas;
O processo de exportação de registros pode levar alguns minutos para ser concluído. Veja o status usando o comando
gcloud compute instances get-serial-port-output
.Com o Compute Engine, é possível formatar o nome do bucket que contém as informações de diagnóstico como
diagnostic_logs_project_PROJECT_NUMBER
. Veja ou faça o download do bucket usando agsutil tool
ou, no console do Google Cloud, na página Cloud Storage:Saiba como fazer capturas de tela de VMs.
Saiba como resolver problemas de instâncias do Windows.
Saiba como resolver problemas de RDP.
REST
Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.
Como coletar 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, localize a ferramenta de diagnóstico no diretório
C:\Program Files\Google\Compute Engine\diagnostics
.Permissões exigidas para a tarefa
Para executar esta tarefa, é preciso ter a permissão a seguir:
gcloud
A seguir
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-09-24 UTC.
-