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 dentro de una zona específica con las políticas de VM Extension Manager. 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 todas las VMs de una zona o en un subconjunto de VMs identificadas por etiquetas en una zona.

  • 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 VM Extension Manager, 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 de VM Extension Manager pueden administrar la versión 2.58.0 o posterior del Agente de operaciones cuando este se haya instalado con VM Extension Manager. 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 con la Google Cloud consola o la CLI de Google Cloud, gcloud.

Antes de comenzar

Antes de comenzar a usar las políticas de extensión de VM Extension Manager, 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 Administrador 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 VM Extension Manager, 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 required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

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 VM Extension Manager

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 Google Cloud consola o la CLI de Google Cloud, gcloud. Para usar gcloud, primero debes instalarla. Para ello, sigue estos pasos:

  1. Si aún no lo hiciste, instala la Google Cloud CLI.

    Las políticas de extensión que se describen en este documento usan el grupo de comandos beta.

  1. Si aún no lo hiciste, instala el componente beta de gcloud CLI ejecutando el siguiente comando:

    gcloud components install beta

    Para comprobar si tienes instalado el componente beta, ejecuta el siguiente comando:

    gcloud components list

    Si ya instalaste el componente beta, verifica que tengas la versión más reciente:

    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 y del agente de Logging heredados 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

VM Extension Manager 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.

VM Extension Manager 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.

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

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

Console

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

    Ir a Políticas de extensión

    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

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

gcloud beta 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 un nombre para 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 beta 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.

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

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

Console

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

    Ir a Políticas de extensión

    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

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

gcloud beta 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 un nombre para 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.

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 de una zona con 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 que tengan una etiqueta específica, haz lo siguiente:

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. 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

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

gcloud beta 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 un nombre para 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 que se incluyan. 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 de una zona

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

Console

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

    Ir a Políticas de extensión

    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 YAML para el agente de operaciones.

  8. Haz clic en Crear.

gcloud

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

gcloud beta 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 un nombre para 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 la CLI de gcloud 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 beta compute zone-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 beta compute zone-vm-extension-policies update.

Cuando proporcionas una configuración personalizada para el Agente de operaciones, VM Extension Manager 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 la consola deGoogle Cloud y la CLI de gcloud para crear políticas de extensiones de VM, consulta Instala extensiones de VM creando políticas de extensiones .

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, VM Extension Manager implementa los cambios en todas las VMs aplicables, por lo general, en un plazo de 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

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

    Ir a Políticas de extensión

    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

Usa el comando gcloud beta 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 beta 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 un nombre para 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.

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

Para modificar la configuración del Agente de operaciones en todas las VMs de una zona, haz lo siguiente:

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 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

Usa gcloud beta 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 beta 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 un nombre para 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 la CLI de gcloud 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 beta compute zone-vm-extension-policies update.

Cuando proporcionas una configuración personalizada para el Agente de operaciones, VM Extension Manager 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 la consola deGoogle Cloud y la CLI de gcloud para administrar las políticas de extensiones de VM, consulta Cómo modificar extensiones actualizando una política de extensiones de VM.

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.

VM Extension Manager 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, VM Extension Manager 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

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

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

Reemplaza las siguientes variables en el comando:

  • POLICY_NAME: Es un nombre para 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.

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 extensión

    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

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 beta compute zone-vm-extension-policies list:

gcloud beta 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 beta 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 beta compute zone-vm-extension-policies describe:

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

Reemplaza las siguientes variables en el comando:

  • POLICY_NAME: Es un nombre para 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.

Para obtener información general sobre el uso de la consola deGoogle Cloud y la CLI de gcloud 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 List.

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 forma adecuada, envía métricas a Cloud Monitoring y registros a Cloud Logging.

Cómo reiniciar un agente de operaciones instalado por una política de extensión

Cuando VM Extension Manager instala y administra el Agente de operaciones, este 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. 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 política nueva 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 quieres 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:

    gcloud beta 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 un nombre para 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.

    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 de VM Extension Manager 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 beta compute zone-vm-extension-policies fallan

Cuando un comando gcloud beta 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 VM Extension Manager.

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 aparezca como "no detectado" si ocurre alguna de las siguientes situaciones:

  • La política de extensiones no instala 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 de VM Extension Manager 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 extensiones 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 , accede a la página Explorador de registros:

    Accede 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 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. VM Extension Manager requiere la versión 20241209.01 o 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 VM Extension Manager. 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 , accede a la página Explorador de registros:

    Accede 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 VM Extension Manager instala y administra el Agente de operaciones, este 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 VM Extension Manager, 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 VM Extension Manager instala y administra el Agente de operaciones, este 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. 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 VM Extension Manager, 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 VM Extension Manager, 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 Cuota.

Precios

Para obtener información sobre los costos asociados con el uso de VM Extension Manager, 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?