Soluciona problemas de las políticas del Gestor de extensiones de VM para el Agente de operaciones

Para diagnosticar problemas con las políticas del Gestor de extensiones de VM que administran el Agente de operaciones, usa las técnicas de solución de problemas que se describen en este documento. Para obtener información sobre cómo solucionar problemas del Agente de operaciones, consulta Soluciona problemas del Agente de operaciones.

Los comandos gcloud compute zone-vm-extension-policies fallan

Cuando un comando gcloud compute zone-vm-extension-policies falla, la respuesta incluye sugerencias para solucionar problemas. Corrige los errores en las marcas o los argumentos del comando que se sugieren en el mensaje de error.

Si el resultado del comando menciona permisos de IAM insuficientes, revisa los roles y permisos necesarios que se describen en Otorga los roles necesarios para usar el Gestor de extensiones de VM.

Se creó la política de extensión, pero el estado del Agente de operaciones es "no detectado"

Creaste correctamente una política de extensión, pero el Agente de operaciones muestra un estado "no detectado" en la VM.

Es posible que el Agente de operaciones se muestre como "no detectado" si ocurre alguna de las siguientes situaciones:

  • La política de extensiones no puede instalar el Agente de operaciones.
  • Un Agente de operaciones instalado encuentra una condición de error que impide que se ejecute.

En las siguientes secciones, se describe cómo diagnosticar estos casos.

Verifica que la política haya instalado el Agente de operaciones

Las políticas del Gestor de extensiones de VM usan el agente invitado de Compute Engine para administrar el Agente de operaciones como una extensión de VM.

Para determinar si la política de extensión instaló el Agente de operaciones, usa una de las siguientes opciones para buscar entradas de registro del agente invitado:

Explorador de registros

  1. En la consola de Google Cloud , ve a la página Explorador de registros del :

    Ir al Explorador de registros

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

  2. Ingresa la siguiente consulta y haz clic en Ejecutar consulta:

    log_id("GCEGuestAgentManager")

Linux

Ejecuta el siguiente comando en la VM de Compute Engine:

journalctl -u google-guest-agent-manager

Windows

Ejecuta el siguiente comando en la VM de Compute Engine:

Get-Eventlog -Source google_guest_agent_manager -LogName Application

Si ves registros que contienen una cadena como Failed to install plugin "ops-agent-plugin" ... o la consulta no devuelve registros, significa que la política de extensión no pudo instalar el Agente de operaciones. Para conocer los próximos pasos, consulta La política de extensión no puede instalar el Agente de operaciones.

Si ves registros que contienen una cadena como Successfully installed plugin "ops-agent_nnnnnnnn", significa que la política de extensión instaló correctamente el Agente de operaciones. Para conocer los próximos pasos, consulta El Agente de operaciones instalado "no se detecta".

La política de extensión no puede instalar el Agente de operaciones

Una política de extensión puede ser ineficaz si se cumple una de las siguientes condiciones:

  • El agente de invitado no está instalado en la VM. Para diagnosticar y corregir esta condición, haz lo siguiente:

    1. Verifica que la VM use uno de los sistemas operativos compatibles con el entorno invitado de Compute Engine.

    2. Consulta los paquetes instalados en la VM para verificar que se incluya google-guest-agent.

    3. Si el google-guest-agent no está instalado, instala el agente invitado.

  • El agente invitado está instalado, pero desactualizado. Para diagnosticar y corregir esta condición, haz lo siguiente:

    1. Valida el entorno invitado para determinar la versión del paquete google-guest-agent. El Gestor de extensiones de VM requiere la versión 20241209.01 o una posterior.

    2. Si la versión de google-guest-agent es anterior a 20241209.01, actualiza el entorno invitado.

  • El sistema operativo de la VM no es compatible con el Gestor de extensiones de VM. Para obtener más información, consulta Revisa los sistemas operativos compatibles.

El Agente de operaciones instalado tiene el estado "no detectado"

El Agente de operaciones puede tener el estado "No detectado" si se cumple una de las siguientes condiciones:

Verifica que la configuración del Agente de operaciones sea válida

Proporcionaste una configuración personalizada al Agente de operaciones creando o actualizando una política de extensión, pero el estado del agente es "no detectado". El problema podría ser un error en tu configuración personalizada. Usa los registros de depuración del agente invitado para buscar errores de configuración.

Habilita el registro de depuración del agente de invitado

Para obtener información sobre cómo habilitar el registro de depuración para el agente invitado, consulta Visualiza los registros de depuración del agente invitado.

Examina los registros de depuración

Explorador de registros

  1. En la consola de Google Cloud , ve a la página Explorador de registros del :

    Ir al Explorador de registros

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Logging.

  2. Ingresa la siguiente consulta y haz clic en Ejecutar consulta:

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

Linux

Ejecuta el siguiente comando en la VM de Linux de Compute Engine:

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

Windows

Ejecuta el siguiente comando en la VM de Windows de Compute Engine:

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

Si ves registros que contienen la cadena The agent config file is not valid, la configuración personalizada del Agente de operaciones que proporcionaste cuando creaste o actualizaste la política de extensión no es válida.

Para solucionar este problema, haz lo siguiente:

  • Corrige la configuración con la información de Configura el Agente de operaciones. Para obtener información sobre la estructura de un archivo de configuración del Agente de operaciones, consulta

  • Actualiza la política de extensiones con la configuración corregida.

Los comandos systemctl status de Linux y Get-Service de Windows no funcionan con el Agente de operaciones

Ejecutas un comando como sudo systemctl status google-cloud-ops-agent"*", pero no devuelve información.

Cuando el Gestor de extensiones de VM instala y administra el Agente de operaciones, el servicio de administración del sistema operativo no lo administra, es decir, systemd en Linux o el Administrador de servicios de Windows en Windows.

Para encontrar la información de estado de un Agente de operaciones administrado por el Gestor de extensiones de VM, consulta lo siguiente:

Los comandos systemctl restart de Linux y Restart-Service de Windows no funcionan con el Agente de operaciones

Ejecutas un comando como sudo systemctl restart google-cloud-ops-agent, pero el Agente de operaciones no se reinicia.

Cuando el Gestor de extensiones de VM instala y administra el Agente de operaciones, este no se administra con el servicio de administración del sistema del sistema operativo, es decir, systemd en Linux o el Administrador de servicios de Windows en Windows. Por lo tanto, no puedes detener ni iniciar el Agente de operaciones de forma manual, y los comandos como los siguientes no funcionan con el Agente de operaciones:

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

Para detener o reiniciar un Agente de operaciones administrado por el Gestor de extensiones de VM, debes desinstalar el agente borrando la política de extensiones. Para obtener más información sobre cómo detener o reiniciar el Agente de operaciones, consulta Reinicia un Agente de operaciones instalado por una política de extensión.

Información adicional para solucionar problemas

Para obtener más información sobre cómo solucionar problemas relacionados con la creación y el uso de las políticas del Gestor de extensiones de VM, consulta Soluciona problemas de las extensiones de VM.

Para obtener más información sobre cómo solucionar problemas del Agente de operaciones, consulta Soluciona problemas del Agente de operaciones.