Encontre informações de resolução de problemas do Ops Agent

Este documento descreve as origens de informações de diagnóstico que pode usar para identificar problemas na instalação ou na execução do agente de operações.

Valide o estado do agente através do gcpdiag

Pode usar o gcpdiag para comunicar o estado do agente de operações em VMs individuais ou em toda a frota de VMs no seu projeto, confirmando que o agente está instalado e a enviar ativamente registos e métricas. O gcpdiag pode criar relatórios de estado em vários formatos, incluindo CSV ou JSON.

O exemplo seguinte mostra um relatório do estado do agente ao nível da frota no formato CSV:

🔎 gce/ERR/2024_004: Verify Ops Agent is installed on GCE VMs and is sending logs and metrics.

gce/ERR/2024_004,projects/my-project/zones/my-location/instances/instance-1,failed,Ops Agent not installed on the VM,https://gcpdiag.dev/rules/gce/ERR/2024_004
gce/ERR/2024_004,projects/my-project/zones/my-location/instances/instance-2,skipped,VM Manager is needed for the ops agent detection. Please enable it at: https://cloud.google.com/compute/docs/manage-os#automatic and run this check again.,https://gcpdiag.dev/rules/gce/ERR/2024_004
gce/ERR/2024_004,projects/my-project/zones/my-location/instances/instance-3,skipped,VM Manager is needed for the ops agent detection. Please enable it at: https://cloud.google.com/compute/docs/manage-os#automatic and run this check again.,https://gcpdiag.dev/rules/gce/ERR/2024_004
gce/ERR/2024_004,projects/my-project/zones/my-location/instances/instance-4,ok,"Ops Agent installed on the VM, and is successfully sending logs and metrics.",https://gcpdiag.dev/rules/gce/ERR/2024_004
gce/ERR/2024_004,projects/my-project/zones/my-location/instances/instance-5,ok,"Ops Agent installed on the VM, and is successfully sending logs and metrics.",https://gcpdiag.dev/rules/gce/ERR/2024_004

A ferramenta gcpdiag foi criada pelo Google Cloud apoio técnico para ajudar a autodiagnosticar problemas comuns no seu Google Cloud projeto, incluindo problemas com o agente Ops. O gcpdiag é uma ferramenta de código aberto, não um produto Google Cloud oficial, mas é ativamente desenvolvido e mantido pela equipa de Google Cloud apoio técnico. Contribua ou comunique problemas no GitHub.

Antes de começar

O gcpdiag está integrado com o Cloud Shell, pelo que pode executá-lo sem necessidade de instalação. Para executar o gcpdiag, tem de cumprir os seguintes pré-requisitos:

• Autorização: o gcpdiag usa as Credenciais padrão da aplicação (ADC) na Cloud Shell para autenticar.
  Certifique-se de que as credenciais usadas com o gcpdiag têm, pelo menos, as seguintes funções no Google Cloud projeto onde o agente de operações está a ser executado:

  • Leitor (roles/viewer)
  • Consumidor de utilização de serviços (roles/serviceusage.serviceUsageConsumer)

• APIs: para usar o gcpdiag num projeto, as seguintes APIs têm de estar ativadas:

  • Cloud Resource Manager API: cloudresourcemanager.googleapis.com
  • API Identity and Access Management: iam.googleapis.com
  • Cloud Logging API: logging.googleapis.com
  • Utilização do serviço: serviceusage.googleapis.com

  Para ativar estas APIs, execute o seguinte comando no Cloud Shell ou noutra linha de comandos:

   gcloud --project=PROJECT_ID services enable \
     cloudresourcemanager.googleapis.com \
     iam.googleapis.com \
     logging.googleapis.com \
     serviceusage.googleapis.com
  

• VM Manager: ative o VM Manager no nível gratuito na sua instância. Se instalou o Agente de operações durante a criação da VM ou se uma política de agente gerir a instalação do Agente de operações nas suas instâncias de VM, já cumpriu os requisitos para o VM Manager.

Execute o gcpdiag

O comando gcpdiag para utilização com o agente de operações tem a seguinte sintaxe básica:

gcpdiag lint --project=PROJECT_ID [--name=INSTANCE_NAME] --show-skipped --include=gce/err/2024_004 [--output=[CSV|JSON]]

• PROJECT_ID é o ID do seu Google Cloud projeto.
• INSTANCE_NAME é o nome da sua VM do Compute Engine. Use a opção --name para consultar uma VM específica; omita a opção para consultar toda a frota.
• Use a opção --output para guardar o relatório num ficheiro com o formato CSV ou JSON; omita a opção se não quiser um ficheiro de saída.

O valor da opção --include especifica uma ou mais regras do gcpdiag; gce/ERR/2024-004 é a regra para o agente de operações. Para mais informações sobre a sintaxe do comando gcpdiag, consulte gcpdiag – Diagnósticos para a Google Cloud plataforma.

Por exemplo, para gerar um relatório ao nível da frota para o projeto "my-project", execute o seguinte comando:

gcpdiag lint --project=my-project --show-skipped --include=gce/ERR/2024_004

O resultado é semelhante ao seguinte:

🔎 gce/ERR/2024_004: Verify Ops Agent is installed on GCE VMs and is sending logs and metrics.
  - my-project/instance-1                                                 [FAIL] Ops Agent not installed on the VM
  - my-project/instance-2                                                 [FAIL] Ops Agent not installed on the VM
  - my-project/instance-3                                                 [SKIP] Unable to confirm Ops Agent installation
  VM Manager is needed for the ops agent detection. Please enable it at: https://cloud.google.com/compute/docs/manage-os#automatic and run this check again.
  - my-project/instance-4                                            [FAIL] Ops Agent is installed, but it's failing to send both logs and metrics to Google Cloud.
  Is Ops Agent sending logs? (Yes)  Is Ops Agent sending metrics? (No)
  - my-project/instance-5                                                 [FAIL] Ops Agent is installed, but it's failing to send both logs and metrics to Google Cloud.
  Is Ops Agent sending logs? (No)   Is Ops Agent sending metrics? (No)
  - my-project/instance-6                                                 [ OK ] Ops Agent installed on the VM, and is successfully sending logs and metrics.
  - my-project/instance-7                                                 [ OK ] Ops Agent installed on the VM, and is successfully sending logs and metrics.

Para gerar um relatório para a instância "my-instance" no projeto "my-project", execute o seguinte comando:

gcpdiag lint  --project=my-project --name=my-instance --show-skipped --include=gce/err/2024_004

O resultado é semelhante ao seguinte:

🔎 gce/ERR/2024_004: Verify Ops Agent is installed on GCE VMs and is sending logs and metrics.
  - my-project/my-instance   [ OK ] Ops Agent installed on the VM, and is successfully sending logs and metrics.

Se o comando gcpdiag falhar com um resultado semelhante ao seguinte, verifique se cumpriu todos os pré-requisitos para executar a ferramenta.

WARNING:googleapiclient.http:Encountered 403 Forbidden with reason "PERMISSION_DENIED"
[ERROR]:can't access project my-project: Cloud Resource Manager API has not been used in project my-project before or it is disabled. Enable it by visiting https://console.developers.google.com/apis/api/cloudresourcemanager.googleapis.com/overview?project=my-project then retry. If you enabled this API recently, wait a few minutes for the action to propagate to our systems and retry..
[DEBUG]: An Http Error occurred whiles accessing projects.get

HttpError 403 when requesting https://cloudresourcemanager.googleapis.com/v3/projects/my-project?alt=json returned Cloud Resource Manager API has not been used in project my-project before or it is disabled. Enable it by visiting https://console.developers.google.com/apis/api/cloudresourcemanager.googleapis.com/overview?project=my-project then retry. If you enabled this API recently, wait a few minutes for the action to propagate to our systems and retry. Details: ...
[ERROR]:exiting program...
error getting project details

Interprete o resultado do gcpdiag

Esta secção fornece informações para ajudar a compreender e usar os relatórios gerados pelo gcpdiag.

O comando gcpdiag gera relatórios que contêm as seguintes informações:

• Um indicador da regra gcpdiag com a qual o comando foi invocado. Para o Ops Agent, estas informações têm o seguinte aspeto:
  🔎 gce/ERR/2024_004: Verify Ops Agent is installed on GCE VMs and is sending logs and metrics
• Um identificador do resultado para uma VM específica com o formato PROJECT_ID/INSTANCE_ID. Para um relatório ao nível da frota, a saída contém uma entrada para cada VM. Para um relatório de uma única MV, o resultado contém uma única entrada.
• O estado da verificação. O estado tem um dos seguintes valores:
  • OK
  • FAIL
  • SKIP
• Uma descrição do valor do estado.

As secções seguintes fornecem mais informações sobre os valores de estado e o respetivo significado.

Estado: OK

Um estado de OK significa que o agente de operações está a ser executado na VM e a enviar registos e métricas da VM. O relatório inclui a seguinte descrição do estado:
Ops Agent installed on the VM, and is successfully sending logs and metrics.

Estado: FAIL

Um estado de FAIL significa que o agente de operações não está instalado ou que não está a enviar registos nem métricas da VM. A descrição do estado indica o problema que foi detetado:

• Se o agente de operações não estiver instalado, é apresentada a seguinte descrição do estado:
  Ops Agent not installed on the VM
• Se o agente de operações não estiver a enviar registos nem métricas da VM, é apresentada uma descrição do estado semelhante à seguinte:
  Agent is installed, but it's failing to send both logs and metrics to Google Cloud.
Is Ops Agent sending logs? (Yes) Is Ops Agent sending metrics? (No)

Se o agente Ops não estiver instalado, instale o agente Ops. Se a instalação falhar, o problema pode dever-se a um dos seguintes motivos:

• A VM não tem uma conta de serviço associada. Para resolver este problema, anexe uma conta de serviço à VM e, em seguida, tente instalar novamente o agente de operações.
• A VM tem um dos agentes antigos (o agente de monitorização ou o agente de registo) já instalado. Para resolver este problema, desinstale os agentes antigos e, em seguida, tente instalar novamente o agente Ops.

Se o agente de operações não estiver a enviar registos nem métricas da VM, use as verificações de funcionamento do agente para erros de hora de início para determinar e corrigir o problema.

Estado: SKIP

Um estado de SKIP significa que o gcpdiag não conseguiu determinar se o agente de operações está instalado na VM. O relatório inclui a seguinte descrição do estado:
Unable to confirm Ops Agent installation
  VM Manager is needed for the ops agent detection.
  Please enable it at: https://cloud.google.com/compute/docs/manage-os#automatic and run this check again.

Para testar o estado do agente, o gcpdiag precisa que o VM Manager esteja em execução na sua VM. Para resolver este problema, instale o nível gratuito do VM Manager na sua instância. Após a instalação, aguarde 15 minutos e, de seguida, tente executar novamente o comando gcpdiag.

Verificações de funcionamento do agente

A versão 2.25.1 introduziu verificações de funcionamento da hora de início para o agente de operações. Quando o agente de operações é iniciado, executa uma série de verificações de condições que impedem a execução correta do agente. Se o agente detetar uma das condições, regista uma mensagem a descrever o problema. O Ops Agent verifica o seguinte:

• Problemas de conetividade
• Disponibilidade de portas usadas pelo agente para comunicar métricas sobre si próprio
• Problemas de autorização
• Disponibilidade das APIs usadas pelo agente para escrever registos ou métricas
• Um problema na própria rotina de verificação de funcionamento.

Para obter informações sobre como localizar erros de hora de início, consulte o artigo Encontre erros de hora de início.

A versão 2.37.0 introduziu verificações de funcionamento em tempo de execução para o agente de operações. Estes erros são comunicados ao Cloud Logging e ao Error Reporting. Para obter informações sobre como localizar erros de tempo de execução, consulte o artigo Encontre erros de tempo de execução.

A versão 2.46.0 introduziu o código LogPingOpsAgent informativo. Este código não representa um erro. Para mais informações, consulte o artigo Valide a recolha de registos bem-sucedida.

A tabela seguinte apresenta cada código de verificação de estado por ordem alfabética e descreve o que cada código significa. Os códigos que terminam com a string Err indicam erros; outros códigos são informativos.

Código de verificação de funcionamento	Categoria	Significado	Sugestão
DLApiConnErr	Conetividade	O pedido ao subdomínio de transferências, dl.google.com, falhou.	Verifique a sua ligação à Internet e as regras da firewall. Para mais informações, consulte a secção Problemas de conetividade de rede.
FbMetricsPortErr	Disponibilidade de portas	A porta 20202, necessária para as métricas automáticas do agente de operações, está indisponível.	Verifique se a porta 20202 está aberta. Para mais informações, consulte o artigo A porta necessária não está disponível.
HcFailureErr	Generic	A rotina de verificação do estado do agente de operações encontrou um erro interno.	Envie um registo de apoio ao cliente a partir da Google Cloud consola. Para mais informações, consulte a secção Obter apoio técnico.
LogApiConnErr	Conetividade	O pedido à API Logging falhou.	Verifique a sua ligação à Internet e as regras da firewall. Para mais informações, consulte a secção Problemas de conetividade de rede.
LogApiDisabledErr	API	A API Logging está desativada no projeto Google Cloud atual.	Ative a API Logging.
LogApiPermissionErr	Autorização	A conta de serviço não tem a função Logs Writer (roles/logging.logWriter).	Conceda a função de escritor de registos à conta de serviço. Para mais informações, consulte o artigo O agente não tem autorizações da API.
LogApiScopeErr	Autorização	A VM não tem o âmbito de acesso https://www.googleapis.com/​auth/​logging.write.	Adicione o âmbito https://www.googleapis.com/​auth/​logging.write à VM. Para mais informações, consulte o artigo Valide os seus âmbitos de acesso.
LogApiUnauthenticatedErr	API	Não foi possível autenticar a VM atual na API Logging.	Verifique se os ficheiros de credenciais, os âmbitos de acesso da VM e as autorizações estão configurados corretamente. Para mais informações, consulte o artigo Autorize o agente de operações.
LogPingOpsAgent		Uma mensagem de payload informativa escrita a cada 10 minutos no registo ops-agent-health. Pode usar as entradas de registo resultantes para verificar se o agente está a enviar registos. Esta mensagem não é um erro.	Esta mensagem deve aparecer a cada 10 minutos. Se a mensagem não aparecer durante 20 minutos ou mais, significa que o agente pode ter encontrado um problema. Para informações sobre a resolução de problemas, consulte o artigo Resolva problemas do agente de operações.
LogParseErr	Tempo de execução	O agente de operações não conseguiu analisar um ou mais registos.	Verifique a configuração de todos os processadores de registo que criou. Para mais informações, consulte o artigo Erros de análise de registos.
LogPipeLineErr	Tempo de execução	O pipeline de registo do agente de operações falhou.	Confirme que o agente tem acesso aos ficheiros de buffer; verifique se o disco está cheio e confirme que a configuração do agente de operações está correta. Para mais informações, consulte o artigo Erros de pipeline.
MetaApiConnErr	Conetividade	O pedido ao servidor de metadados do G​C​E, para consultar âmbitos de acesso da VM, tokens OAuth e etiquetas de recursos, falhou.	Verifique a sua ligação à Internet e as regras da firewall. Para mais informações, consulte a secção Problemas de conetividade de rede.
MonApiConnErr	Conetividade	Um pedido à API Monitoring falhou.	Verifique a sua ligação à Internet e as regras da firewall. Para mais informações, consulte a secção Problemas de conetividade de rede.
MonApiDisabledErr	API	A API Monitoring está desativada no projeto Google Cloud atual.	Ative a API Monitoring.
MonApiPermissionErr	Autorização	A conta de serviço não tem a função de escritor de métricas do Monitoring (roles/monitoring.metricWriter).	Conceda a função de escritor de métricas de monitorização à conta de serviço. Para mais informações, consulte o artigo O agente não tem autorizações da API.
MonApiScopeErr	Autorização	A VM não tem o âmbito de acesso https://www.googleapis.com/​auth/​monitoring.write.	Adicione o âmbito https://www.googleapis.com/​auth/​monitoring.write à VM. Para mais informações, consulte o artigo Valide os seus âmbitos de acesso.
MonApiUnauthenticatedErr	API	Não foi possível autenticar a VM atual na API Monitoring.	Verifique se os ficheiros de credenciais, os âmbitos de acesso da VM e as autorizações estão configurados corretamente. Para mais informações, consulte o artigo Autorize o agente de operações.
OtelMetricsPortErr	Disponibilidade de portas	A porta 20201, necessária para as métricas automáticas do agente de operações, não está disponível.	Verifique se a porta 20201 está aberta. Para mais informações, consulte Uma porta necessária não está disponível.
PacApiConnErr	Conetividade	Este código de verificação do estado de funcionamento não é fiável. Este código está desativado na versão 2.46.1 do agente de operações.	Atualize para a versão 2.46.1 ou superior do agente Ops.

Encontre erros de hora de início

A partir da versão 2.35.0, as informações de verificação do estado são escritas no registo ops-agent-health pela API Cloud Logging (as versões 2.33.0 e 2.34.0 usam ops-agent-health-checks). As mesmas informações também são escritas num ficheiro health-checks.log da seguinte forma:

• Linux: /var/log/google-cloud-ops-agent/health-checks.log
• Windows: C:\ProgramData\Google\Cloud Operations\Ops Agent\log\health-checks.log

Também pode ver quaisquer mensagens de verificação de estado consultando o estado do serviço do agente de operações da seguinte forma:

• No Linux, execute o seguinte comando:

     sudo systemctl status google-cloud-ops-agent"*"
     

  Procure mensagens como "[Ports Check] Result: PASS". Outros resultados incluem "ERROR" e "FAIL".

• No Windows, use o Event Viewer do Windows. Procure mensagens de "Informação", "Erro" ou "Falha" associadas ao serviço google-cloud-ops-agent.

Depois de resolver os problemas, tem de reiniciar o agente. As verificações de estado são executadas quando o agente é iniciado. Por isso, para executar novamente as verificações, tem de reiniciar o agente.

Encontre erros de tempo de execução

As verificações de estado de funcionamento do tempo de execução são comunicadas ao Cloud Logging e ao Error Reporting. Se o agente não tiver sido iniciado, mas tiver conseguido comunicar erros antes de falhar, também pode ver erros de hora de início comunicados.

Para ver erros de tempo de execução do agente de operações no Logging, faça o seguinte:

1. Na Google Cloud consola, aceda à página Explorador de registos:

   Aceda ao Explorador de registos

   Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cuja legenda é Registo.

2. Introduza a seguinte consulta e clique em Executar consulta:
   

   log_id("ops-agent-health")

Para ver erros de tempo de execução do agente de operações nos relatórios de erros, faça o seguinte:

1. Na Google Cloud consola, aceda à página Error Reporting:

   Aceda a Error Reporting

   Também pode encontrar esta página através da barra de pesquisa.

2. Para ver os erros do agente de operações, filtre os erros por Ops Agent.

Valide a recolha de registos bem-sucedida

A versão 2.46.0 do agente de operações introduziu a verificação de funcionamento LogPingOpsAgent informativa. Esta verificação escreve uma mensagem informativa no ops-agent-health a cada 10 minutos. Pode usar a presença destas mensagens para verificar se o agente de operações está a escrever registos através de qualquer uma das seguintes ações:

• Pesquise registos de uma VM específica para as mensagens ping usando o Explorador de registos.
• Verifique o valor da métrica log_entry_count para uma VM específica usando o Explorador de métricas.
• Crie uma política de alerta para receber uma notificação se uma VM específica não estiver a atualizar a métrica log_entry_count.

Se alguma destas opções indicar que as mensagens de registo não estão a ser carregadas, pode fazer o seguinte:

• Verifique se existem códigos de erro que indiquem erros de arranque ou erros de tempo de execução.
• Determine se o agente de operações está em funcionamento.
• Execute o guião de diagnóstico do agente.

Para verificar o estado do agente de operações numa VM específica, precisa do ID da instância da VM. Para encontrar o ID da instância, faça o seguinte:

• Na Google Cloud consola, aceda à página Instâncias de VM:

  Aceda a Instâncias de VM

  Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cuja legenda seja Compute Engine.

• Clique no nome de uma instância de VM.
• No separador Detalhes, localize a secção Informações básicas. O ID da instância aparece como uma string numérica. Use esta string para o valor INSTANCE_ID nas secções subsequentes.

Pesquise mensagens através do Explorador de registos

Para usar o Explorador de registos para pesquisar as mensagens de ping de uma VM, faça o seguinte:

1. Na Google Cloud consola, aceda à página Explorador de registos:

   Aceda ao Explorador de registos

   Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cuja legenda é Registo.

2. Para procurar mensagens de ping do agente de operações numa instância de VM específica, introduza a seguinte consulta e substitua INSTANCE_ID pelo identificador de uma VM do Compute Engine e, em seguida, clique em Executar consulta:

   resource.type="gce_instance"
   resource.labels.instance_id="INSTANCE_ID"
   log_id("ops-agent-health")
   jsonPayload.code="LogPingOpsAgent"
       

Veja a métrica log_entry_count

Para usar o Explorador de métricas para verificar o valor da métrica log_entry_count para uma VM, faça o seguinte:

1. Na Google Cloud consola, aceda à página  Explorador de métricas:

   Aceda ao Metrics Explorer

   Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.

2. No campo Selecionar uma métrica, faça o seguinte:
   1. Introduza log entries.
   2. Para o Tipo de recurso, selecione Instância de VM.
   3. Para a Categoria de métricas, selecione Métricas baseadas em registos.
   4. Para a Métrica, selecione Entradas de registo.
   5. Selecione Aplicar.
3. No campo Filtro , adicione os seguintes filtros:
   • Filtre por um ID da instância de VM específico:
     1. Selecione a etiqueta de recurso instance_id.
     2. Selecione o comparador = (é igual a).
     3. Introduza o INSTANCE_ID de uma VM.
   • Filtre o registo ops-agent-health:
     1. Selecione a etiqueta de recurso log.
     2. Selecione o comparador = (é igual a).
     3. Selecione o valor ops-agent-health.

Crie uma política de alertas para a métrica log_entry_count

Para criar uma política de alerta que monitorize o valor da métrica log_entry_count para pings de registo de uma VM específica, faça o seguinte:

1. Na Google Cloud consola, aceda à página  Alertas:

   Aceder a Alertas

   Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.

2. Se não tiver criado os canais de notificação e quiser receber notificações, clique em Editar canais de notificação e adicione os seus canais de notificação. Regresse à página Alertas depois de adicionar os seus canais.
3. Na página Alertas, selecione Criar política.
4. No campo Selecionar uma métrica, faça o seguinte:
   1. Introduza log entries.
   2. Para o Tipo de recurso, selecione Instância de VM.
   3. Para a Categoria de métricas, selecione Métricas baseadas em registos.
   4. Para a Métrica, selecione Entradas de registo.
   5. Selecione Aplicar.
5. No campo Filtro , adicione os seguintes filtros:
   • Filtre por um ID da instância de VM específico:
     1. Selecione a etiqueta de recurso instance_id.
     2. Selecione o comparador = (é igual a).
     3. Introduza o INSTANCE_ID de uma VM.
   • Filtre o registo ops-agent-health:
     1. Selecione a etiqueta de recurso log.
     2. Selecione o comparador = (é igual a).
     3. Selecione o valor ops-agent-health.
6. Na secção Transformar dados, selecione o seguinte:
   • No campo Janela contínua, selecione 10 min. Para detetar entradas de registo em falta durante um período mais longo, introduza um valor superior.
   • No campo Função de período contínuo, selecione delta.
7. Clicar em Seguinte.
8. As definições na página Configurar acionador de alerta determinam quando o alerta é acionado. Preencha esta página com as definições na tabela seguinte.
   

   Página de configuração do acionador de alerta Campo	Valor
   Condition type	Threshold
   Alert trigger	Any time series violates
   Threshold position	Below threshold
   Threshold value	1
   Advanced Options: Retest window	No retest

9. Clicar em Seguinte.
10. Opcional: para adicionar notificações à sua política de alertas, clique em Canais de notificação. Na caixa de diálogo, selecione um ou mais canais de notificação no menu e, de seguida, clique em OK.
11. Opcional: atualize a Duração do encerramento automático do incidente. Este campo determina quando a monitorização fecha incidentes na ausência de dados de métricas.
12. Opcional: clique em Documentação e, de seguida, adicione as informações que quer incluir numa mensagem de notificação.
13. Clique em Nome do alerta e introduza um nome para a política de alertas.
14. Clique em Criar política.

Para mais informações, consulte as políticas de alertas.

Ferramenta de diagnóstico do agente para VMs

A ferramenta de diagnóstico do agente recolhe informações de depuração locais críticas das suas VMs para todos os seguintes agentes: agente de operações, agente de registo em registo legado e agente de monitorização legado. As informações de depuração incluem aspetos como informações do projeto, informações da VM, configuração do agente, registos do agente, estado do serviço do agente e informações que normalmente requerem trabalho manual para recolher. A ferramenta também verifica o ambiente de VM local para garantir que cumpre determinados requisitos para que os agentes funcionem corretamente, por exemplo, a conetividade de rede e as autorizações necessárias.

Quando registar um registo de cliente para um agente numa VM, execute a ferramenta de diagnóstico do agente e anexe as informações recolhidas ao registo. O fornecimento destas informações reduz o tempo necessário para resolver o seu registo de apoio técnico. Antes de anexar as informações ao registo de apoio técnico, oculte todas as informações confidenciais, como palavras-passe.

A ferramenta de diagnóstico do agente tem de ser executada a partir da VM. Por isso, normalmente, tem de fazer SSH para a VM primeiro. O seguinte comando obtém a ferramenta de diagnóstico do agente e executa-a:

Linux

curl -sSO https://dl.google.com/cloudagents/diagnose-agents.sh
sudo bash diagnose-agents.sh

Windows

(New-Object Net.WebClient).DownloadFile("https://dl.google.com/cloudagents/diagnose-agents.ps1", "${env:UserProfile}\diagnose-agents.ps1")
Invoke-Expression "${env:UserProfile}\diagnose-agents.ps1"

Siga a saída da execução do script para localizar os ficheiros que incluem as informações recolhidas. Normalmente, pode encontrá-los no diretório /var/tmp/google-agents no Linux e no diretório $env:LOCALAPPDATA/Temp no Windows, a menos que tenha personalizado o diretório de saída quando executou o script.

Para informações detalhadas, examine o script diagnose-agents.sh no Linux ou o script diagnose-agents.ps1 no Windows.

Ferramenta de diagnósticos do agente para políticas de instalação automática

Se uma tentativa de instalar o agente Ops através de uma política de SO do agente Ops falhar, pode usar o script de diagnóstico descrito nesta secção para depurar. Por exemplo, pode ver um dos seguintes casos:

• A instalação do agente Ops falha quando usou a caixa de verificação Instalar o agente Ops para monitorização e registo para instalar o agente Ops durante a criação da VM.

• O estado do agente no painel de controlo das instâncias de VM do Cloud Monitoring ou no separador Observabilidade numa página de detalhes da VM do Compute Engine permanece no estado Pendente durante mais de 10 minutos. Um estado Pendente prolongado pode indicar uma das seguintes situações:

  • Um problema ao aplicar a política.
  • Um problema na instalação real do agente de operações.
  • Um problema de conetividade entre a VM e o Cloud Monitoring.

  Para alguns destes problemas, o script agent-diagnostics geral e as verificações de estado também podem ser úteis.

Para executar o script policy-diagnostics, execute os seguintes comandos:

curl -sSO https://dl.google.com/cloudagents/diagnose-ui-policies.sh
bash diagnose-ui-policies.sh VM_NAME VM_ZONE

Nota: tem de ter a função roles/osconfig.osPolicyAssignmentViewer para executar este script.

Este script mostra informações sobre as VMs afetadas e as políticas de instalação automática relacionadas.

Quando registar um registo de cliente para um agente numa VM, execute as ferramentas de diagnóstico do agente e anexe as informações recolhidas ao registo. O fornecimento destas informações reduz o tempo necessário para resolver o seu registo de apoio técnico. Antes de anexar as informações ao registo de apoio técnico, oculte todas as informações confidenciais, como palavras-passe.

Registos automáticos do agente

Se o agente não conseguir carregar registos para o Cloud Logging, pode ter de inspecionar os registos do agente localmente na VM para resolver problemas. Também pode usar a rotação de registos para gerir os autorregistos do agente.

Linux

Nota: tudo na secção do Linux foi automatizado como parte da ferramenta de diagnóstico. Para realizar a inspeção do registo manualmente, continue com os passos seguintes.

Para inspecionar os registos automáticos escritos em Journald, execute o seguinte comando:

journalctl -u google-cloud-ops-agent*

Para inspecionar os registos automáticos escritos no disco pelo módulo de registo, execute o seguinte comando:

vim -M /var/log/google-cloud-ops-agent/subagents/logging-module.log

Windows

Para inspecionar os registos automáticos escritos em Windows Event Logs, execute o seguinte comando:

Get-WinEvent -FilterHashtable @{ Logname='Application'; ProviderName='google-cloud-ops-agent*' } | Format-Table -AutoSize -Wrap

Para inspecionar os registos automáticos escritos no disco pelo módulo de registo, execute o seguinte comando:

notepad "C:\ProgramData\Google\Cloud Operations\Ops Agent\log\logging-module.log"

Para inspecionar os registos dos serviços do Windows Service Control Manager do agente de operações, execute o seguinte comando:

Get-WinEvent -FilterHashtable @{ Logname='System'; ProviderName='Service Control Manager' } | Where-Object -Property Message -Match 'Google Cloud Ops Agent' | Format-Table -AutoSize -Wrap

Veja a utilização de métricas e os diagnósticos no Cloud Monitoring

A página Gestão de métricas do Cloud Monitoring fornece informações que podem ajudar a controlar o valor gasto em métricas faturáveis sem afetar a observabilidade. A página Gestão de métricas apresenta as seguintes informações:

• Volumes de carregamento para a faturação baseada em bytes e em amostras, em domínios de métricas e para métricas individuais.
• Dados sobre as etiquetas e a cardinalidade das métricas.
• Número de leituras para cada métrica.
• Utilização de métricas em políticas de alerta e painéis de controlo personalizados.
• Taxa de erros de escrita de métricas.

Também pode usar a página Gestão de métricas para excluir métricas desnecessárias, eliminando o custo da respetiva ingestão.

Para ver a página Gestão de métricas, faça o seguinte:

1. Na Google Cloud consola, aceda à página  Gestão de métricas:

   Aceda a Gestão de métricas

   Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.

2. Na barra de ferramentas, selecione o intervalo de tempo. Por predefinição, a página Gestão de métricas apresenta informações sobre as métricas recolhidas no dia anterior.

Para mais informações sobre a página Gestão de métricas, consulte o artigo Veja e faça a gestão da utilização de métricas.