Instala y administra el agente de operaciones con políticas de VM Extension Manager

Puedes instalar y administrar el agente de operaciones en una flota de VMs de Compute Engine a nivel global o dentro de una zona específica con las políticas del Administrador de extensiones de VM. Por ejemplo, puedes usar estas políticas para realizar tareas como las siguientes:

  • Instalación en toda la flota: Instala el Agente de operaciones en los siguientes elementos:

    • Todas las VMs en una o más zonas de tu proyecto Google Cloud
    • Todas las VMs a nivel global (en tu proyecto Google Cloud ).
    • Es un subconjunto de VMs en una zona, identificadas por etiquetas.
    • Es un subconjunto de VMs en todas las zonas de tu proyecto de Google Cloud , identificadas por etiquetas.

  • Control de versión:

    • Mantén actualizado el agente de operaciones a la versión más reciente.
    • Fija la versión del agente de operaciones a una versión específica.

  • Administración de la configuración: Aplica una configuración personalizada al Agente de operaciones en todas las VMs administradas por una política.

Con el Gestor de extensiones de VM, creas políticas que declaran qué extensiones deseas instalar en las VMs. El Agente de operaciones es una de las extensiones disponibles. Las políticas del Administrador de extensiones de VM pueden administrar la versión 2.58.0 o posterior del Agente de operaciones, cuando este se haya instalado con el Administrador de extensiones de VM. Estas políticas no pueden administrar versiones del agente de operaciones anteriores a la versión 2.58.0, instancias del agente de operaciones instaladas por otros medios ni ninguna versión del agente de Monitoring o el agente de Logging heredados.

Puedes crear y administrar políticas de extensiones de VM zonales con la consola deGoogle Cloud o Google Cloud CLI, gcloud. Puedes crear y administrar políticas de extensión de VM globales con gcloud.

Antes de comenzar

Antes de comenzar a usar las políticas de extensión del Gestor de extensiones de VM, haz lo siguiente:

Revisa los sistemas operativos compatibles

Antes de intentar usar las políticas de VM Extension Manager para administrar el Agente de operaciones, verifica que tu sistema operativo de destino sea compatible con el Agente de operaciones y con VM Extension Manager.

El Gestor de extensiones de VM admite todos los sistemas operativos compatibles con el Agente de operaciones, excepto SUSE Linux Enterprise Server (SLES) y Ubuntu. Para obtener más información sobre los sistemas operativos compatibles con el Agente de operaciones, consulta Sistemas operativos.

Si tu sistema operativo es compatible con el Agente de operaciones y con el Gestor de extensiones de VM, sigue el resto de este documento.

Habilita las APIs necesarias para usar el agente de operaciones

Para usar el agente de operaciones para escribir registros y métricas, debes habilitar la API de Cloud Logging y la API de Cloud Monitoring en tu proyecto de Google Cloud .

Roles necesarios para habilitar las APIs

Para habilitar APIs, necesitas el permiso serviceusage.services.enable. Si creaste el proyecto, es probable que ya tengas este permiso a través del rol de propietario (roles/owner). De lo contrario, puedes obtener este permiso a través del rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin). Obtén más información para otorgar roles.

Habilitar las API

Otorga los roles necesarios para usar el agente de operaciones

Para obtener los permisos que necesitas para usar el agente de operaciones y escribir registros y métricas, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu cuenta de servicio:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Para obtener más información sobre los roles y el agente de operaciones, consulta Autoriza el agente de operaciones.

Otorga los roles necesarios para usar el Gestor de extensiones de VM

Para obtener los permisos que necesitas para crear, ver, modificar y borrar políticas de extensiones de VM, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para crear, ver, modificar y borrar políticas de extensiones de VM. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para crear, ver, modificar y borrar políticas de extensión de VM:

  • Para crear políticas de extensiones, haz lo siguiente: compute.vmExtensionPolicies.create
  • Para ver las políticas de extensiones, haz lo siguiente: compute.vmExtensionPolicies.list
  • Para ver los detalles de una política de extensiones, haz lo siguiente: compute.vmExtensionPolicies.get
  • Para modificar las políticas de extensiones, haz lo siguiente:compute.vmExtensionPolicies.update
  • Para borrar políticas de extensiones, haz lo siguiente: compute.vmExtensionPolicies.delete

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para obtener más información sobre los roles y permisos de IAM en Compute Engine, consulta Roles y permisos de Compute Engine.

Instala Google Cloud CLI

Puedes crear y administrar políticas de extensiones de VM con la consola de Google Cloud o Google Cloud CLI, gcloud. Para usar gcloud, primero debes instalar Google Cloud CLI.

Para ver los componentes que instalaste, ejecuta el siguiente comando:

gcloud components list

Para verificar que tienes la versión más reciente, ejecuta el siguiente comando:

gcloud components update

Desinstala los agentes de observabilidad

Antes de crear una política de VM Extension Manager para administrar el agente de operaciones en una VM, asegúrate de que no haya instancias del agente de operaciones ni del agente de Monitoring heredado ni del agente de Logging en la VM. Ejecutar el Agente de operaciones y los agentes heredados en la misma VM puede causar la transferencia de registros duplicados o conflictos en la transferencia de métricas.

Si usas una política de extensión para instalar el Agente de operaciones en una VM en la que ya está instalado otro agente de observabilidad, la política instalará el agente, pero este no se ejecutará porque se detectó un conflicto.

La forma en que quitas los agentes existentes depende de cómo se instalaron.

Instala el agente de operaciones creando políticas de extensión de VM

Crea políticas de extensión de VM para instalar y administrar automáticamente el Agente de operaciones en una flota de máquinas virtuales (VMs) de Compute Engine. Si defines una política, puedes garantizar que se instalen y mantengan extensiones específicas, como el agente de operaciones, en cualquier VM que coincida con los criterios que especifiques, como las etiquetas de VM.

Conflictos y prioridades de políticas

El Gestor de extensiones de VM asocia una prioridad con cada política nueva, y los números más bajos indican prioridades más altas. La prioridad predeterminada es 1,000. Una VM puede estar cubierta por varias políticas para una extensión, como el agente de operaciones, pero solo una política para la extensión del agente de operaciones es efectiva en la VM.

El Gestor de extensiones de VM usa prioridades para resolver conflictos entre las políticas aplicadas a una VM. Para obtener más información sobre el proceso de resolución, consulta Prioridad de las políticas y resolución de conflictos.

Planes de lanzamiento de políticas globales

Las políticas globales del Gestor de extensiones de VM usan un plan de lanzamiento para determinar cómo se distribuye una política a las VMs de destino. Existen dos tipos de planes de lanzamiento:

  • Planes de lanzamiento predeterminados: Hay dos planes de lanzamiento predefinidos, que se eligen según el valor que se usa con la opción --rollout-predefined-plan para los comandos de la gcloud CLI.

    • Lanzamiento lento, que implementa el agente de operaciones de forma gradual en diferentes zonas durante un período. Se recomienda este plan de lanzamiento.

      Especifica este plan de lanzamiento con la opción --rollout-predefined-plan=slow_rollout.

    • Implementación rápida, que implementa el agente de operaciones en todas las VMs objetivo de todas las zonas y regiones de inmediato.

      Especifica este plan de lanzamiento con la opción --rollout-predefined-plan=fast_rollout.

  • Planes de lanzamiento personalizados, especificados con la opción --rollout-custom-plan para los comandos de la gcloud CLI

    Crea planes de lanzamiento personalizados agregándolos al conjunto de planes de lanzamiento en tu proyecto de Google Cloud . Para obtener más información, consulta el método de la API de Compute Engine rolloutPlans.insert.

Para obtener más información sobre los planes de lanzamiento, consulta Planes de lanzamiento para políticas globales.

Instala la versión más reciente del Agente de operaciones en todas las VMs

Para crear una política que instale la versión más reciente del Agente de operaciones en todas las VMs de una zona o de forma global, y que actualice el Agente de operaciones cuando se lance una versión nueva, haz lo siguiente:

Console

Para crear una política zonal, puedes usar la consola de Google Cloud .

  1. En la consola de Google Cloud , ve a la página Políticas de extensiones:

    Ir a Políticas de extensiones

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

  2. Haz clic en + Crear.
  3. En el campo Nombre, ingresa un nombre para la política.
  4. Opcional: En el campo Descripción, ingresa una descripción para la política.
  5. En el campo Prioridad, especifica un número de prioridad para resolver conflictos entre políticas. Los números más bajos indican una mayor prioridad. El valor predeterminado es 1,000.

  6. En la lista Zona, selecciona la zona en la que deseas aplicar esta política.

  7. En la sección Administrar extensiones, haz clic en Agregar extensión y sigue estos pasos:

    1. En la lista Extensión, selecciona Google Cloud's Extension for Ops Agent.
    2. Deja en blanco el campo Versión.

  8. Haz clic en Crear.

gcloud

Para crear una política zonal o global, puedes usar gcloud CLI.

Zonal

Usa el siguiente comando gcloud compute zone-vm-extension-policies create para crear la política:

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent

Reemplaza las siguientes variables en el comando:

  • POLICY_NAME: Es el nombre de la política de extensión de VM.
  • PROJECT_ID: Es el identificador del proyecto.
  • ZONE: Es la zona de destino, por ejemplo, us-central1-f.

El gcloud compute zone-vm-extension-policies create toma una opción --version. Si omites la opción --version, la política instalará la versión más reciente y actualizará el Agente de operaciones cuando se lance una versión nueva.

Global

Usa el siguiente comando gcloud compute global-vm-extension-policies create para crear la política:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout

Reemplaza las siguientes variables en el comando:

  • POLICY_NAME: Es el nombre de la política de extensión de VM.
  • PROJECT_ID: Es el identificador del proyecto.

El gcloud compute global-vm-extension-policies create toma una opción --version. Si omites la opción --version, la política instalará la versión más reciente y actualizará el Agente de operaciones cuando se lance una versión nueva.

Fija el agente de operaciones a una versión específica en todas las VMs

Para crear una política que instale una versión específica del agente de operaciones en todas las VMs de una zona o de forma global, haz lo siguiente:

Console

Para crear una política zonal, puedes usar la consola de Google Cloud .

  1. En la consola de Google Cloud , ve a la página Políticas de extensiones:

    Ir a Políticas de extensiones

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

  2. Haz clic en + Crear.
  3. En el campo Nombre, ingresa un nombre para la política.
  4. Opcional: En el campo Descripción, ingresa una descripción para la política.
  5. En el campo Prioridad, especifica un número de prioridad para resolver conflictos entre políticas. Los números más bajos indican una mayor prioridad. El valor predeterminado es 1,000.

  6. En la lista Zona, selecciona la zona en la que deseas aplicar esta política.

  7. En la sección Administrar extensiones, haz clic en Agregar extensión y sigue estos pasos:

    1. En la lista Extensión, selecciona Google Cloud's Extension for Ops Agent.
    2. En la lista Versión, selecciona la versión que deseas instalar. Usa la versión 2.58.0 o una posterior.

  8. Haz clic en Crear.

gcloud

Para crear una política zonal o global, puedes usar gcloud CLI.

Zonal

Usa el siguiente comando gcloud compute zone-vm-extension-policies create para crear la política:

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent  \
  --version=ops-agent=VERSION

Reemplaza las siguientes variables en el comando:

  • POLICY_NAME: Es el nombre de la política de extensión de VM.
  • PROJECT_ID: Es el identificador del proyecto.
  • ZONE: Es la zona de destino, por ejemplo, us-central1-f.

  • VERSION: Es la versión del Agente de operaciones que se instalará. Usa la versión 2.58.0 o una posterior.

    Si omites la opción --version, la política instalará la versión más reciente y actualizará el Agente de operaciones cuando se lance una versión nueva, como se muestra en el ejemplo que instala la versión más reciente.

Global

Usa el siguiente comando gcloud compute global-vm-extension-policies create para crear la política:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --version=ops-agent=VERSION

Reemplaza las siguientes variables en el comando:

  • POLICY_NAME: Es el nombre de la política de extensión de VM.
  • PROJECT_ID: Es el identificador del proyecto.

  • VERSION: Es la versión del Agente de operaciones que se instalará. Usa la versión 2.58.0 o una posterior.

    Si omites la opción --version, la política instalará la versión más reciente y actualizará el Agente de operaciones cuando se lance una versión nueva, como se muestra en el ejemplo que instala la versión más reciente.

Para obtener una lista de las versiones del agente de operaciones, consulta la página de versiones en GitHub.

Instala el Agente de operaciones en VMs que tienen una etiqueta específica

Para crear una política que instale la versión más reciente del Agente de operaciones en las VMs de una zona o de forma global que tengan una etiqueta específica, haz lo siguiente:

Console

Para crear una política zonal, puedes usar la consola de Google Cloud .

  1. En la consola de Google Cloud , ve a la página Políticas de extensiones:

    Ir a Políticas de extensiones

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

  2. Haz clic en + Crear.
  3. En el campo Nombre, ingresa un nombre para la política.
  4. Opcional: En el campo Descripción, ingresa una descripción para la política.
  5. En el campo Prioridad, especifica un número de prioridad para resolver conflictos entre políticas. Los números más bajos indican una mayor prioridad. El valor predeterminado es 1,000.

  6. En la lista Zona, selecciona la zona en la que deseas aplicar esta política.

  7. En la sección Extensiones, haz clic en Agregar extensión y haz lo siguiente:

    1. En la lista Extensión, selecciona Google Cloud's Extension for Ops Agent.
    2. Deja en blanco el campo Versión.

  8. En la sección Instancias de VM de destino, selecciona las VMs para la política. Para seleccionar VMs con etiquetas específicas, haz clic en Agregar etiquetas y agrega el par clave-valor.

  9. Haz clic en Crear.

gcloud

Para crear una política zonal o global, puedes usar gcloud CLI.

Zonal

Usa la opción --inclusion-labels del comando gcloud compute zone-vm-extension-policies create para especificar una lista separada por comas de pares clave-valor:

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --inclusion-labels=KEY1=VALUE1,KEY2=VALUE2

Reemplaza las siguientes variables en el comando:

  • POLICY_NAME: Es el nombre de la política de extensión de VM.
  • PROJECT_ID: Es el identificador del proyecto.
  • ZONE: Es la zona de destino, por ejemplo, us-central1-f.

  • KEY1=VALUE1,KEY2=VALUE2: Es una lista separada por comas de pares clave-valor que definen etiquetas de inclusión para un selector. Las VMs deben tener todas las etiquetas especificadas en un selector (operador lógico AND) para incluirse. Si especificas la opción --inclusion_labels varias veces, la política se orienta a las VMs que coinciden con todas las etiquetas de cualquiera de los selectores (OR lógica). Si omites esta opción, la política se aplicará a todas las VMs de la zona especificada.

Global

Usa la opción --inclusion-labels del comando gcloud compute global-vm-extension-policies create para especificar una lista separada por comas de pares clave-valor:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --inclusion-labels=KEY1=VALUE1,KEY2=VALUE2

Reemplaza las siguientes variables en el comando:

  • POLICY_NAME: Es el nombre de la política de extensión de VM.
  • PROJECT_ID: Es el identificador del proyecto.

  • KEY1=VALUE1,KEY2=VALUE2: Es una lista separada por comas de pares clave-valor que definen etiquetas de inclusión para un selector. Las VMs deben tener todas las etiquetas especificadas en un selector (operador lógico AND) para incluirse. Si especificas la opción --inclusion_labels varias veces, la política se orienta a las VMs que coinciden con todas las etiquetas de cualquiera de los selectores (OR lógica). Si omites esta opción, la política se aplicará a todas las VMs de la zona especificada.

Instala el Agente de operaciones con una configuración personalizada en todas las VMs

Para crear una política que instale la versión más reciente del Agente de operaciones en todas las VMs de una zona o de forma global, y que proporcione una configuración personalizada para el Agente de operaciones, haz lo siguiente:

Console

Para crear una política zonal, puedes usar la consola de Google Cloud .

  1. En la consola de Google Cloud , ve a la página Políticas de extensiones:

    Ir a Políticas de extensiones

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

  2. Haz clic en + Crear.
  3. En el campo Nombre, ingresa un nombre para la política.
  4. Opcional: En el campo Descripción, ingresa una descripción para la política.
  5. En el campo Prioridad, especifica un número de prioridad para resolver conflictos entre políticas. Los números más bajos indican una mayor prioridad. El valor predeterminado es 1,000.

  6. En la lista Zona, selecciona la zona en la que deseas aplicar esta política.

  7. En la sección Extensiones, haz clic en Agregar extensión y haz lo siguiente:

    1. En la lista Extensión, selecciona Google Cloud's Extension for Ops Agent.
    2. Deja en blanco el campo Versión.
    3. En el campo Contenido del archivo de configuración, ingresa la cadena de configuración de YAML para el agente de operaciones.

  8. Haz clic en Crear.

gcloud

Para crear una política zonal o global, puedes usar gcloud CLI.

Zonal

Usa la opción --config-from-file para el comando gcloud compute zone-vm-extension-policies create para especificar un archivo de configuración:

gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

Reemplaza las siguientes variables en el comando:

  • POLICY_NAME: Es el nombre de la política de extensión de VM.
  • PROJECT_ID: Es el identificador del proyecto.
  • ZONE: Es la zona de destino, por ejemplo, us-central1-f.

  • OPS_AGENT_CONFIG_PATH: Es la ruta de acceso a un archivo que contiene la cadena de configuración YAML para el agente de operaciones. Este archivo debe existir en el entorno en el que ejecutas el comando de gcloud.

    El archivo YAML de configuración del agente de operaciones puede ser extenso. Colocar la configuración en un archivo y pasar el archivo a gcloud CLI es mucho menos propenso a errores que intentar ingresar YAML con el formato adecuado en la línea de comandos. Cambiar este archivo después de crear la política no la actualiza. Para actualizar una política, usa el comando gcloud compute zone-vm-extension-policies update.

Global

Usa la opción --config-from-file para el comando gcloud compute global-vm-extension-policies create para especificar un archivo de configuración:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

Reemplaza las siguientes variables en el comando:

  • POLICY_NAME: Es el nombre de la política de extensión de VM.
  • PROJECT_ID: Es el identificador del proyecto.

  • OPS_AGENT_CONFIG_PATH: Es la ruta de acceso a un archivo que contiene la cadena de configuración YAML para el agente de operaciones. Este archivo debe existir en el entorno en el que ejecutas el comando de gcloud.

    El archivo YAML de configuración del agente de operaciones puede ser extenso. Colocar la configuración en un archivo y pasar el archivo a gcloud CLI es mucho menos propenso a errores que intentar ingresar YAML con el formato adecuado en la línea de comandos. Cambiar este archivo después de crear la política no la actualiza. Para actualizar una política, usa el comando gcloud compute global-vm-extension-policies update.

Si proporcionas una configuración personalizada para el Agente de operaciones cuando creas o actualizas una política de extensión, la política implementa el Agente de operaciones con la configuración personalizada. No es necesario que reinicies el agente de forma manual.

La configuración se almacena con la política de extensión, por lo que no debes incluir datos sensibles, como contraseñas, en la configuración. Dado que la configuración se almacena con la política de extensión, modificar el archivo de configuración no cambia la configuración del agente. Debes actualizar la configuración almacenada con la política usando el comando gcloud adecuado:

Cuando proporcionas una configuración personalizada para el Agente de operaciones, el Gestor de extensiones de VM copia la configuración en la ubicación que usa el Agente de operaciones para los archivos de configuración especificados por el usuario en la VM de destino:

  • Linux: /etc/google-cloud-ops-agent/config.yaml
  • Windows: C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml

Si hay un archivo config.yaml presente en la VM, la política de extensión lo sobrescribe.

Para obtener información general sobre cómo usar laGoogle Cloud consola y la gcloud CLI para crear políticas de extensiones de VM, consulta Instala extensiones de VM creando políticas de extensiones .

Instala el Agente de operaciones con un plan de lanzamiento rápido y de mayor prioridad (solo a nivel global)

Para crear una política global que instale la versión más reciente del Agente de operaciones con una prioridad más alta que la predeterminada y el plan de lanzamiento rápido, usa el siguiente comando gcloud compute global-vm-extension-policies create:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=fast_rollout \
  --priority=500

Reemplaza las siguientes variables en el comando:

  • POLICY_NAME: Es el nombre de la política de extensión de VM.
  • PROJECT_ID: Es el identificador del proyecto.

Instala el Agente de operaciones en un subconjunto de zonas de un Google Cloud proyecto (solo global)

Para crear una política global que se aplique solo a un subconjunto de zonas en un proyecto deGoogle Cloud , debes usar un plan de lanzamiento personalizado que especifique las zonas en las que se aplicará la política. Para obtener información sobre cómo crear planes de lanzamiento personalizados, consulta Acerca de los planes de lanzamiento. Para especificar un conjunto de zonas, usa el campo locationSelector.includedLocations cuando crees el plan de lanzamiento.

Para crear una política de extensión que use un plan de lanzamiento personalizado, usa el siguiente comando gcloud compute global-vm-extension-policies create:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/CUSTOM_PLAN_NAME

Reemplaza las siguientes variables en el comando:

  • POLICY_NAME: Es el nombre de la política de extensión de VM.
  • PROJECT_ID: Es el identificador del proyecto.

  • CUSTOM_PLAN_NAME: Es el nombre asociado con tu plan de lanzamiento personalizado.

Administra el Agente de operaciones actualizando las políticas de extensión de VM

Para cambiar la forma en que una política administra el Agente de operaciones, actualiza la política. Cuando actualizas una política, el Gestor de extensiones de VM implementa los cambios en todas las VMs aplicables, por lo general, en un minuto. Si modificas las etiquetas de inclusión, es posible que el agente de operaciones se instale en VMs nuevas o se desinstale de VMs existentes según si las VMs coinciden con las etiquetas actualizadas.

En las siguientes secciones, se muestra cómo administrar el agente de operaciones para realizar las siguientes acciones:

Actualiza la versión fijada del Agente de operaciones en todas las VMs de una zona

Para cambiar la versión fijada del agente de operaciones en todas las VMs de una zona, haz lo siguiente:

Console

Para crear una política zonal, puedes usar la consola de Google Cloud .

  1. En la consola de Google Cloud , ve a la página Políticas de extensiones:

    Ir a Políticas de extensiones

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

  2. Selecciona la política que deseas actualizar.
  3. Haz clic en Editar.
  4. En la sección Administrar extensiones, haz lo siguiente:
    1. Selecciona Google Cloud's Extension for Ops Agent.
    2. Modifica el campo Versión. Usa la versión 2.58.0 o una posterior.
    3. Haz clic en Listo.
  5. Haz clic en Guardar.

gcloud

Para crear una política zonal o global, puedes usar gcloud CLI.

Zonal

Usa el comando gcloud compute zone-vm-extension-policies update con la opción --version para modificar la versión del agente fijada.

Cuando actualizas una política con gcloud, la solicitud actúa como un reemplazo completo. Cualquier campo opcional que omitas se restablecerá a sus valores predeterminados en lugar de conservar los valores existentes de la política modificada.

Para cambiar la versión del Agente de operaciones instalado en todas las VMs de una zona con una política, usa el siguiente comando:

gcloud compute zone-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --version=ops-agent=VERSION

Reemplaza las siguientes variables en el comando:

  • POLICY_NAME: Es el nombre de la política de extensión de VM.
  • PROJECT_ID: Es el identificador del proyecto.
  • ZONE: Es la zona de destino, por ejemplo, us-central1-f.

Global

Usa el comando gcloud compute global-vm-extension-policies update con la opción --version para modificar la versión del agente fijada.

Cuando actualizas una política con gcloud, la solicitud actúa como un reemplazo completo. Cualquier campo opcional que omitas se restablecerá a sus valores predeterminados en lugar de conservar los valores existentes de la política modificada.

Para cambiar la versión del Agente de operaciones instalado en todas las VMs con una política global, usa el siguiente comando:

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --version=ops-agent=VERSION

Reemplaza las siguientes variables en el comando:

  • POLICY_NAME: Es el nombre de la política de extensión de VM.
  • PROJECT_ID: Es el identificador del proyecto.

Modifica la configuración del agente de operaciones en todas las VMs

Para modificar la configuración del Agente de operaciones, haz lo siguiente:

Console

Para crear una política zonal, puedes usar la consola de Google Cloud .

  1. En la consola de Google Cloud , ve a la página Políticas de extensiones:

    Ir a Políticas de extensiones

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

  2. Selecciona la política que deseas actualizar.
  3. Haz clic en Editar.
  4. En la sección Administrar extensiones, haz lo siguiente:
    1. Selecciona Google Cloud's Extension for Ops Agent.
    2. Modifica el campo Contenido del archivo de configuración.
    3. Haz clic en Listo.
  5. Haz clic en Guardar.

gcloud

Para crear una política zonal o global, puedes usar gcloud CLI.

Zonal

Usa gcloud compute zone-vm-extension-policies update con la opción --config-from-file o la opción --config para especificar una configuración nueva.

Cuando actualizas una política con gcloud, la solicitud actúa como un reemplazo completo. Cualquier campo opcional que omitas se restablecerá a sus valores predeterminados en lugar de conservar los valores existentes de la política modificada.

Para cambiar la configuración del Agente de operaciones instalado en todas las VMs de una zona con una política, usa el siguiente comando:

gcloud compute zone-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent 
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

Reemplaza las siguientes variables en el comando:

  • POLICY_NAME: Es el nombre de la política de extensión de VM.
  • PROJECT_ID: Es el identificador del proyecto.
  • ZONE: Es la zona de destino, por ejemplo, us-central1-f.

  • OPS_AGENT_CONFIG_PATH: Es la ruta de acceso a un archivo que contiene la cadena de configuración YAML para el agente de operaciones. Este archivo debe existir en el entorno en el que ejecutas el comando de gcloud.

    El archivo YAML de configuración del Agente de operaciones puede ser extenso. Colocar la configuración en un archivo y pasar el archivo a gcloud CLI es mucho menos propenso a errores que intentar ingresar YAML con el formato adecuado en la línea de comandos.

Global

Usa gcloud compute global-vm-extension-policies update con la opción --config-from-file o la opción --config para especificar una configuración nueva.

Cuando actualizas una política con gcloud, la solicitud actúa como un reemplazo completo. Cualquier campo opcional que omitas se restablecerá a sus valores predeterminados en lugar de conservar los valores existentes de la política modificada.

Para cambiar la configuración del Agente de operaciones instalado en todas las VMs a través de una política, usa el siguiente comando:

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="OPS_AGENT_CONFIG_PATH"

Reemplaza las siguientes variables en el comando:

  • POLICY_NAME: Es el nombre de la política de extensión de VM.
  • PROJECT_ID: Es el identificador del proyecto.

  • OPS_AGENT_CONFIG_PATH: Es la ruta de acceso a un archivo que contiene la cadena de configuración YAML para el agente de operaciones. Este archivo debe existir en el entorno en el que ejecutas el comando de gcloud.

    El archivo YAML de configuración del agente de operaciones puede ser extenso. Colocar la configuración en un archivo y pasar el archivo a gcloud CLI es mucho menos propenso a errores que intentar ingresar YAML con el formato adecuado en la línea de comandos.

Si proporcionas una configuración personalizada para el Agente de operaciones cuando creas o actualizas una política de extensión, la política implementa el Agente de operaciones con la configuración personalizada. No es necesario que reinicies el agente de forma manual.

La configuración se almacena con la política de extensión, por lo que no debes incluir datos sensibles, como contraseñas, en la configuración. Dado que la configuración se almacena con la política de extensión, modificar el archivo de configuración no cambia la configuración del agente. Debes actualizar la configuración almacenada con la política usando el comando gcloud adecuado:

Cuando proporcionas una configuración personalizada para el Agente de operaciones, el Gestor de extensiones de VM copia la configuración en la ubicación que usa el Agente de operaciones para los archivos de configuración especificados por el usuario en la VM de destino:

  • Linux: /etc/google-cloud-ops-agent/config.yaml
  • Windows: C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml

Si hay un archivo config.yaml presente en la VM, la política de extensión lo sobrescribe.

Para obtener información general sobre el uso de laGoogle Cloud consola y la gcloud CLI para administrar las políticas de extensiones de VM, consulta Cómo modificar extensiones actualizando una política de extensiones de VM.

Extiende una política global existente para incluir zonas nuevas (solo para políticas globales)

Cuando se crean VMs en zonas nuevas después de que se creó y lanzó una política global, Gestor de extensiones de VM no aplica automáticamente la política a las VMs en las zonas nuevas. Para incluir las VMs en zonas nuevas, debes reiniciar el lanzamiento de la política global.

Para reiniciar el lanzamiento de una política global, usa el comando gcloud compute global-vm-extension-policies update y proporciona la opción --rollout-retry-uuid=UUID.

Por ejemplo, supongamos que creaste y lanzaste una política global con el siguiente comando:

gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --version=ops-agent=2.61.0 \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="/usr/ops-agent-config.yaml"

Para extender la política a las VMs creadas en zonas que no se usaron anteriormente, reinicia el lanzamiento con el siguiente comando:

gcloud compute global-vm-extension-policies update test-policy POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --version=ops-agent=2.61.0 \
  --rollout-predefined-plan=slow_rollout \
  --config-from-file=ops-agent="/usr/ops-agent-config.yaml" \
  --rollout-retry-uuid=UUID

Reemplaza las siguientes variables en el comando:

  • POLICY_NAME: Es el nombre de la política de extensión de VM.
  • PROJECT_ID: Es el identificador del proyecto.

  • UUID: Es un identificador único universal (UUID) que identifica la solicitud de reintento. Puedes usar cualquier generador de UUID para crear uno. Para obtener más información, consulta Cómo reintentar una implementación .

Actualiza una política global para excluir un conjunto de zonas (solo a nivel global)

Para actualizar las zonas a las que se aplica una política global que excluye algunas zonas en un proyecto deGoogle Cloud , debes usar un nuevo plan de lanzamiento personalizado que especifique las zonas en las que se aplicará la política. Para obtener información sobre cómo crear planes de lanzamiento personalizados, consulta Acerca de los planes de lanzamiento. Para especificar un conjunto de zonas, usa el campo locationSelector.includedLocations cuando crees el plan de lanzamiento.

Para actualizar una política de extensión que usa un plan de lanzamiento personalizado, usa el siguiente comando gcloud compute global-vm-extension-policies update:

gcloud compute global-vm-extension-policies update POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --rollout-custom-plan=projects/PROJECT_ID/locations/global/rolloutPlans/NEW_CUSTOM_PLAN_NAME \
  --rollout-retry-uuid=UUID

Reemplaza las siguientes variables en el comando:

  • POLICY_NAME: Es el nombre de la política de extensión de VM.
  • PROJECT_ID: Es el identificador del proyecto.

  • NEW_CUSTOM_PLAN_NAME: Es el nombre asociado con tu plan de lanzamiento personalizado actualizado.
  • UUID: Es un identificador único universal (UUID) que identifica la solicitud de reintento. Puedes usar cualquier generador de UUID para crear uno. Para obtener más información, consulta Cómo reintentar una implementación .

Desinstala el agente de operaciones borrando las políticas de extensión de VM

Para desinstalar el agente de operaciones, borra la política de extensión de VM que administra el agente. Si otra política activa de menor prioridad se aplica a una VM y también administra el Agente de operaciones, el agente permanecerá instalado en esa VM según la política de menor prioridad.

El Gestor de extensiones de VM quita el Agente de operaciones de todas las VMs accesibles en el plazo de un minuto después de que se borra la política. Si no se puede acceder a una VM, VM Extension Manager omite el borrado del agente. Si la VM vuelve a estar disponible, el Gestor de extensiones de VM quitará el agente en ese momento.

Console

  1. En la consola de Google Cloud , ve a la página Políticas de extensiones:

    Ir a Políticas de extensiones

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

  2. Selecciona la política que deseas borrar.
  3. Haz clic en Borrar.
  4. En el diálogo de confirmación, haz clic en Borrar.

gcloud

Zonal

Para borrar la política de extensión de VM que administra el agente de operaciones, usa el comando gcloud compute zone-vm-extension-policies delete:

gcloud compute zone-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Reemplaza las siguientes variables en el comando:

  • POLICY_NAME: Es el nombre de la política de extensión de VM.
  • PROJECT_ID: Es el identificador del proyecto.
  • ZONE: Es la zona de destino, por ejemplo, us-central1-f.

Global

Para borrar la política global de extensión de VM que administra el agente de operaciones, usa el comando gcloud compute global-vm-extension-policies delete:

gcloud compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=slow_rollout

Reemplaza las siguientes variables en el comando:

  • POLICY_NAME: Es el nombre de la política de extensión de VM.
  • PROJECT_ID: Es el identificador del proyecto.

Para acelerar un lanzamiento de eliminación que ya se inició, emite un nuevo comando de eliminación que use el plan fast_rollout. También debes especificar la opción --rollout-retry-uuid=UUID:

gcloud compute global-vm-extension-policies delete POLICY_NAME \
  --project=PROJECT_ID \
  --rollout-predefined-plan=fast_rollout \
  --rollout-retry-uuid=UUID

Reemplaza las siguientes variables en el comando:

  • POLICY_NAME: Es el nombre de la política de extensión de VM.
  • PROJECT_ID: Es el identificador del proyecto.

  • UUID: Es un identificador único universal (UUID) que identifica la solicitud de reintento. Puedes usar cualquier generador de UUID para crear uno. Para obtener más información, consulta Cómo reintentar una implementación .

Recupera información sobre las políticas de extensión de VM

Puedes recuperar la siguiente información sobre las políticas de extensión de VM existentes:

  • Una lista de todas las políticas de tu Google Cloud proyecto.
  • Es información de configuración sobre una política específica.

Console

  1. En la consola de Google Cloud , ve a la página Políticas de extensiones:

    Ir a Políticas de extensiones

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

    En esta página, se enumeran todas las políticas de extensión de VM en tu proyecto.
  2. Para ver los detalles de una política de extensión específica, haz clic en el nombre de la política.

gcloud

Zonal

Enumera las políticas de extensión de VM

Para enumerar información sobre todas las políticas de extensión de VM en una zona, usa gcloud compute zone-vm-extension-policies list:

gcloud compute zone-vm-extension-policies list \
  --project=PROJECT_ID \
  --zone=ZONE \
  --page-size=PAGE_SIZE_INTEGER

Reemplaza las siguientes variables en el comando:

  • PROJECT_ID: Es el identificador del proyecto.
  • ZONE: Es la zona de destino, por ejemplo, us-central1-f.
  • PAGE_SIZE_INTEGER: Es la cantidad de políticas que se enumerarán por página; por ejemplo, 2. Para obtener más información sobre las opciones de ordenamiento y filtrado, consulta gcloud compute zone-vm-extension-policies list.

Describe una política de extensión de VM con nombre

Para recuperar la configuración de una política con nombre en una zona, usa gcloud compute zone-vm-extension-policies describe:

gcloud compute zone-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Reemplaza las siguientes variables en el comando:

  • POLICY_NAME: Es el nombre de la política de extensión de VM.
  • PROJECT_ID: Es el identificador del proyecto.
  • ZONE: Es la zona de destino, por ejemplo, us-central1-f.

Global

Enumera las políticas de extensión de VM globales

Para enumerar información sobre las políticas de extensión de VM globales, usa gcloud compute global-vm-extension-policies list:

gcloud compute global-vm-extension-policies list \
  --project=PROJECT_ID \
  --page-size=PAGE_SIZE_INTEGER

Reemplaza las siguientes variables en el comando:

  • PROJECT_ID: Es el identificador del proyecto.
  • PAGE_SIZE_INTEGER: Es la cantidad de políticas que se enumerarán por página; por ejemplo, 2. Para obtener más información sobre las opciones de ordenamiento y filtrado, consulta gcloud compute global-vm-extension-policies list.

Describe una política de extensión de VM global con nombre

Para recuperar la configuración de una política con nombre en una zona, usa gcloud compute global-vm-extension-policies describe:

gcloud compute global-vm-extension-policies describe POLICY_NAME \
  --project=PROJECT_ID

Reemplaza las siguientes variables en el comando:

  • POLICY_NAME: Es el nombre de la política de extensión de VM.
  • PROJECT_ID: Es el identificador del proyecto.

Para obtener información general sobre el uso de la consola deGoogle Cloud y gcloud CLI para recuperar información sobre las políticas de extensiones de VM, consulta Cómo ver las políticas de extensiones.

Verifica la instalación del agente de operaciones

En esta sección, se describe cómo hacer lo siguiente:

Verifica el estado o la versión de una instalación del agente de operaciones

Para determinar el estado o la versión del agente de operaciones, usa una de las siguientes páginas de la consola deGoogle Cloud :

Compute Engine

  1. En la consola de Google Cloud , ve a la página Instancias de VM.

    Ir a Instancias de VM

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

  2. Selecciona una VM de la lista.
  3. Haz clic en la pestaña Observabilidad.

Cloud Monitoring

  1. En la consola de Google Cloud , ve a la página Instancias de VM.

    Ir a Instancias de VM

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

  2. Selecciona la vista Lista.

Cuando el agente de operaciones se instala en la VM y recopila registros y métricas, el estado del agente se marca con una marca de verificación verde junto a la etiqueta Agente de operaciones.

Para determinar la versión del agente instalado, coloca el cursor sobre la etiqueta Agente de operaciones en el panel de Compute Engine o Monitoring.

Verifica que el agente de operaciones recopile datos de telemetría

Si el Agente de operaciones se instaló correctamente y se ejecuta de manera adecuada, envía métricas a Cloud Monitoring y registros a Cloud Logging.

Reinicia un agente de operaciones instalado por una política de extensión

Cuando el Agente de operaciones está instalado y administrado por el Gestor de extensiones de VM, el Agente de operaciones no está administrado por 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, los comandos systemctl de Linux y los comandos *-Service de Windows no funcionan con un agente de operaciones instalado por una política de extensión.

Para reiniciar un agente de operaciones que se instaló con una política de extensión, haz una de las siguientes acciones:

  • Vuelve a crear la política.

    1. Borra la política. Si borras la política, se detendrá y desinstalará el agente de operaciones.

    2. Crea una política nueva. La nueva política instala el agente de operaciones y lo inicia.

  • Usar una política temporal de mayor prioridad Si la política original afecta a una gran cantidad de VMs, pero solo deseas reiniciar el Agente de operaciones en una pequeña cantidad, agrega una etiqueta a esas VMs y configura la nueva política para filtrar por la etiqueta.

    Por ejemplo, si una política con prioridad 1,000 no pudo iniciar el Agente de operaciones en una VM, puedes agregar una etiqueta como status=failed a la VM. Luego, crea una política nueva con una prioridad más alta, como 500. Por ejemplo, un comando de Google Cloud CLI podría verse de la siguiente manera:

    Zonal 

    gcloud compute zone-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --zone=ZONE \
  --extensions=ops-agent  \
  --inclusion-labels=status=failed \
  --priority=500 \
  --config-from-file=ops-agent=/usr/ops-agent-config.yaml

    Reemplaza las siguientes variables en el comando:

    • POLICY_NAME: Es el nombre de la política de extensión de VM.
    • PROJECT_ID: Es el identificador del proyecto.
    • ZONE: Es la zona de destino, por ejemplo, us-central1-f.

    Global 

    gcloud compute global-vm-extension-policies create POLICY_NAME \
  --project=PROJECT_ID \
  --extensions=ops-agent  \
  --inclusion-labels=status=failed \
  --priority=500 \
  --config-from-file=ops-agent=/usr/ops-agent-config.yaml \
  --rollout-predefined-plan=fast_rollout

    Reemplaza las siguientes variables en el comando:

    • POLICY_NAME: Es el nombre de la política de extensión de VM.
    • PROJECT_ID: Es el identificador del proyecto.

    Después de que la nueva política instale correctamente el Agente de operaciones, borra la política y quita la etiqueta de las VMs. El agente de operaciones permanece instalado en la VM porque la política original sigue activa.

Habilita el registro de depuración del agente de invitado en la VM

Las políticas del Administrador de extensiones de VM usan el agente invitado de Compute Engine para administrar el Agente de operaciones como una extensión de VM. Para obtener información sobre cómo habilitar el registro de depuración para el agente invitado, consulta Cómo ver los registros de depuración del agente invitado.

Soluciona problemas relacionados con las políticas de extensiones

En esta sección, se proporciona información para solucionar problemas relacionados con el uso de políticas de extensión para administrar el Agente de operaciones:

Para obtener información sobre la solución de 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 el problema. 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 Administrador 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 el 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 detecta una condición de error que impide su ejecución.

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 Administrador 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 ningún registro, 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 instala 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 extensiones no instala el Agente de operaciones

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

  • El agente 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 no está instalado el google-guest-agent, 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 posterior.

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

  • El sistema operativo de la VM no es compatible con el Administrador 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". Es posible que el problema sea 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 Cómo ver 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") "El archivo de configuración del agente no es válido"

Linux

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

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

Windows

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

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:

  • Para corregir la configuración, consulta Configura el agente de operaciones. Información sobre la estructura de un archivo de configuración del agente de operaciones

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

Los comandos de Linux systemctl status y Windows Get-Service 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 Agente de operaciones está instalado y es administrado por el Administrador de extensiones de VM, el Agente de operaciones no es administrado por el servicio de administración del sistema del sistema operativo, 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 Administrador de extensiones de VM, consulta lo siguiente:

Los comandos de Linux systemctl restart y Windows Restart-Service 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 Agente de operaciones está instalado y administrado por el Gestor de extensiones de VM, el Agente de operaciones no está administrado por 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 siguientes comandos 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 extensión. Para obtener más información sobre cómo detener o reiniciar el agente de operaciones, consulta Cómo reiniciar un agente de operaciones instalado por una política de extensiones.

Información adicional para solucionar problemas

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

Para obtener más información sobre la solución de problemas del agente de operaciones, consulta Soluciona problemas del agente de operaciones.

Cuota

Para obtener información sobre la cantidad de políticas de extensión que puedes crear en un proyecto de Google Cloud , consulta Quota.

Precios

Para obtener información sobre los costos asociados con el uso de Gestor de extensiones de VM, consulta Precios.

Si instalas el agente de operaciones, es posible que se te cobre por las métricas, los registros o los seguimientos que el agente envía a tu proyecto de Google Cloud . Para obtener información sobre los precios, consulta los precios de Google Cloud Observability.

¿Qué sigue?