Las políticas del Gestor de extensiones de VM te permiten instalar el Agente de operaciones en una flota de VMs de Compute Engine. Una política de extensión puede instalar el Agente de operaciones de forma global en tu proyecto de Google Cloud o en una zona específica, mantener actualizada la versión del agente y aplicarle una configuración personalizada.
Antes de comenzar
Antes de crear políticas de extensión del Gestor de extensiones de VM para administrar el Agente de operaciones, haz lo siguiente:
Revisa la información general sobre el Gestor de extensiones de VM.
Revisa los sistemas operativos compatibles para verificar que tanto el Agente de operaciones como el Gestor de extensiones de VM sean compatibles con tus sistemas operativos.
Quita los agentes de observabilidad que ya estén instalados en tus VMs.
Habilita las APIs que usan el Agente de operaciones y el Gestor de extensiones de VM.
Otorga los roles necesarios para usar el Gestor de extensiones de VM.
Si deseas usar una interfaz de línea de comandos para crear y administrar políticas de extensión, instala Google Cloud CLI.
Puedes crear y administrar políticas de extensión 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.
Quita los agentes de observabilidad existentes
Antes de crear una política de Gestor de extensiones de VM para el Agente de operaciones, asegúrate de que no haya instancias del Agente de operaciones ni del agente de Monitoring y el 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 instala el agente, pero este no se ejecuta porque se detecta un conflicto.
La forma en que quitas los agentes existentes depende de cómo se instalaron.
Agentes instalados por una política de configuración del SO de VM Manager, que incluye lo siguiente:
- Agente de operaciones instalado con la consola deGoogle Cloud durante la creación de la VM.
- Agente de operaciones instalado por una política de configuración del SO de VM Manager de DG.
- Agente de operaciones, o agente de Monitoring o de Logging heredado instalado por una política de configuración del SO de VM Manager en versión beta.
Para obtener información sobre cómo identificar las VMs con estas políticas, consulta Busca las VMs que cubren las políticas del SO del Agente de operaciones.
Para obtener información sobre cómo desinstalar el agente y quitar las políticas de configuración del SO, consulta Desinstala el Agente de operaciones en las VMs que cubren las políticas del SO del Agente de operaciones.
Agentes instalados de forma manual con una secuencia de comandos de instalación. Para obtener información sobre cómo desinstalar los agentes, consulta los siguientes vínculos:
- Agente de operaciones: Desinstala el agente.
- Agente de Monitoring heredado: Desinstala el agente.
- Agente de Logging heredado: Desinstala el agente.
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 las 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 obtenerlo a través del
rol de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin).
Obtén más información para otorgar roles.
Otorga los roles necesarios para usar el Agente de operaciones
Para obtener los permisos que necesitas para usar el Agente de operaciones para escribir registros y métricas, pídele a tu administrador que te otorgue los siguientes roles de IAM en tu cuenta de servicio:
-
Para escribir registros, usa el rol de Escritor de registros de Logging (
roles/logging.logWriter). -
Para escribir métricas:
Escritor de métricas de Monitoring (
roles/monitoring.metricWriter)
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.
Habilita la API que usa el Gestor de extensiones de VM
El Gestor de extensiones de VM usa la API de Compute Engine. Habilita esta API en tu proyecto de Google Cloud si aún no está habilitada.
Habilitar la API de Compute Engine
Otorga los roles necesarios para usar el Gestor de extensiones de VM
Para obtener los permisos que necesitas para crear políticas de extensión de VM, pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto:
-
Para crear políticas de extensión:
Administrador de políticas de extensión de VM (
roles/compute.vmExtensionPolicyAdmin)
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 políticas de extensión 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 políticas de extensión de VM:
-
Para crear políticas de extensiones, haz lo siguiente:
compute.vmExtensionPolicies.create
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 extensión 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
Conflictos y prioridades de las políticas
El Gestor de extensiones de VM asocia una prioridad a cada política nueva, y 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 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 predefinidos: Hay dos planes de lanzamiento predefinidos, que se eligen según el valor que se usa con la opción
--rollout-predefined-planpara los comandos de 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.Lanzamiento rápido, que implementa el Agente de operaciones en todas las VMs de destino en 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, que se especifican con la opción
--rollout-custom-planpara los comandos de 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.
Crea políticas de extensión de VM para instalar el Agente de operaciones
Con el Gestor de extensiones de VM, creas políticas que declaran qué extensiones quieres instalar en las VMs. El Agente de operaciones es una de las extensiones disponibles. Si defines una política, puedes asegurarte de que las extensiones compatibles, incluido el Agente de operaciones, se instalen y mantengan en las VMs que coincidan con los criterios que especifiques, como las etiquetas de VM.
Puedes usar políticas de extensión para que el Agente de operaciones realice tareas como las siguientes:
Instalación en toda la flota: Instala el Agente de operaciones en lo siguiente:
- Todas las VMs en una o más zonas de tu proyecto de Google Cloud .
- Todas las VMs de forma global (en tu proyecto de Google Cloud ).
- Un subconjunto de VMs en una zona, identificadas por etiquetas.
- Un subconjunto de VMs en todas las zonas de tu proyecto de Google Cloud , identificadas por etiquetas.
Control de versión:
- Mantén el Agente de operaciones actualizado a la versión más reciente.
- Fija la versión del Agente de operaciones a una versión específica.
Administración de configuraciones: Aplica una configuración personalizada al Agente de operaciones en todas las VMs administradas por una política.
En las siguientes secciones, se proporcionan ejemplos de políticas que instalan el Agente de operaciones según criterios específicos.
El Gestor de extensiones de VM admite la versión 2.58.0 o posterior del Agente de operaciones, cuando este se haya instalado con una política de extensión. El Gestor de extensiones de VM no puede administrar versiones anteriores del Agente de operaciones, instancias del Agente de operaciones instaladas con otros medios, ni el agente de Monitoring o el agente de Logging heredados.
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 .
-
En la consola de Google Cloud , ve a la página 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.
- Haz clic en + Crear.
- En el campo Nombre, ingresa un nombre para la política.
- Opcional: En el campo Descripción, ingresa una descripción para la política.
- En el campo Prioridad, especifica un número de prioridad para resolver conflictos entre políticas. Los números más bajos indican una prioridad más alta. El valor predeterminado es 1000.
- En la lista Zona, selecciona la zona en la que deseas aplicar esta política.
- En la sección Administrar extensiones, haz clic en Agregar extensión
y sigue estos pasos:
- En la lista Extensión, selecciona
Google Cloud's Extension for Ops Agent. - Deja en blanco el campo Versión.
- En la lista Extensión, selecciona
- 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 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 comando create de gcloud compute zone-vm-extension-policies toma una opción --version.
Si omites la opción --version, la política instala la versión más reciente
y actualiza el Agente de operaciones cuando se lanza 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 un nombre para la política de extensión de VM.
- PROJECT_ID: Es el identificador del proyecto.
El comando gcloud compute global-vm-extension-policies create toma una opción --version.
Si omites la opción --version, la política instala la versión más reciente
y actualiza el Agente de operaciones cuando se lanza 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 .
-
En la consola de Google Cloud , ve a la página 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.
- Haz clic en + Crear.
- En el campo Nombre, ingresa un nombre para la política.
- Opcional: En el campo Descripción, ingresa una descripción para la política.
- En el campo Prioridad, especifica un número de prioridad para resolver conflictos entre políticas. Los números más bajos indican una prioridad más alta. El valor predeterminado es 1000.
- En la lista Zona, selecciona la zona en la que deseas aplicar esta política.
- En la sección Administrar extensiones, haz clic en Agregar extensión
y sigue estos pasos:
- En la lista Extensión, selecciona
Google Cloud's Extension for Ops Agent. - En la lista Versión, selecciona la versión que deseas instalar. Usa la versión 2.58.0 o una posterior.
- En la lista Extensión, selecciona
- 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 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 instala la versión más reciente y actualiza el Agente de operaciones cuando se lanza 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 un nombre para 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 instala la versión más reciente y actualiza el Agente de operaciones cuando se lanza 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 del Agente de operaciones en GitHub.
Instala el Agente de operaciones en las 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 .
-
En la consola de Google Cloud , ve a la página 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.
- Haz clic en + Crear.
- En el campo Nombre, ingresa un nombre para la política.
- Opcional: En el campo Descripción, ingresa una descripción para la política.
- En el campo Prioridad, especifica un número de prioridad para resolver conflictos entre políticas. Los números más bajos indican una prioridad más alta. El valor predeterminado es 1000.
- En la lista Zona, selecciona la zona en la que deseas aplicar esta política.
- En la sección Administrar extensiones, haz clic en Agregar extensión
y sigue estos pasos:
- En la lista Extensión, selecciona
Google Cloud's Extension for Ops Agent. - Deja en blanco el campo Versión.
- En la lista Extensión, selecciona
- 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.
- Haz clic en Crear.
gcloud
Para crear una política zonal o global, puedes usar gcloud CLI.
Zonal
Usa la opción --inclusion-labels en el 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 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 (AND lógico) para
incluirse. Si especificas la opción
--inclusion_labelsvarias veces, la política se orientará a las VMs que coincidan con todas las etiquetas de cualquiera de los selectores (operador lógico OR). Si omites esta opción, la política se orienta a todas las VMs de la zona especificada.
Global
Usa la opción --inclusion-labels en el 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 un nombre para 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 (AND lógico) para
incluirse. Si especificas la opción
--inclusion_labelsvarias veces, la política se orientará a las VMs que coincidan con todas las etiquetas de cualquiera de los selectores (operador lógico OR). Si omites esta opción, la política se orienta 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 proporcione una configuración personalizada para el Agente de operaciones, sigue estos pasos:
Console
Para crear una política zonal, puedes usar la consola de Google Cloud .
-
En la consola de Google Cloud , ve a la página 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.
- Haz clic en + Crear.
- En el campo Nombre, ingresa un nombre para la política.
- Opcional: En el campo Descripción, ingresa una descripción para la política.
- En el campo Prioridad, especifica un número de prioridad para resolver conflictos entre políticas. Los números más bajos indican una prioridad más alta. El valor predeterminado es 1000.
- En la lista Zona, selecciona la zona en la que deseas aplicar esta política.
- En la sección Administrar extensiones, haz clic en Agregar extensión
y sigue estos pasos:
- En la lista Extensión, selecciona
Google Cloud's Extension for Ops Agent. - Deja en blanco el campo Versión.
- En el campo Contenido del archivo de configuración, ingresa la cadena de configuración YAML para el Agente de operaciones.
- En la lista Extensión, selecciona
- 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 del 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 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 pasarlo a gcloud CLI es mucho menos propenso a errores que intentar ingresar un YAML con el formato correcto 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-policiesupdate.
Global
Usa la opción --config-from-file del 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 un nombre para 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 pasarlo a gcloud CLI es mucho menos propenso a errores que intentar ingresar un YAML con el formato correcto 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-policiesupdate.
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. Debido a 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:
- Para las políticas zonales, usa el comando
gcloud compute zone-vm-extension-policiesupdate. - Para las políticas globales, usa el
comando
gcloud compute global-vm-extension-policiesupdate.
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 reemplaza.
Para obtener información general sobre cómo usar la consola deGoogle Cloud y gcloud CLI para crear políticas de extensiones de VM, consulta Instala extensiones de VM con políticas de extensiones .
Instala el Agente de operaciones con un plan de lanzamiento rápido con una prioridad más alta (solo 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 un nombre para 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 proyecto de Google Cloud (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 un nombre para 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.
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
- Verifica que el Agente de operaciones recopile datos de telemetría
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
-
En la consola de Google Cloud , ve a la página Instancias de VM.
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Compute Engine.
- Selecciona una VM de la lista.
- Haz clic en la pestaña Observabilidad.
Cloud Monitoring
-
En la consola de Google Cloud , ve a la página Instancias de VM.
Si usas la barra de búsqueda para encontrar esta página, selecciona el resultado cuyo subtítulo es Monitoring.
- Selecciona la vista Lista.
Cuando el Agente de operaciones se haya instalado en la VM y recopile registros y métricas, el estado del agente 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 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.
- Para obtener información sobre cómo verificar la recopilación de métricas, consulta El agente está en ejecución, pero los datos no se transfieren.
- Para obtener información sobre cómo verificar la recopilación de registros, consulta Verifica la recopilación exitosa de registros.
¿Qué sigue?
- Modifica la instalación actualizando las políticas de la extensión.
- Soluciona problemas en las políticas de extensiones.
- Obtén más información sobre el Gestor de extensiones de VM.
- Consulta información detallada sobre cómo configurar el Agente de operaciones.