Resolver problemas de políticas do Gerenciador de Extensões de VM para o Agente de Operações

Para diagnosticar problemas com as políticas do Gerenciador de extensões de VM que gerenciam o Agente de operações, use as técnicas de solução de problemas descritas neste documento. Para informações sobre como resolver problemas do Agente de Operações, consulte Resolver problemas do Agente de Operações.

Falha nos comandos gcloud compute zone-vm-extension-policies

Quando um comando gcloud compute zone-vm-extension-policies falha, a resposta inclui sugestões de solução de problemas. Corrija os erros nas sinalizações ou nos argumentos de comando sugeridos pela mensagem de erro.

Se a saída do comando mencionar permissões insuficientes do IAM, consulte os papéis e as permissões necessários descritos em Conceder os papéis necessários para usar o Gerenciador de extensões de VM.

A política de extensão foi criada, mas o status do Agente de Operações é "não detectado"

Você criou uma política de extensão, mas o Agente de Operações mostra um status "não detectado" na VM.

O Agente de Operações pode aparecer como "não detectado" se uma das seguintes situações ocorrer:

  • A política de extensão não instala o Agente de Operações.
  • Um Agente de Operações instalado encontra uma condição de erro que o impede de ser executado.

As seções a seguir descrevem como diagnosticar esses casos.

Verificar se o Agente de Operações foi instalado pela política

As políticas do Gerenciador de Extensões de VM usam o agente convidado do Compute Engine para gerenciar o Agente de Operações como uma extensão de VM.

Para determinar se o Agente de Operações foi instalado pela política de extensão, use uma das seguintes opções para procurar entradas de registro do agente convidado:

Análise de registros

  1. No console do Google Cloud , acesse a página Análise de registros:

    Acessar a Análise de registros

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.

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

    log_id("GCEGuestAgentManager")

Linux

Execute o seguinte comando na VM do Compute Engine:

journalctl -u google-guest-agent-manager

Windows

Execute o seguinte comando na VM do Compute Engine:

Get-Eventlog -Source google_guest_agent_manager -LogName Application

Se você encontrar registros com uma string como Failed to install plugin "ops-agent-plugin" ... ou se a consulta não retornar registros, isso significa que a política de extensão não conseguiu instalar o Agente de Operações. Para as próximas etapas, consulte A política de extensão não instala o Agente de Operações.

Se você encontrar registros com uma string como Successfully installed plugin "ops-agent_nnnnnnnn", isso significa que a política de extensão instalou o Agente de Operações. Para as próximas etapas, consulte O Agente de Operações instalado "não foi detectado".

A política de extensão não instala o Agente de Operações

Uma política de extensão pode ser ineficaz se uma das seguintes condições for verdadeira:

  • O agente convidado não está instalado na VM. Para diagnosticar e corrigir essa condição, faça o seguinte:

    1. Verifique se a VM está usando um dos sistemas operacionais compatíveis com o ambiente de convidado do Compute Engine.

    2. Confira os pacotes instalados na VM para verificar se o google-guest-agent está incluído.

    3. Se o google-guest-agent não estiver instalado, instale o agente convidado.

  • O agente convidado está instalado, mas desatualizado. Para diagnosticar e corrigir essa condição, faça o seguinte:

    1. Valide o ambiente de convidado para determinar a versão do pacote google-guest-agent. O Gerenciador de Extensões de VM requer a versão 20241209.01 ou mais recente.

    2. Se a versão do google-guest-agent for anterior à 20241209.01, atualize o ambiente de convidado.

  • O sistema operacional da VM não é compatível com o Gerenciador de Extensões de VM. Para mais informações, consulte Analisar sistemas operacionais compatíveis.

O Agente de Operações instalado tem o status "não detectado"

O Agente de Operações pode ter o status "não detectado" se uma das seguintes condições for verdadeira:

Verificar se a configuração do Agente de Operações é válida

Você forneceu uma configuração personalizada ao Agente de Operações criando ou atualizando uma política de extensão, mas o status do agente é "não detectado". O problema pode ser um erro na configuração personalizada. Use os registros de depuração do agente convidado para procurar erros de configuração.

Ativar a geração de registros de depuração do agente convidado

Para saber como ativar a geração de registros de depuração para o agente convidado, consulte Ver registros de depuração do agente convidado.

Analisar registros de depuração

Análise de registros

  1. No console do Google Cloud , acesse a página Análise de registros:

    Acessar a Análise de registros

    Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.

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

    severity>=DEBUG log_id("GCEGuestAgentManager") "The agent config file is not valid"

Linux

Execute o seguinte comando na VM do Linux do Compute Engine:

journalctl -u google-guest-agent-manager | grep "The agent config file is not valid"

Windows

Execute o comando a seguir na VM do Windows Compute Engine:

Get-Eventlog -Source google_guest_agent_manager -LogName Application | Where-Object {$_.Message -like "*The agent config file is not valid*"}

Se você encontrar registros com a string The agent config file is not valid, a configuração personalizada do Agente de Operações fornecida ao criar ou atualizar a política de extensão é inválida.

Para resolver esse problema, faça o seguinte:

  • Consulte Configurar o Agente de Operações para corrigir a configuração. Para informações sobre a estrutura de um arquivo de configuração do Agente de Operações.

  • Atualize a política de extensão com a configuração corrigida.

Os comandos do Linux systemctl status e do Windows Get-Service não funcionam com o Agente de Operações

Você executa um comando como sudo systemctl status google-cloud-ops-agent"*", mas ele não retorna informações.

Quando o Agente de Operações é instalado e gerenciado pelo Gerenciador de Extensões de VM, ele não é gerenciado pelo serviço de gerenciamento do sistema operacional, ou seja, systemd no Linux ou o Gerenciador de Serviços do Windows no Windows.

Para encontrar as informações de status de um Agente de Operações gerenciado pelo Gerenciador de Extensões de VM, consulte o seguinte:

Os comandos do Linux systemctl restart e do Windows Restart-Service não funcionam com o Agente de Operações

Você executa um comando como sudo systemctl restart google-cloud-ops-agent, mas o Agente de Operações não é reiniciado.

Quando o Agente de Operações é instalado e gerenciado pelo Gerenciador de Extensões de VM, ele não é gerenciado pelo serviço de gerenciamento do sistema operacional, ou seja, systemd no Linux ou o Gerenciador de Serviços do Windows no Windows. Portanto, não é possível interromper ou iniciar o Agente de Operações manualmente, e comandos como os seguintes não funcionam com o Agente de Operações:

  • Linux: sudo systemctl [stop|start|restart]
  • Windows: Stop-Service, Start-Service, Restart-Service

Para interromper ou reiniciar um Agente de Operações gerenciado pelo Gerenciador de Extensões de VM, exclua a política de extensão para desinstalar o agente. Para mais informações sobre como interromper ou reiniciar o Agente de Operações, consulte Reiniciar um Agente de Operações instalado por uma política de extensão.

Outras informações sobre solução de problemas

Para mais informações sobre como resolver problemas na criação e no uso de políticas do Gerenciador de extensões de VM, consulte Resolver problemas com extensões de VM.

Para mais informações sobre como resolver problemas do Agente de Operações, consulte Resolver problemas do Agente de Operações.