Esta página se ha traducido con Cloud Translation API.

Configurar el agente para cargas de trabajo de MySQL

En este documento se muestra cómo instalar el agente para cargas de trabajo de Compute en una instancia de Compute Engine y cómo configurar el agente para que se conecte con una carga de trabajo de MySQL que se ejecute en esa instancia de Compute.

Antes de empezar

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

Has desplegado una carga de trabajo de MySQL en una instancia de proceso.
Has concedido los roles de gestión de identidades y accesos necesarios a la cuenta de servicio asociada a la instancia de proceso.
Has habilitado el acceso a las APIs de Cloud.

Roles de gestión de identidades y accesos necesarios

Agent for Compute Workloads usa la cuenta de servicio asociada a la instancia de computación para la autenticación y para acceder a los recursos Google Cloud .

Para mejorar la seguridad, te recomendamos que uses una cuenta de servicio específica en lugar de la cuenta de servicio predeterminada de Compute Engine.

Para asegurarte de que la cuenta de servicio tiene los permisos necesarios para que el agente de cargas de trabajo de Compute se autentique con los recursos deGoogle Cloud y acceda a ellos Google Cloud , pide a tu administrador que conceda a la cuenta de servicio los siguientes roles de gestión de identidades y accesos en tu proyecto:

Lector de Compute (roles/compute.viewer): para recoger métricas de la instancia de cálculo.
Escritor de estadísticas de Workload Manager (roles/workloadmanager.insightWriter): para escribir datos en el almacén de datos de Workload Manager.
Escritor de registros (roles/logging.logWriter) (recomendado): para enviar registros del agente a Cloud Logging.
(Opcional) Lector de recursos de Secret Manager (roles/secretmanager.secretAccessor): si usas Secret Manager para almacenar la contraseña con la que conectarte a la instancia de MySQL.

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

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

Habilitar el acceso a las APIs de Cloud

Compute Engine recomienda configurar las instancias para que permitan todos los permisos de acceso a todas las APIs de Cloud y usar solo los permisos de gestión de identidades y accesos de la cuenta de servicio de la instancia para controlar el acceso a los recursos.Google Cloud Para obtener más información, consulta Crear una VM que use una cuenta de servicio gestionada por el usuario.

Si limitas el acceso a las APIs de Cloud, el agente de cargas de trabajo de Compute requiere al menos los siguientes permisos de acceso a las APIs de Cloud en la instancia de Compute del host:

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

Para obtener más información, consulta el artículo Prácticas recomendadas para los ámbitos.

Si ejecutas aplicaciones MySQL en una instancia de Compute que no tiene una dirección IP externa, debes habilitar Acceso privado de Google en la subred de la instancia para que el agente de Compute Workloads pueda acceder a las APIs y los servicios de Google. Para obtener información sobre cómo habilitar el Acceso privado de Google, consulta el artículo Configurar Acceso privado de Google.

Instalar y configurar el agente

Para instalar el agente de cargas de trabajo de Compute en tu instancia de proceso y configurarlo para que se conecte con una instancia de MySQL, sigue estos pasos:

RHEL - 6, 7

En Red Hat Enterprise Linux (RHEL), puedes instalar el agente para cargas de trabajo de Compute mediante el comando de gestió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 Compute basada en RHEL, sigue estos pasos:

Establece una conexión SSH con tu instancia de proceso.

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

Abre el archivo de configuración del agente:

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

Especifique los valores de todos los parámetros obligatorios, tal como se describe en Parámetros de configuración.
Guardar el archivo de configuración
Reinicia el agente para que los cambios surtan efecto.

SLES

En SUSE Linux Enterprise Server (SLES), puedes instalar el agente para cargas de trabajo de Compute mediante el comando de gestió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 Compute basada en SLES, sigue estos pasos:

Establece una conexión SSH con tu instancia de proceso.

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

Abre el archivo de configuración del agente:

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

Especifique los valores de todos los parámetros obligatorios, tal como se describe en Parámetros de configuración.
Guardar el archivo de configuración
Reinicia el agente para que los cambios surtan efecto.

Debian

En Debian, puedes instalar el agente para cargas de trabajo de Compute mediante el comando de gestió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 computación basada en Debian, sigue estos pasos:

Establece una conexión SSH con tu instancia de proceso.

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

Abre el archivo de configuración del agente:

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

Especifique los valores de todos los parámetros obligatorios, tal como se describe en Parámetros de configuración.
Guardar el archivo de configuración
Reinicia el agente para que los cambios surtan efecto.

Windows

En Windows, puedes instalar el agente para cargas de trabajo de Compute mediante el comando de gestió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 está en funcionamiento y, si es necesario, reiniciarlo.

Para instalar y configurar el agente para cargas de trabajo de Compute en una instancia de Compute basada en Windows, sigue estos pasos:

Establece una conexión con tu instancia de proceso mediante RDP.

Para obtener información sobre cómo hacerlo, consulta Conectarse a máquinas virtuales Windows mediante RDP.

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

Abre el archivo de configuración del agente:

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

Especifique los valores de todos los parámetros obligatorios, tal como se describe en Parámetros de configuración.
Guardar el archivo de configuración
Reinicia el agente para que los cambios surtan efecto.

Verificar la instalación del agente

Para verificar que el agente se está ejecutando correctamente, sigue estos pasos:

RHEL - 6, 7

Establece una conexión SSH con tu instancia de proceso.

Comprueba el estado del paquete del agente:

systemctl status google-cloud-workload-agent

Si el paquete del agente se ejecuta correctamente, la salida 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

Establece una conexión SSH con tu instancia de proceso.

Comprueba el estado del paquete del agente:

systemctl status google-cloud-workload-agent

Si el paquete del agente se ejecuta correctamente, la salida 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

Establece una conexión SSH con tu instancia de proceso.

Comprueba el estado del paquete del agente:

systemctl status google-cloud-workload-agent

Si el paquete del agente se ejecuta correctamente, la salida 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

Establece una conexión con tu instancia de proceso mediante RDP.

Para obtener información sobre cómo hacerlo, consulta Conectarse a máquinas virtuales Windows mediante RDP.
Como administrador, ejecuta el siguiente comando desde PowerShell:
```
$(Get-Service -Name 'google-cloud-workload-agent' -ErrorAction Ignore).Status
```
Si el agente funciona correctamente, el estado será Running.

Ejemplo de archivo de configuración

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

{
  "log_level": "INFO",
  "common_discovery": {
    "collection_frequency": "10800s"
  },
  "mysql_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 de cargas de trabajo de MySQL:

Parámetros
`log_level`	`String` Para definir el nivel de registro del agente, asigna el valor necesario. 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 lo indique el equipo de Asistencia de Google Cloud.
`log_to_cloud`	`Boolean` Para redirigir 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, asigna el valor `true`. El valor predeterminado es `false`.
`common_discovery.collection_frequency`	`Duration` Especifica la frecuencia, en segundos, con la que se ejecuta el servicio de detección de la carga de trabajo del agente. El valor predeterminado es `10800s`. Asegúrese de que el valor de este parámetro termina con una `s` en minúscula.
`mysql_configuration.enabled`	`Boolean` Para permitir que el agente recoja métricas de la instancia de MySQL, asigna el valor `true`. El valor predeterminado es `false`. Importante: Para que funcionen los demás parámetros de agente específicos de MySQL, debes definir `mysql_configuration.enabled` como `true`.
`mysql_configuration.connection_parameters.username`	`String` Especifica la cuenta de usuario que usa el agente para consultar la instancia de MySQL.
`mysql_configuration.connection_parameters.password`	`String` Especifica la contraseña de texto sin formato de la cuenta de usuario que utiliza el agente para consultar la instancia de MySQL. En lugar de especificar una contraseña de texto sin formato, te recomendamos que utilices 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 definas solo una opción de autenticación en el archivo de configuración del agente.
`mysql_configuration.connection_parameters.secret.secret_name`	`String` Opcional. Para proporcionar de forma segura la contraseña de la cuenta de usuario que usa el agente para consultar la instancia de MySQL, 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 definas solo una opción de autenticación en el archivo de configuración del agente.
`mysql_configuration.connection_parameters.secret.project_id`	`String` Opcional. Para usar el parámetro `secret.secret_name` para autenticar la cuenta de usuario especificada, indique 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, asigna a este parámetro el valor de una cadena vacía (`""`).
`mysql_configuration.connection_parameters.host`	`String` Especifica el nombre de host de MySQL.
`mysql_configuration.connection_parameters.port`	`Int` Especifica el puerto en el que tu instancia de MySQL acepta consultas.

Siguientes pasos

Crear y realizar una evaluación
Consulta las prácticas recomendadas de Workload Manager para MySQL.

Configurar el agente para cargas de trabajo de MySQL Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Antes de empezar

Roles de gestión de identidades y accesos necesarios

Habilitar el acceso a las APIs de Cloud

Instalar y configurar el agente

RHEL - 6, 7

SLES

Debian

Windows

Verificar la instalación del agente

RHEL - 6, 7

SLES

Debian

Windows

Ejemplo de archivo de configuración

Parámetros de configuración

Siguientes pasos

Configurar el agente para cargas de trabajo de MySQL