Instalar y gestionar el agente de operaciones mediante políticas de VM Extension Manager

Puedes instalar y gestionar el agente de operaciones en un conjunto de máquinas virtuales de Compute Engine de una zona específica mediante las políticas de VM Extension Manager. Por ejemplo, puedes usar estas políticas para realizar tareas como las siguientes:

  • Instalación a nivel de infraestructura: 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 versiones:

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

  • Gestión de la configuración: aplica una configuración personalizada al agente de operaciones en todas las VMs gestionadas por una política.

Con VM Extension Manager, puedes crear políticas que declaren qué extensiones quieres instalar en las VMs. El agente de operaciones es una de las extensiones disponibles. Las políticas de VM Extension Manager pueden gestionar 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 gestionar 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 antiguo agente de Monitoring o del agente de Logging.

Puedes crear y gestionar políticas de extensiones de VM mediante la Google Cloud consola o la CLI de Google Cloud, gcloud.

Antes de empezar

Antes de empezar a usar las políticas de la extensión VM Extension Manager, haz lo siguiente:

Consultar los sistemas operativos compatibles

Antes de intentar usar las políticas de VM Extension Manager para gestionar el agente de operaciones, comprueba que tu sistema operativo de destino sea compatible tanto con el agente de operaciones como con VM Extension Manager.

VM Extension Manager es compatible con todos los sistemas operativos admitidos por 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 Ops, consulta Sistemas operativos.

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

Habilitar las APIs necesarias para usar el Agente de operaciones

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

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

Roles necesarios para usar el agente de Ops

Para obtener los permisos que necesitas para usar el agente de Ops con el fin de escribir registros y métricas, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos en tu cuenta de servicio:

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

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

Roles necesarios para usar el administrador de extensiones de VM

Para obtener los permisos que necesitas para crear, ver, modificar y eliminar políticas de extensiones de VM, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos en el proyecto:

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar acceso a proyectos, carpetas y organizaciones.

Estos roles predefinidos contienen los permisos necesarios para crear, ver, modificar y eliminar políticas de extensiones de VM. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:

Permisos obligatorios

Para crear, ver, modificar y eliminar políticas de extensiones de VM, se necesitan los siguientes permisos:

  • Para crear políticas de extensiones, sigue estos pasos: compute.vmExtensionPolicies.create
  • Para ver las políticas de extensiones, sigue estos pasos: compute.vmExtensionPolicies.list
  • Para ver los detalles de una política de extensiones, sigue estos pasos: compute.vmExtensionPolicies.get
  • Para modificar las políticas de extensiones, sigue estos pasos: compute.vmExtensionPolicies.update
  • Para eliminar políticas de extensiones, sigue estos pasos: compute.vmExtensionPolicies.delete

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

Para obtener más información sobre los roles y permisos de gestión de identidades y accesos en Compute Engine, consulta el artículo sobre roles y permisos de Compute Engine.

Instalar Google Cloud CLI

Puedes crear y gestionar políticas de extensiones de VM mediante la Google Cloud consola o la CLI de Google Cloud, gcloud. Para usar gcloud, primero debes instalarlo siguiendo estos pasos:

  1. Si aún no lo has hecho, instala la CLI de Google Cloud.

    Las políticas de extensiones descritas en este documento usan el grupo de comandos beta.

  1. Si aún no lo has hecho, instala el componente beta de la CLI de gcloud 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 has instalado el componente beta, comprueba que tienes 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 gestionar el Agente de operaciones en una VM, asegúrate de que no haya instancias del Agente de operaciones ni del agente de Monitoring ni del agente de Logging antiguos en la VM. Si ejecutas el agente de operaciones y los agentes antiguos en la misma máquina virtual, se pueden ingerir registros duplicados o producirse conflictos en la ingestión de métricas.

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

La forma de quitar agentes depende de cómo se hayan instalado.

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

Crea políticas de extensión de VM para instalar y gestionar automáticamente el agente de operaciones en un conjunto de máquinas virtuales de Compute Engine. Si defines una política, puedes asegurarte de que determinadas extensiones, como el agente de operaciones, se instalen y se mantengan en las VMs que cumplan los criterios que especifiques, como las etiquetas de las VMs.

Conflictos y prioridades de las políticas

VM Extension Manager asocia una prioridad a cada política nueva. Los números más bajos indican prioridades más altas. La prioridad predeterminada es 1000. Una VM puede estar cubierta por varias políticas de una extensión, como el agente de operaciones, pero solo una política de 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.

Instalar 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 publique una nueva versión, haz lo siguiente:

Consola

  1. En la Google Cloud consola, 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 sea Compute Engine.

  2. Haz clic en + Crear.
  3. En el campo Name (Nombre), introduce un nombre para la política.
  4. Opcional: En el campo Descripción, escribe una descripción de la política.
  5. En el campo Priority (Prioridad), especifica un número de prioridad para resolver los conflictos entre políticas. Cuanto más bajo sea el número, mayor será la prioridad. El valor predeterminado es 1000.

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

  7. En la sección Gestionar extensiones, haz clic en Añadir extensión y sigue estos pasos:

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

  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

Sustituye las siguientes variables en el comando:

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

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

Fijar el agente de operaciones en una versión específica en todas las máquinas virtuales de una zona

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

Consola

  1. En la Google Cloud consola, 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 sea Compute Engine.

  2. Haz clic en + Crear.
  3. En el campo Name (Nombre), introduce un nombre para la política.
  4. Opcional: En el campo Descripción, escribe una descripción de la política.
  5. En el campo Priority (Prioridad), especifica un número de prioridad para resolver los conflictos entre políticas. Cuanto más bajo sea el número, mayor será la prioridad. El valor predeterminado es 1000.

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

  7. En la sección Gestionar extensiones, haz clic en Añadir 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 quieras 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

Sustituye las siguientes variables en el comando:

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

  • VERSION: la versión del agente de operaciones que se va a instalar. Usa la versión 2.58.0 o una posterior.

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

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

Instalar el agente de operaciones en máquinas virtuales 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:

Consola

  1. En la Google Cloud consola, 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 sea Compute Engine.

  2. Haz clic en + Crear.
  3. En el campo Name (Nombre), introduce un nombre para la política.
  4. Opcional: En el campo Descripción, escribe una descripción de la política.
  5. En el campo Priority (Prioridad), especifica un número de prioridad para resolver los conflictos entre políticas. Cuanto más bajo sea el número, mayor será la prioridad. El valor predeterminado es 1000.

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

  7. En la sección Extensiones, haga clic en Añadir extensión y siga estos pasos:

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

  8. En la sección Instancias de VM de destino, selecciona las VMs de la política. Para seleccionar VMs con etiquetas específicas, haz clic en Añadir etiquetas y añade 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

Sustituye las siguientes variables en el comando:

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

  • KEY1=VALUE1,KEY2=VALUE2: lista de pares clave-valor separados por comas que definen etiquetas de inclusión para un selector. Las VMs deben tener todas las etiquetas especificadas en un selector (AND lógico) para incluirse. Si especifica la opción --inclusion_labels varias veces, la política se aplicará a las VMs que coincidan con todas las etiquetas de cualquiera de los selectores (es decir, funciona como un operador lógico OR). Si omite esta opción, la política se aplicará a todas las VMs de la zona especificada.

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

Consola

  1. En la Google Cloud consola, 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 sea Compute Engine.

  2. Haz clic en + Crear.
  3. En el campo Name (Nombre), introduce un nombre para la política.
  4. Opcional: En el campo Descripción, escribe una descripción de la política.
  5. En el campo Priority (Prioridad), especifica un número de prioridad para resolver los conflictos entre políticas. Cuanto más bajo sea el número, mayor será la prioridad. El valor predeterminado es 1000.

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

  7. En la sección Extensiones, haga clic en Añadir extensión y siga estos pasos:

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

  8. Haz clic en Crear.

gcloud

Usa la opción --config-from-file del 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"

Sustituye las siguientes variables en el comando:

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

  • OPS_AGENT_CONFIG_PATH: Ruta a un archivo que contiene la cadena de configuración YAML del Agente de operaciones. Este archivo debe estar en el entorno en el que ejecutes el comando gcloud.

    El archivo YAML de configuración del agente de operaciones puede ser largo. Es mucho menos probable que se produzcan errores si se incluye la configuración en un archivo y se pasa el archivo a la CLI de gcloud que si se intenta introducir YAML con el formato correcto en la línea de comandos. Si cambias este archivo después de crear la política, esta no se actualizará. 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 al crear o actualizar una política de extensión, la política implementará el agente de operaciones con la configuración personalizada. No es necesario que reinicies el agente manualmente.

La configuración se almacena con la política de la extensión, por lo que no debes incluir datos sensibles, como contraseñas, en la configuración. Como la configuración se almacena con la política de extensiones, modificar el archivo de configuración no cambia la configuración del agente. Para actualizar la configuración almacenada con la política, debes usar 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 en la máquina virtual, la política de extensiones 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 el artículo Instalar extensiones de VM creando políticas de extensiones .

Gestionar el agente de operaciones actualizando las políticas de extensiones de máquinas virtuales

Para cambiar la forma en que una política gestiona el agente de operaciones, actualiza la política. Cuando actualizas una política, VM Extension Manager implementa los cambios en todas las VMs aplicables, normalmente en un minuto. Si modificas las etiquetas de inclusión, es posible que el Agente de operaciones se instale en máquinas virtuales nuevas o se desinstale de máquinas virtuales actuales en función de si las máquinas virtuales coinciden con las etiquetas actualizadas.

En las siguientes secciones se muestra cómo gestionar el agente de Ops para hacer lo siguiente:

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

Consola

  1. En la Google Cloud consola, 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 sea Compute Engine.

  2. Selecciona la política que quieras actualizar.
  3. Haz clic en Editar.
  4. En la sección Gestionar 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 gcloud beta compute zone-vm-extension-policies update con el comando de opción --version para modificar la versión del agente fijada.

Cuando actualizas una política mediante gcloud, la solicitud actúa como una sustitución completa. Los campos opcionales que omitas volverán a sus valores predeterminados en lugar de conservar los valores de la política modificada.

Para cambiar la versión del agente de operaciones instalado en todas las VMs de una zona mediante 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

Sustituye las siguientes variables en el comando:

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

  • VERSION: la versión del agente de operaciones que se va a instalar. Usa la versión 2.58.0 o una posterior. Para ver una lista de versiones, consulta la página de lanzamientos de Ops Agent en GitHub.

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

Modificar la configuración del agente de operaciones en todas las máquinas virtuales de una zona

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

Consola

  1. En la Google Cloud consola, 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 sea Compute Engine.

  2. Selecciona la política que quieras actualizar.
  3. Haz clic en Editar.
  4. En la sección Gestionar 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 nueva configuración.

Cuando actualizas una política mediante gcloud, la solicitud actúa como una sustitución completa. Los campos opcionales que omitas volverán a sus valores predeterminados en lugar de conservar los valores de la política modificada.

Para cambiar la configuración del agente de operaciones instalado en todas las VMs de una zona mediante 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"

Sustituye las siguientes variables en el comando:

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

  • OPS_AGENT_CONFIG_PATH: Ruta a un archivo que contiene la cadena de configuración YAML del Agente de operaciones. Este archivo debe estar en el entorno en el que ejecutes el comando gcloud.

    El archivo YAML de configuración del agente de operaciones puede ser largo. Es mucho menos probable que se produzcan errores si se incluye la configuración en un archivo y se pasa el archivo a la CLI de gcloud que si se intenta introducir YAML con el formato correcto en la línea de comandos.

Si proporcionas una configuración personalizada para el agente de operaciones al crear o actualizar una política de extensión, la política implementará el agente de operaciones con la configuración personalizada. No es necesario que reinicies el agente manualmente.

La configuración se almacena con la política de la extensión, por lo que no debes incluir datos sensibles, como contraseñas, en la configuración. Como la configuración se almacena con la política de extensiones, modificar el archivo de configuración no cambia la configuración del agente. Debes actualizar la configuración almacenada con la política mediante 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 en la máquina virtual, la política de extensiones lo sobrescribe.

Para obtener información general sobre cómo usar la consolaGoogle Cloud y la CLI de gcloud para gestionar las políticas de extensiones de máquinas virtuales, consulta Modificar extensiones actualizando una política de extensiones de máquinas virtuales.

Desinstalar el agente de operaciones eliminando las políticas de extensión de la VM

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

VM Extension Manager elimina el Agente de operaciones de todas las VMs accesibles en un minuto después de eliminar la política. Si no se puede acceder a una máquina virtual, el gestor de extensiones de máquinas virtuales omite la eliminación del agente. Si la VM vuelve a estar disponible, VM Extension Manager eliminará el agente en ese momento.

Consola

  1. En la Google Cloud consola, 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 sea Compute Engine.

  2. Selecciona la política que quieras eliminar.
  3. Haz clic en Eliminar.
  4. En el cuadro de diálogo de confirmación, haz clic en Eliminar.

gcloud

Para eliminar la política de extensión de VM que gestiona 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

Sustituye las siguientes variables en el comando:

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

Recuperar información sobre las políticas de extensiones de VM

Puede obtener la siguiente información sobre las políticas de extensiones de MV:

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

Consola

  1. En la Google Cloud consola, 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 sea Compute Engine.

    En esta página se muestran todas las políticas de extensiones de VM de tu proyecto.
  2. Para ver los detalles de una política de extensiones específica, haz clic en su nombre.

gcloud

Mostrar políticas de extensiones de VM

Para mostrar información sobre todas las políticas de extensiones de VM de una zona, usa el comando 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

Sustituye las siguientes variables en el comando:

  • PROJECT_ID: identificador del proyecto.
  • ZONE: la zona objetivo; por ejemplo, us-central1-f.
  • PAGE_SIZE_INTEGER: número de políticas que se mostrarán por página. Por ejemplo, 2. Para obtener más información sobre las opciones de ordenación 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 el comando gcloud beta compute zone-vm-extension-policies describe:

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

Sustituye las siguientes variables en el comando:

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

Para obtener información general sobre cómo usar la consola de Google Cloud y la CLI de gcloud para recuperar información sobre las políticas de extensiones de VM, consulta Ver políticas de extensiones.

Verificar la instalación del agente de operaciones

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

Verificar 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 Ops, utilice una de las siguientes páginas de la consola deGoogle Cloud :

Compute Engine

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

    Ve a Instancias de VM.

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

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

Cloud Monitoring

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

    Ve a Instancias de VM.

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Monitorización.

  2. Selecciona la vista Lista.

Cuando el agente de operaciones se haya instalado en la VM y esté recogiendo registros y métricas, su estado se marcará 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 control de Compute Engine o Monitoring.

Verificar que el agente de operaciones está recogiendo telemetría

Si el Agente de operaciones se ha instalado correctamente y funciona bien, envía métricas a Cloud Monitoring y registros a Cloud Logging.

Reiniciar un Agente de operaciones instalado mediante una política de extensión

Cuando el agente de operaciones está instalado y gestionado por el gestor de extensiones de VM, no lo gestiona el servicio de gestión del sistema del sistema operativo, es decir, systemd en Linux o el gestor de servicios de Windows en Windows. Por lo tanto, los comandos de Linux systemctl y los comandos de Windows *-Service no funcionan con un agente de operaciones instalado mediante una política de extensiones.

Para reiniciar un agente de Ops que se haya instalado mediante una política de extensión, haz una de las siguientes acciones:

  • Vuelve a crear la política.

    1. Eliminar la política. Si se elimina la política, se detendrá y desinstalará el agente de Ops.

    2. Crea una política. 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 un gran número de máquinas virtuales, pero solo quieres reiniciar el Agente de operaciones en un número reducido de ellas, añade una etiqueta a esas máquinas virtuales y configura la nueva política para que filtre por la etiqueta.

    Por ejemplo, si una política con prioridad 1000 no ha podido iniciar el agente de operaciones en una VM, puedes añadir una etiqueta como status=failed a la VM. A continuación, crea una política con una prioridad más alta, como 500. Por ejemplo, un comando de la CLI de Google Cloud podría tener el siguiente aspecto:

    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

    Sustituye las siguientes variables en el comando:

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

    Una vez que la nueva política haya instalado correctamente el agente de operaciones, elimínala y quita la etiqueta de las VMs. El agente de operaciones sigue instalado en la VM porque la política original sigue activa.

Habilitar el registro de depuración del agente invitado en la máquina virtual

Las políticas de VM Extension Manager usan el agente invitado de Compute Engine para gestionar el agente de operaciones como una extensión de VM. Para obtener información sobre cómo habilitar el registro de depuración del agente invitado, consulta Ver los registros de depuración del agente invitado.

Solucionar problemas con las políticas de extensiones

En esta sección se proporciona información sobre cómo solucionar problemas relacionados con el uso de políticas de extensiones para gestionar el agente de operaciones:

Para obtener información sobre cómo solucionar problemas con el agente de operaciones, consulta Solucionar problemas con el agente de operaciones.

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

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

Si el resultado del comando menciona que no tienes suficientes permisos de gestión de identidades y accesos, consulta los roles y permisos necesarios que se describen en Conceder los roles necesarios para usar Gestor de extensiones de VM.

Se ha creado la política de extensión, pero el estado del agente de operaciones es "no detectado"

Has creado correctamente una política de extensiones, pero el agente de operaciones muestra el estado "no detectado" en la VM.

Es posible que el agente de Ops se muestre 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 se encuentra con una condición de error que le impide ejecutarse.

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

Verificar que la política ha instalado el agente de operaciones

Las políticas de VM Extension Manager usan el agente invitado de Compute Engine para gestionar el agente de operaciones como una extensión de VM.

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

Explorador de registros

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

    Ve al Explorador de registros.

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Registro.

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

    log_id("GCEGuestAgentManager")

Linux

Ejecuta el siguiente comando en la máquina virtual de Compute Engine:

journalctl -u google-guest-agent-manager

Windows

Ejecuta el siguiente comando en la máquina virtual 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 extensiones no ha podido instalar el agente de Ops. Para ver los pasos siguientes, consulta La política de extensiones 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 extensiones ha instalado correctamente el agente de operaciones. Para ver los pasos siguientes, consulta El agente de operaciones instalado no se detecta.

La política de extensiones no instala el agente de operaciones

Una política de extensiones puede no ser eficaz si se da una de las siguientes circunstancias:

  • El agente invitado no está instalado en la VM. Para diagnosticar y solucionar este problema, haz lo siguiente:

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

    2. Consulta los paquetes instalados en la máquina virtual para comprobar que google-guest-agent está incluido.

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

  • El agente invitado está instalado, pero obsoleto. Para diagnosticar y solucionar este problema, 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 una posterior.

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

  • El sistema operativo de la máquina virtual no es compatible con el administrador de extensiones de VM. Para obtener más información, consulta la sección sobre 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:

Verificar que la configuración del agente de operaciones sea válida

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

Habilitar el registro de depuración del agente invitado

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

Examinar los registros de depuración

Explorador de registros

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

    Ve al Explorador de registros.

    Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuya sección sea Registro.

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

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

Linux

Ejecuta el siguiente comando en la máquina virtual de Linux Compute Engine:

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

Windows

Ejecuta el siguiente comando en la máquina virtual 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, significa que la configuración personalizada del agente de operaciones que has proporcionado al crear o actualizar la política de extensión no es válida.

Para solucionar este problema, sigue estos pasos:

  • Para corregir la configuración, consulta el artículo Configurar el agente de operaciones. Para obtener 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 ninguna información.

Cuando el agente de operaciones está instalado y gestionado por el gestor de extensiones de VM, no lo gestiona el servicio de gestión del sistema del sistema operativo, es decir, systemd en Linux o el gestor de servicios de Windows en Windows.

Para consultar la información de estado de un agente de Ops gestionado 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 Ops no se reinicia.

Cuando el agente de operaciones está instalado y gestionado por el gestor de extensiones de VM, no lo gestiona el servicio de gestión del sistema del sistema operativo, es decir, systemd en Linux o el gestor de servicios de Windows en Windows. Por lo tanto, no puedes detener ni iniciar el agente de Ops manualmente, y los comandos como los siguientes no funcionan con el agente de Ops:

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

Para detener o reiniciar un agente de Ops gestionado por VM Extension Manager, debes desinstalar el agente eliminando la política de extensión. Para obtener más información sobre cómo detener o reiniciar el agente de Ops, consulta Reiniciar un agente de Ops instalado mediante una política de extensiones.

Información adicional para solucionar problemas

Para obtener más información sobre cómo solucionar problemas relacionados con la creación y el uso de políticas de VM Extension Manager, consulta el artículo Solucionar problemas de extensiones de VM.

Para obtener más información sobre cómo solucionar problemas con el agente de operaciones, consulta el artículo Solucionar problemas con el agente de operaciones.

Cuota

Para obtener información sobre el número de políticas de extensiones que puedes crear en un proyecto de Google Cloud , consulta Quota.

Precios

Para obtener información sobre los costes asociados al uso de VM Extension Manager, consulta la página Precios.

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

Siguientes pasos