Configura el agente para las cargas de trabajo de Redis

En este documento, se muestra cómo instalar el agente para cargas de trabajo de Compute en instancias de Compute Engine y cómo configurar el agente para que se conecte con una carga de trabajo de Redis que se ejecuta en esas instancias de procesamiento.

Después de instalar y configurar el agente, este recopila métricas de tu carga de trabajo de Redis y de las instancias de procesamiento subyacentes, y las envía a Gestor de cargas de trabajo. Luego, puedes usar la evaluación de Gestor de cargas de trabajo para analizar tus cargas de trabajo de Redis en busca de desviaciones de las prácticas recomendadas para las configuraciones de infraestructura, sistema operativo y carga de trabajo.

Antes de comenzar

Antes de instalar y configurar el agente para cargas de trabajo de Compute, debes asegurarte de que se cumplan los siguientes requisitos previos:

Roles de IAM obligatorios para el agente

El agente para cargas de trabajo de Compute usa la cuenta de servicio conectada a la instancia de procesamiento para la autenticación y para acceder a los recursos de Google Cloud .

Para mejorar la seguridad, te recomendamos que uses una cuenta de servicio de propósito único en lugar de la cuenta de servicio predeterminada de Compute Engine.

Para garantizar que la cuenta de servicio tenga los permisos necesarios para permitir que Agent for Compute Workloads se autentique conGoogle Cloud y acceda a los recursos de Google Cloud , pídele a tu administrador que le otorgue los siguientes roles de IAM a la cuenta de servicio en tu proyecto:

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

Es posible que tu administrador también pueda otorgar a la cuenta de servicio los permisos necesarios a través de roles personalizados o de otros roles predefinidos.

Habilita el acceso a las API de Cloud

Compute Engine recomienda configurar las instancias para permitir todos los permisos de acceso a todas las API de Cloud y usar solo los permisos de IAM de la cuenta de servicio de la instancia para controlar el acceso a los recursos deGoogle Cloud . Para obtener más información, consulta Crea una VM que use una cuenta de servicio administrada por el usuario.

Si limitas el acceso a las API de Cloud, el agente para cargas de trabajo de Compute requiere, como mínimo, los siguientes permisos de acceso a las API de Cloud en la instancia de procesamiento del host:

https://www.googleapis.com/auth/cloud-platform

Para obtener más información, consulta las prácticas recomendadas para los permisos.

Si ejecutas una carga de trabajo de Redis en una instancia de procesamiento que no tiene una dirección IP externa, debes habilitar el Acceso privado a Google en la subred de la instancia para que el Agente para cargas de trabajo de procesamiento pueda acceder a las APIs y los servicios de Google. Para obtener información sobre cómo habilitar el Acceso privado a Google, consulta Configura el Acceso privado a Google.

Instala y configura el agente con el administrador de paquetes

En esta sección, se muestra cómo instalar el agente para cargas de trabajo de Compute en tu instancia de procesamiento y configurarlo para que se conecte con una instancia de Redis, mediante un administrador de paquetes.

Para instalar el agente para cargas de trabajo de Compute, completa los siguientes pasos:

RHEL

En Red Hat Enterprise Linux (RHEL), instala el agente para cargas de trabajo de Compute con el comando de administración de paquetes yum. Este comando completa las siguientes tareas:

  • Descarga la versión más reciente del agente.
  • Crea un servicio systemd para el agente, llamado google-cloud-workload-agent.
  • Habilita e inicia el servicio google-cloud-workload-agent.

Para instalar y configurar el agente para cargas de trabajo de Compute en una instancia de procesamiento basada en RHEL, completa los siguientes pasos:

  1. Establece una conexión SSH con tu instancia de procesamiento.

  2. En tu terminal, instala el agente:

    sudo tee /etc/yum.repos.d/google-cloud-workload-agent.repo << EOM
[google-cloud-workload-agent]
name=Google Cloud Agent for Compute Workloads
baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-workload-agent-$basearch
enabled=1
gpgcheck=0
repo_gpgcheck=1
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM
sudo yum install google-cloud-workload-agent

  3. Reemplaza el archivo de configuración del agente:

    /etc/google-cloud-workload-agent/configuration.json

  4. Especifica valores para todos los parámetros obligatorios, como se describe en Parámetros de configuración.

  5. Cómo guardar el archivo de configuración

  6. Reinicia el agente para que se apliquen los cambios.

SLES

En SUSE Linux Enterprise Server (SLES), instala el agente para cargas de trabajo de Compute con el comando de administración de paquetes zypper. Este comando completa las siguientes tareas:

  • Descarga la versión más reciente del agente.
  • Crea un servicio systemd para el agente, llamado google-cloud-workload-agent.
  • Habilita e inicia el servicio google-cloud-workload-agent.

Para instalar y configurar el agente para cargas de trabajo de Compute en una instancia de procesamiento basada en SLES, completa los siguientes pasos:

  1. Establece una conexión SSH con tu instancia de procesamiento.

  2. En tu terminal, instala el agente:

    sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-workload-agent-$basearch
google-cloud-workload-agent
sudo zypper install google-cloud-workload-agent

  3. Reemplaza el archivo de configuración del agente:

    /etc/google-cloud-workload-agent/configuration.json

  4. Especifica valores para todos los parámetros obligatorios, como se describe en Parámetros de configuración.

  5. Cómo guardar el archivo de configuración

  6. Reinicia el agente para que se apliquen los cambios.

Debian

En Debian, se instala el agente para cargas de trabajo de Compute con el comando de administración de paquetes apt. Este comando completa las siguientes tareas:

  • Descarga la versión más reciente del agente.
  • Crea un servicio systemd para el agente, llamado google-cloud-workload-agent.
  • Habilita e inicia el servicio google-cloud-workload-agent.

Para instalar y configurar el Agente para cargas de trabajo de Compute en una instancia de procesamiento basada en Debian, completa los siguientes pasos:

  1. Establece una conexión SSH con tu instancia de procesamiento.

  2. En tu terminal, instala el agente:

    echo 'deb https://packages.cloud.google.com/apt google-cloud-workload-agent-x86-64-apt main' | sudo tee -a /etc/apt/sources.list.d/google-cloud-workload-agent.list
sudo apt-get update
sudo apt-get install google-cloud-workload-agent

  3. Reemplaza el archivo de configuración del agente:

    /etc/google-cloud-workload-agent/configuration.json

  4. Especifica valores para todos los parámetros obligatorios, como se describe en Parámetros de configuración.

  5. Cómo guardar el archivo de configuración

  6. Reinicia el agente para que se apliquen los cambios.

Windows

En Windows, instalas el agente para cargas de trabajo de Compute con el comando de administración de paquetes googet. Este comando completa las siguientes tareas:

  • Descarga la versión más reciente del agente.
  • Crea un servicio de Windows llamado google-cloud-workload-agent.
  • Crea una tarea programada que se ejecuta cada minuto para comprobar si el servicio se está ejecutando y, si es necesario, reiniciarlo.

Para instalar y configurar el agente para cargas de trabajo de Compute en una instancia de procesamiento basada en Windows, completa los siguientes pasos:

  1. Establece una conexión con tu instancia de procesamiento a través de RDP.

    Para obtener información sobre cómo hacerlo, consulta Conéctate a las VMs de Windows mediante RDP.

  2. Como administrador, ejecuta los siguientes comandos desde PowerShell:

    googet addrepo google-cloud-workload-agent  https://packages.cloud.google.com/yuck/repos/google-cloud-workload-agent-windows-x86_64
googet install google-cloud-workload-agent

  3. Reemplaza el archivo de configuración del agente:

    %ProgramFiles%\Google\google-cloud-workload-agent\conf\configuration.json

  4. Especifica valores para todos los parámetros obligatorios, como se describe en Parámetros de configuración.

  5. Cómo guardar el archivo de configuración

  6. Reinicia el agente para que se apliquen los cambios.

Instala y administra el agente en una flota de VMs con el Gestor de extensiones de VM

En esta sección, se muestra cómo instalar y administrar el agente para cargas de trabajo de Compute en una flota de VMs con el Administrador de extensiones de VM.

La política del Gestor de extensiones de VM te permite realizar tareas como las siguientes:

  • Instalación en toda la flota: Instala el agente para cargas de trabajo de Compute en los siguientes elementos:
    • Todas las VMs de tu proyecto Google Cloud o un subconjunto de VMs identificadas por etiquetas
    • Todas las VMs dentro de una zona o un subconjunto de VMs identificadas por etiquetas
  • Administración de la configuración: Aplica una configuración personalizada al agente en todas las VMs administradas por una política.

Para obtener más información sobre el Gestor de extensiones de VM, consulta Acerca del Gestor de extensiones de VM.

Configura el Gestor de extensiones de VM

Para configurar el Administrador de extensiones de VM, completa los siguientes pasos:

Instala y configura el agente en una flota de VMs

Para instalar la versión más reciente del Agente de cargas de trabajo de procesamiento en tu flota de VMs con una política de Gestor de extensiones de VM, consulta la sección correspondiente:

Instala y configura el agente en las VMs de tu proyecto de Google Cloud

Para instalar el agente en todas las VMs de tu proyecto Google Cloud , o en un subconjunto de VMs identificadas por una etiqueta, con una política del Gestor de extensiones de VM, completa los siguientes pasos:

Console

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

    Ir a las políticas de extensión de VM

  2. Haz clic en Crear política de extensión.

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

  6. En la sección Alcance, selecciona Lanzamiento global.

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

    1. En la lista Extension, selecciona Extensión de Google Cloud para cargas de trabajo de procesamiento.

    2. Deja en blanco el campo Versión.

      Esto indica a la política que instale la versión más reciente del agente para cargas de trabajo de Compute.

    3. En el campo Contenido del archivo de configuración, ingresa la configuración que deseas aplicar al agente.

      Para obtener información sobre los parámetros de configuración compatibles con el agente para tu carga de trabajo de Redis, consulta Parámetros de configuración.

    4. Haz clic en Listo.

    5. En el campo Lanzamiento, selecciona la opción del plan de lanzamiento que deseas usar: Lanzamiento lento (recomendado) o Lanzamiento rápido.

      Para obtener información sobre los planes de lanzamiento, consulta Acerca de los planes de lanzamiento.

  8. Opcional: Para limitar el lanzamiento de la política a las VMs requeridas, haz lo siguiente:

    1. Haz clic en Agregar etiquetas y agrega las etiquetas que identifican las VMs requeridas.
    2. Haz clic en Listo.

  9. Haz clic en Crear.

gcloud

En tu terminal o Cloud Shell, ejecuta el comando gcloud compute global-vm-extension-policies create:

gcloud compute global-vm-extension-policies create POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-workload-extension  \
    --rollout-predefined-plan=ROLL_OUT_SPEED \
    [--description="<var>DESCRIPTION</var>" \]
    [--inclusion-labels=KEY1=VALUE1,KEY2=VALUE2 \]
    [--config-from-file=google-cloud-workload-extension="CONFIG_FILE_PATH" \]
    [--priority=PRIORITY]

Reemplaza lo siguiente:

  • POLICY_NAME: Es un nombre único para la política de extensión de VM.
  • PROJECT_ID: ID del proyecto deGoogle Cloud para el que creas la política

  • ROLL_OUT_SPEED: La rapidez con la que deseas lanzar la política. Los valores admitidos son slow_rollout (recomendado) y fast_rollout. Para obtener más información, consulta Acerca de los planes de lanzamiento.

  • Como alternativa, puedes usar un plan de lanzamiento personalizado especificando la opción --rollout-custom-plan. Para obtener más información, consulta Acerca de los planes de lanzamiento.

  • Puedes usar --rollout-predefined-plan o --rollout-custom-plan, pero no ambos en el mismo comando.

  • DESCRIPTION: Es una descripción opcional de la política.

  • CONFIG_FILE_PATH: Es la ruta local al archivo JSON que contiene la configuración del agente para cargas de trabajo de Compute.

    • Como alternativa, para proporcionar la configuración como una cadena intercalada, usa la marca --config en lugar de --config-from-file. Por ejemplo, --config=google-cloud-workload-extension="CONFIG".
    • Puedes usar --config-from-file o --config, pero no ambos en el mismo comando.
    • Para obtener información sobre los parámetros de configuración admitidos por el agente, consulta Parámetros de configuración.

  • KEY_1=VALUE_1: Es una lista separada por comas de pares clave-valor que definen las etiquetas con las que la política segmenta las VMs.

    • Para que tu política se aplique a una VM, esta debe tener todas las etiquetas especificadas.
    • Si especificas --inclusion-labels varias veces, la política se aplica a las VMs que coinciden con cualquiera de los selectores proporcionados (OR lógico). Si omites esta marca, la política se aplica a todas las VMs del proyecto.

  • PRIORITY: Es un número entero del 0 al 65535 que define la prioridad de la política. Los números más bajos indican una mayor prioridad. El valor predeterminado es 1000. Para obtener más información, consulta Prioridad de las políticas y resolución de conflictos.

Instala y configura el agente en las VMs dentro de una zona específica

Para instalar y configurar la versión más reciente del Agente de cargas de trabajo de procesamiento en tu flota de VMs dentro de una zona específica con una política del Gestor de extensiones de VM, completa los siguientes pasos:

Console

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

    Ir a las políticas de extensión de VM

  2. Haz clic en Crear política de extensión.

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

  6. En las listas Región y 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, luego, haz lo siguiente:

    1. En la lista Extension, selecciona Extensión de Google Cloud para cargas de trabajo de procesamiento.

    2. Deja en blanco el campo Versión.

      Esto indica a la política que instale la versión más reciente del agente para cargas de trabajo de Compute.

    3. En el campo Contenido del archivo de configuración, ingresa la configuración que deseas aplicar al agente.

      Para obtener información sobre los parámetros de configuración compatibles con el agente para tu carga de trabajo de Redis, consulta Parámetros de configuración.

    4. Haz clic en Listo.

  8. Opcional: Para limitar el lanzamiento de la política a las VMs requeridas, haz lo siguiente:

    1. Haz clic en Agregar etiquetas y agrega las etiquetas que identifican las VMs requeridas.
    2. Haz clic en Listo.

  9. Haz clic en Crear.

gcloud 

gcloud compute zone-vm-extension-policies create POLICY_NAME \
    --zone=ZONE \
    --extensions=google-cloud-workload-extension \
    --config-from-file=google-cloud-workload-extension=CONFIG_FILE_PATH \
    [--description="DESCRIPTION" \]
    [--inclusion-labels=KEY_1=VALUE_1 \]
    [--inclusion-labels=KEY_2=VALUE_2,KEY_3=VALUE_3 \]
    [--priority=PRIORITY]

Reemplaza lo siguiente:

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

    El comando falla si ya existe una política con el nombre especificado en la zona.

  • ZONE: Es la zona en la que deseas aplicar esta política.

  • CONFIG_FILE_PATH: Es la ruta de acceso local al archivo JSON que contiene la configuración para que el agente de Compute Workloads se conecte con tu carga de trabajo de Redis.

    • Como alternativa, para proporcionar la configuración como una cadena intercalada, usa la marca --config en lugar de --config-from-file. Por ejemplo, --config=google-cloud-workload-extension="CONFIG". Google Cloud recomienda que uses --config-from-file.
    • Puedes usar --config-from-file o --config, pero no ambos en el mismo comando.
    • Para obtener información sobre los parámetros de configuración compatibles con el agente para tu carga de trabajo de Redis, consulta Parámetros de configuración.

  • DESCRIPTION: Es una descripción opcional de la política.

  • KEY_1=VALUE_1: Es una lista separada por comas de pares clave-valor que definen las etiquetas con las que la política segmenta las VMs.

    • Para que tu política se aplique a una VM, esta debe tener todas las etiquetas especificadas.
    • Si especificas --inclusion-labels varias veces, la política se aplica a las VMs que coinciden con cualquiera de los selectores proporcionados (OR lógico). Si omites esta marca, la política se aplica a todas las VMs de la zona especificada.

  • PRIORITY: Es un número entero del 0 al 65535 que define la prioridad de la política. Los números más bajos indican una mayor prioridad. El valor predeterminado es 1000.

Ejemplo:

El siguiente comando crea una política llamada test-agent-policy en el proyectoGoogle Cloud llamado test-project, que instala la versión más reciente del agente para cargas de trabajo de Compute en todas las VMs implementadas en la zona us-centrail-f. La configuración especificada en agent-config.json se aplica al agente.

gcloud compute zone-vm-extension-policies create test-agent-policy  \
    --project=test-project \
    --zone=us-central1-f \
    --extensions=google-cloud-workload-extension \
    --config-file-path=google-cloud-workload-extension="/usr/agent-config.json"

Administra el agente en una flota de VMs

Para cambiar la forma en que una política del Gestor de extensiones de VM administra el Agente de cargas de trabajo de procesamiento, actualiza la política. Cuando actualizas una política, el Gestor de extensiones de VM implementa los cambios en todas las VMs aplicables, por lo general, en un minuto. Si modificas las etiquetas de inclusión, es posible que el agente para cargas de trabajo de Compute 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 para cargas de trabajo de Compute para realizar las siguientes acciones:

Modifica la configuración del agente en una flota de VMs

Para modificar la configuración de las instancias del Agente de cargas de trabajo de procesamiento que instalaste en tu flota de VMs con una política del Gestor de extensiones de VM, debes editar esa política.

Para modificar la configuración del agente en tu flota de VM, completa los siguientes pasos:

Console

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

    Ir a las políticas de extensión de VM

  2. Haz clic en la política que deseas modificar.

  3. En la página Detalles de la política de extensiones, haz clic en Editar.

  4. En la sección Administrar extensiones, activa Extensión de Google Cloud para cargas de trabajo de procesamiento.

  5. En el campo Contenido del archivo de configuración, ingresa la configuración que deseas aplicar al agente.

    Para obtener información sobre los parámetros de configuración admitidos por el agente, consulta Parámetros de configuración.

  6. Haz clic en Listo.

  7. Haz clic en Guardar.

gcloud

Para modificar la configuración del agente para cargas de trabajo de Compute en tu flota de VM, ejecuta el comando gcloud compute zone-vm-extension-policies update. Cuando actualizas una política con gcloud, la solicitud actúa como un reemplazo completo. Cualquier campo opcional que omitas volverá a sus valores predeterminados en lugar de conservar los valores existentes de la política modificada.

Para modificar la configuración del agente, haz lo siguiente:

gcloud compute zone-vm-extension-policies update POLICY_NAME \
    --zone=ZONE \
    --extensions=google-cloud-workload-extension \
    --config-from-file=google-cloud-workload-extension="CONFIG_FILE_PATH" \
    [--inclusion-labels=KEY_1=VALUE_1 \]
    [--inclusion-labels=KEY_2=VALUE_2,KEY_3=VALUE_3 \]
    [--priority=PRIORITY_NUMBER \]
    [--description="DESCRIPTION"]

Reemplaza lo siguiente:

  • POLICY_NAME: Es el nombre de la política de extensión de VM que deseas modificar.
  • ZONE: Es la Google Cloud zona en la que se aplica la política.

  • CONFIG_FILE_PATH: Es la ruta local al archivo JSON que contiene la configuración del agente para cargas de trabajo de Compute.

    • También puedes proporcionar la configuración del agente como una cadena intercalada con la marca --config en lugar de --config-from-file. Por ejemplo, --config=google-cloud-workload-extension="CONFIG". Google Cloud recomienda que uses --config-from-file.
    • Puedes usar --config-from-file o --config, pero no ambos en el mismo comando.
    • Para obtener información sobre los parámetros de configuración admitidos por el agente, consulta Parámetros de configuración.

  • KEY_1=VALUE_1: Es una lista separada por comas de pares clave-valor que definen las etiquetas con las que la política segmenta las VMs.

    • Para que tu política se aplique a una VM, esta debe tener todas las etiquetas especificadas.
    • Si especificas --inclusion-labels varias veces, la política se aplica a las VMs que coinciden con cualquiera de los selectores proporcionados (OR lógico). Si omites esta marca, la política se aplica a todas las VMs de la zona especificada.

  • PRIORITY_NUMBER: Es la prioridad que deseas establecer para tu política. Puedes especificar un número entero del 0 al 65535.

  • DESCRIPTION: Es una descripción de la política de extensión de VM.

Actualiza una política global para incluir zonas nuevas

Cuando creas VMs en una zona nueva después de haber creado y lanzado una política global, Gestor de extensiones de VM no aplica automáticamente la política a las VMs en las zonas nuevas. Para incluir las VMs en zonas nuevas, debes reiniciar la implementación de la política global.

Para reiniciar el lanzamiento de una política global, completa los siguientes pasos:

  • En tu terminal o Cloud Shell, ejecuta el comando gcloud compute global-vm-extension-policies update y proporciona la opción --rollout-entry-uuid de la siguiente manera:

    gcloud compute global-vm-extension-policies update POLICY_NAME \
    --project=PROJECT_ID \
    --extensions=google-cloud-workload-extension  \
    --rollout-predefined-plan=ROLL_OUT_SPEED \
    --config-from-file=google-cloud-workload-extension="CONFIG_FILE_PATH" \
    --rollout-retry-uuid=UUID

    Reemplaza lo siguiente:

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

    • ROLL_OUT_SPEED: La rapidez con la que deseas lanzar la política. Los valores admitidos son slow_rollout (recomendado) y fast_rollout. Para obtener más información, consulta Acerca de los planes de lanzamiento.

    • Como alternativa, puedes usar un plan de lanzamiento personalizado especificando la opción --rollout-custom-plan. Para obtener más información, consulta Acerca de los planes de lanzamiento.

    • Puedes usar --rollout-predefined-plan o --rollout-custom-plan, pero no ambos en el mismo comando.

Actualiza una política global para excluir zonas

Para actualizar una política global y excluir zonas, completa los siguientes pasos:

  • En tu terminal o Cloud Shell, ejecuta el comando gcloud compute global-vm-extension-policies update y proporciona un plan de lanzamiento personalizado que especifique las zonas en las que se aplicará la política:

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

    Reemplaza lo siguiente:

    • NEW_CUSTOM_PLAN_NAME: Es el nombre del nuevo plan de lanzamiento personalizado que identifica 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.
    • UUID: Es un identificador único universal (UUID) que identifica la solicitud de reintento. Puedes usar cualquier generador de UUID para crear uno. Para obtener más información, consulta Cómo reintentar un lanzamiento.

Desinstala el agente de una flota de VM

Para desinstalar el agente para cargas de trabajo de Compute de tu flota de VMs, debes borrar la política del Administrador de extensiones de VM que administra la flota de VMs.

Mientras se borra una política, si otra política activa de menor prioridad se aplica a una VM y declara el agente para cargas de trabajo de Compute, el agente permanece instalado en esa VM según la política de menor prioridad.

El Gestor de extensiones de VM quita el agente 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 porque se quitó el agente invitado o se borró la VM, el Administrador de extensiones de VM omitirá el borrado del Agente para cargas de trabajo de Compute. Si una VM de este tipo vuelve a estar disponible, Gestor de extensiones de VM quitará el Agente de cargas de trabajo de procesamiento en ese momento.

Para desinstalar el agente de Compute Workloads de tu flota de VM, completa los siguientes pasos:

Console

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

    Ir a las políticas de extensión de VM

  2. Haz clic en la política que administra el agente para cargas de trabajo de procesamiento en tu flota de VM.

  3. En la página Detalles de la política de extensiones, haz clic en Borrar y confirma la eliminación.

gcloud 

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

Reemplaza lo siguiente:

  • POLICY_NAME: Es el nombre de la política de extensión de VM que deseas borrar.
  • PROJECT_ID: Es el ID del Google Cloud proyecto en el que se encuentra la política.
  • ZONE: La Google Cloud zona en la que se encuentra la política.

Verifica la instalación del agente

Para verificar que el agente se ejecute según lo previsto, completa los siguientes pasos:

RHEL

  1. Establece una conexión SSH con tu instancia de procesamiento.

  2. Verifica el estado del paquete del agente:

    systemctl status google-cloud-workload-agent

    Si el paquete del agente se ejecuta como se espera, el resultado contiene active (running). Por ejemplo:

    google-cloud-workload-agent.service - Google Cloud Agent for Compute Workloads
Loaded: loaded (/usr/lib/systemd/system/google-cloud-workload-agent.service; enabled; vendor preset: disabled)
Active: active (running) since Sun 2025-07-30 18:59:12 UTC; 10s ago
Main PID: 14412 (google_cloud_sq)
  Tasks: 7
Memory: 12.9M (max: 1.0G limit: 1.0G available: 1011.0M)
CGroup: /system.slice/google-cloud-workload-agent.service
        └─ 14412 /usr/bin/google_cloud_sql_server_agent --action=run

SLES

  1. Establece una conexión SSH con tu instancia de procesamiento.

  2. Verifica el estado del paquete del agente:

    systemctl status google-cloud-workload-agent

    Si el paquete del agente se ejecuta como se espera, el resultado contiene active (running). Por ejemplo:

    google-cloud-workload-agent.service - Google Cloud Agent for Compute Workloads
Loaded: loaded (/usr/lib/systemd/system/google-cloud-workload-agent.service; enabled; vendor preset: disabled)
Active: active (running) since Sun 2025-07-30 18:59:12 UTC; 10s ago
Main PID: 14412 (google_cloud_sq)
  Tasks: 7
Memory: 12.9M (max: 1.0G limit: 1.0G available: 1011.0M)
CGroup: /system.slice/google-cloud-workload-agent.service
        └─ 14412 /usr/bin/google_cloud_sql_server_agent --action=run

Debian

  1. Establece una conexión SSH con tu instancia de procesamiento.

  2. Verifica el estado del paquete del agente:

    systemctl status google-cloud-workload-agent

    Si el paquete del agente se ejecuta como se espera, el resultado contiene active (running). Por ejemplo:

    google-cloud-workload-agent.service - Google Cloud Agent for Compute Workloads
Loaded: loaded (/usr/lib/systemd/system/google-cloud-workload-agent.service; enabled; vendor preset: disabled)
Active: active (running) since Sun 2025-07-30 18:59:12 UTC; 10s ago
Main PID: 14412 (google_cloud_sq)
  Tasks: 7
Memory: 12.9M (max: 1.0G limit: 1.0G available: 1011.0M)
CGroup: /system.slice/google-cloud-workload-agent.service
        └─ 14412 /usr/bin/google_cloud_sql_server_agent --action=run

Windows

  1. Establece una conexión con tu instancia de procesamiento a través de RDP.

    Para obtener información sobre cómo hacerlo, consulta Conéctate a las VMs de Windows mediante RDP.

  2. Como administrador, ejecuta el siguiente comando desde PowerShell: 

    $(Get-Service -Name 'google-cloud-workload-agent' -ErrorAction Ignore).Status

    Si el agente se ejecuta según lo previsto, verás el estado como Running.

Archivo de configuración de ejemplo

A continuación, se muestra un ejemplo de configuración que permite que el agente para cargas de trabajo de Compute se conecte con una instancia de Redis. Para la autenticación, se usa un secreto de Secret Manager, que se almacena en el mismo proyecto de Google Cloud en el que se ejecuta la instancia de Redis.

{
  "log_level": "INFO",
  "common_discovery": {
    "collection_frequency": "10800s"
  },
  "redis_configuration": {
    "enabled": true,
    "connection_parameters": {
      "username": "db_user_name",
      "secret": {
        "secret_name": "db_pwd_secret_name",
        "project_id": ""
      },
      "host": "localhost",
      "port": 1433
    }
  }
}

Parámetros de configuración

En la siguiente tabla, se describen los parámetros de configuración del agente para cargas de trabajo de Compute que admiten evaluaciones para cargas de trabajo de Redis:

Parámetros
log_level

String

Para establecer el nivel de registro del agente, establece el valor requerido. Los niveles de registro disponibles son los siguientes:

  • DEBUG
  • INFO
  • WARNING
  • ERROR

El nivel de registro predeterminado es INFO. No cambies el nivel de registro, a menos que te dirija el servicio de atención al cliente de Cloud.
log_to_cloud

Boolean

Para redireccionar los registros del agente a Cloud Logging, especifica true. El valor predeterminado es true.
agent_properties.log_usage_metrics

Boolean

Para habilitar el registro de las métricas de estado del agente, establece el valor en true. El valor predeterminado es false.
common_discovery.collection_frequency

Duration

Especifica la frecuencia, en segundos, con la que se ejecuta el servicio de descubrimiento de cargas de trabajo del agente. El valor predeterminado es 10800s.

Asegúrate de que el valor de este parámetro termine con una s en minúscula.
redis_configuration.enabled

Boolean

Para permitir que el agente recopile métricas de la instancia de Redis, establece el valor en true. El valor predeterminado es false.
redis_configuration.connection_parameters.username

String

Especifica la cuenta de usuario que el agente usa para consultar la instancia de Redis.
redis_configuration.connection_parameters.password

String

Especifica la contraseña de texto sin formato para la cuenta de usuario que el agente usa para consultar la instancia de Redis.

En lugar de especificar una contraseña de texto sin formato, te recomendamos que uses los parámetros secret.name y secret.project_id.

Para la autenticación, el agente usa el siguiente orden de preferencia: si se especifica, se prefiere el conjunto de parámetros secret al parámetro password. Te recomendamos que establezcas solo una opción de autenticación en el archivo de configuración del agente.
redis_configuration.connection_parameters.secret.secret_name

String

Es opcional. Para proporcionar de forma segura la contraseña de la cuenta de usuario que el agente usa para consultar la instancia de Redis, especifica el nombre del secreto de Secret Manager que contiene la contraseña.

Para la autenticación, el agente usa el siguiente orden de preferencia: si se especifica, se prefiere el conjunto de parámetros secret al parámetro password. Te recomendamos que establezcas solo una opción de autenticación en el archivo de configuración del agente.
redis_configuration.connection_parameters.secret.project_id

String

Es opcional. Para usar el parámetro secret.secret_name para autenticar la cuenta de usuario especificada, especifica el ID del proyecto Google Cloud en el que se almacena el secreto de Secret Manager.

Si el secreto y la carga de trabajo están en el mismo Google Cloud proyecto, establece el valor de este parámetro en una cadena vacía ("").
redis_configuration.connection_parameters.host

String

Especifica el nombre de host de Redis.
redis_configuration.connection_parameters.port

Int

Especifica el puerto en el que tu instancia de Redis acepta consultas.

¿Qué sigue?