Configurar el agente para cargas de trabajo de Microsoft SQL Server

En este documento se muestra cómo instalar el agente para cargas de trabajo de Compute en instancias de Compute Engine y cómo configurarlo para que se conecte con una carga de trabajo de Microsoft SQL Server que se ejecute en esas instancias de proceso.

Una vez que hayas instalado y configurado el agente, este recogerá métricas de tu carga de trabajo de SQL Server y de las instancias de proceso subyacentes, y las enviará a Workload Manager. Después, puedes usar la evaluación de Workload Manager para analizar tus cargas de trabajo de SQL Server en busca de desviaciones de las prácticas recomendadas para las configuraciones de infraestructura, sistema operativo y carga de trabajo.

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 SQL Server en una o varias instancias de proceso.
• Has concedido los roles de gestión de identidades y accesos necesarios al agente.
• Has habilitado el acceso a las APIs de Cloud.
• Has concedido los permisos necesarios en SQL Server.

Roles de gestión de identidades y accesos necesarios para el agente

El agente de cargas de trabajo de Compute 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 tenga 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:

Importante: Debes asignar estos roles a la cuenta de servicio, no a tu cuenta de usuario. Si no se conceden los roles a la entidad correcta, pueden producirse errores de permisos.

• Lector de Compute (roles/compute.viewer): para recoger métricas de la instancia de proceso.
• Escritor de estadísticas de Workload Manager (roles/workloadmanager.insightWriter): para escribir datos en el almacén de datos de Workload Manager.
• (Recomendado) Escritor de registros (roles/logging.logWriter): 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 SQL Server.

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar 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 losGoogle Cloud recursos. 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 Prácticas recomendadas sobre los ámbitos.

Si ejecutas aplicaciones de SQL Server en una instancia de computación 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.

Permisos necesarios en SQL Server

Usa la siguiente secuencia de comandos para asignar los permisos necesarios a la cuenta de usuario configurada en el agente.

    USE [master]
    GO 

    GRANT VIEW SERVER STATE TO [user_name]
    GRANT VIEW ANY DEFINITION TO [user_name] 

    -- Adds db_datareader role to the user
    EXEC sp_MSForEachDB
    '
    USE ?
    IF NOT EXISTS(SELECT * FROM sys.database_principals WHERE name = ''user_name'')
    BEGIN
      CREATE USER [user_name] FOR LOGIN [user_name]
    END
    EXEC sp_addrolemember ''db_datareader'', ''user_name''
    '
  

Instalar y configurar el agente mediante el gestor de paquetes

Nota: Si el agente antiguo de SQL Server ya está instalado en la máquina virtual, durante el proceso de instalación, el agente de cargas de trabajo de Compute migrará automáticamente el archivo de configuración del agente a la nueva ubicación y eliminará el agente de SQL Server de la máquina virtual.

En esta sección se explica cómo instalar el agente para cargas de trabajo de Compute en tu instancia de Compute y cómo configurarlo para que se conecte con una instancia de SQL Server mediante un gestor de paquetes.

Para instalar el agente de cargas de trabajo de Compute, sigue estos pasos:

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.

Advertencia: No detengas el servicio de Windows google-cloud-workload-agent manualmente ni elimines su tarea programada.

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

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

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. Abre el archivo de configuración del agente:

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

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

5. Guardar el archivo de configuración

6. Reinicia el agente para que los cambios surtan efecto.

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:

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

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. Abre el archivo de configuración del agente:

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

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

5. Guardar el archivo de configuración

6. Reinicia el agente para que los cambios surtan efecto.

SLES

En SUSE Linux Enterprise Server (SLES), instala 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:

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

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. Abre el archivo de configuración del agente:

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

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

5. Guardar el archivo de configuración

6. 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 Compute basada en Debian, sigue estos pasos:

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

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. Abre el archivo de configuración del agente:

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

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

5. Guardar el archivo de configuración

6. Reinicia el agente para que los cambios surtan efecto.

Instalar y gestionar el agente en un conjunto de máquinas virtuales con VM Extension Manager

Esta función está sujeta a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Las funciones previas a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

Configurar VM Extension Manager

Para configurar VM Extension Manager, sigue estos pasos:

• En la documentación de VM Extension Manager, consulta la sección Antes de empezar.

• Configura los roles de gestión de identidades y accesos necesarios para crear y gestionar políticas de Gestor de extensiones de VM. Para obtener más información, consulta lo siguiente:

  • Crear políticas de extensiones de VM
  • Actualizar las políticas de extensiones de máquinas virtuales
  • Eliminar políticas de extensiones de VM
  • Enumerar y describir las políticas de extensiones de máquinas virtuales

Instalar el agente en un conjunto de máquinas virtuales

Para instalar la versión más reciente del agente para cargas de trabajo de Compute en tu flota de VMs de una zona específica mediante una política de VM Extension Manager, sigue estos pasos:

Consola

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

   Ir a las políticas de extensiones de MV

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

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 las listas Región y 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, a continuación, siga estos pasos:

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

   2. Deja el campo Versión en blanco.

      De esta forma, la política indica que se 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, introduce la configuración que quieras aplicar al agente.

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

      Nota: Si aplicas una política de VM Extension Manager a máquinas virtuales en las que ya se está ejecutando el Agente para cargas de trabajo de Compute, la política sustituirá la versión y la configuración del agente por las que hayas definido en la política.

      La configuración del agente se escribe en un archivo BAK en el directorio /etc/google-cloud-workload-agent/ de las máquinas virtuales correspondientes.

   4. Haz clic en Listo.

8. Opcional: Para limitar la implementación de la política a las máquinas virtuales necesarias, haz lo siguiente:

   1. Haz clic en Añadir etiquetas e incluye las etiquetas que identifiquen las VMs necesarias.
   2. Haz clic en Listo.

9. Haz clic en Crear.

gcloud

gcloud beta 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]

Haz los cambios siguientes:

• POLICY_NAME: un nombre para 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: la zona en la que quiere aplicar esta política.

• CONFIG_FILE_PATH: la ruta local al archivo JSON que contiene la configuración del agente para cargas de trabajo de Compute para conectarse con tu carga de trabajo de SQL Server.

  • También puedes proporcionar la configuración como una cadena insertada con la marca --config en lugar de --config-from-file. Por ejemplo, --config=google-cloud-workload-extension="CONFIG". Google Cloud te 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 de tu carga de trabajo de SQL Server, consulta Parámetros de configuración.
  Nota: Si aplicas una política de VM Extension Manager a máquinas virtuales en las que ya se está ejecutando el agente de cargas de trabajo de Compute, la política anulará la versión y la configuración del agente con lo que hayas definido en la política.

  La configuración del agente se escribe en un archivo BAK en el directorio /etc/google-cloud-workload-agent/ de las máquinas virtuales correspondientes.

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

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

  • Para que una VM sea el objetivo de tu política, debe tener todas las etiquetas especificadas.
  • Si especifica --inclusion-labels varias veces, la política se aplicará a las VMs que coincidan con cualquiera de los selectores proporcionados (operador lógico OR). Si omite esta marca, la política se aplicará a todas las VMs de la zona especificada.

• PRIORITY: un número entero entre 0 y 65535 que define la prioridad de la política. Cuanto más bajo sea el número, mayor será la 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 desplegadas en la zona us-centrail-f. La configuración especificada en agent-config.json se aplica al agente.

gcloud beta 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"

Verificar la instalación del agente

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

Windows

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

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

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

   Si el agente funciona correctamente, verás el estado Running.

RHEL - 6, 7

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

2. Comprueba el estado del paquete del agente:

   systemctl status google-cloud-workload-agent
   

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

2. Comprueba el estado del paquete del agente:

   systemctl status google-cloud-workload-agent
   

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

2. Comprueba el estado del paquete del agente:

   systemctl status google-cloud-workload-agent
   

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

Parámetros de configuración

En la siguiente tabla se describen los parámetros del archivo de configuración del agente.

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 carga de trabajo del agente. El valor predeterminado es 10800s. Asegúrese de que el valor de este parámetro termina con s en minúsculas.
sqlserver_configuration.enabled	Boolean Para habilitar la recogida de métricas de SQL Server en el agente, asigna el valor true. El valor predeterminado es false. Nota: Para que otros parámetros de configuración específicos del agente de SQL Server surtan efecto, asigna el valor true a sqlserver_configuration.enabled.
sqlserver_configuration.collection_configuration.collect_guest_os_metrics	Boolean Para habilitar la recogida de métricas del SO, defina el valor como true. El valor predeterminado es true. No definas sqlserver_configuration.collection_configuration.collect_guest_os_metrics como false a menos que te lo indique el equipo de Cloud Customer Care.
sqlserver_configuration.collection_configuration.collect_sql_metrics	Boolean Para habilitar la recogida de métricas de SQL Server, especifica true. El valor predeterminado es true. No definas sqlserver_configuration.collection_configuration.collect_sql_metrics como false a menos que te lo indique el equipo de Cloud Customer Care.
sqlserver_configuration.collection_configuration.collection_frequency	Duration Frecuencia de recogida de métricas de Agent for Compute Workloads, en segundos. El valor predeterminado es 3600s (ADMITE VALORES NULL). Puede actualizar la frecuencia de recogida. Sin embargo, te recomendamos que mantengas el valor predeterminado.
sqlserver_configuration.credential_configurations[].connection_parameters[].host	String Nombre de host de SQL Server.
sqlserver_configuration.credential_configurations[].connection_parameters[].username	String Especifica la cuenta de usuario que se utiliza para consultar la instancia de SQL Server. Para configurar los permisos de la cuenta, consulta los permisos necesarios en el script de permisos y concédelos de acuerdo con tus políticas internas. Nota: Si usas la autenticación de Windows, asegúrate de especificar el nombre de usuario con el siguiente formato: domain-name\\user-name
sqlserver_configuration.credential_configurations[].connection_parameters[].secret.project_id	String El ID del proyecto en el que se almacena el secreto. Asigna una cadena vacía ("") si el secreto y la instancia de VM del host se encuentran en el mismo proyecto Google Cloud .
sqlserver_configuration.credential_configurations[].connection_parameters[].secret.secret_name	String Para proporcionar de forma segura la contraseña de la cuenta de usuario de la base de datos que usa el agente para consultar SQL Server, especifica el nombre del secreto en Secret Manager que contiene las credenciales de seguridad de la cuenta de usuario de la base de datos. Nota: El secreto y la instancia de VM host deben estar en el mismo proyecto Google Cloud .
sqlserver_configuration.credential_configurations[].connection_parameters[].port	Int Especifica el puerto en el que tu instancia de SQL Server acepta consultas.
sqlserver_configuration.credential_configurations[].remote_win.connection_parameters.host	String Dirección IP o FQDN de la VM de Windows remota
sqlserver_configuration.credential_configurations[].remote_win.connection_parameters.username	String Especifica la cuenta de usuario que se usa para conectarse de forma remota a la VM de Windows.
sqlserver_configuration.credential_configurations[].remote_win.connection_parameters.secret.secret_name	String Para proporcionar de forma segura la contraseña de la cuenta de usuario de Windows que usa el agente para conectarse de forma remota a la VM, especifica el nombre del secreto en Secret Manager que contiene las credenciales de seguridad de la cuenta de usuario de la base de datos. Nota: El secreto y la instancia de VM host deben estar en el mismo proyecto Google Cloud .
sqlserver_configuration.credential_configurations[].local_collection	Boolean Especifica true para indicar que el agente está recogiendo datos locales. El valor predeterminado es true.
sqlserver_configuration.credential_configurations[].remote_linux.connection_parameters.host	String Dirección IP o FQDN de la máquina virtual Linux remota.
sqlserver_configuration.credential_configurations[].remote_linux.connection_parameters.username	String Especifica la cuenta de usuario que se utiliza para conectarse de forma remota a la VM Linux.
sqlserver_configuration.credential_configurations[].remote_linux.connection_parameter.port	Int Especifica el número de puerto SSH de la máquina virtual Linux remota.
sqlserver_configuration.credential_configurations[].remote_linux.linux_ssh_private_key_path	String Especifica la ruta al archivo de clave privada SSH.
sqlserver_configuration.credential_configurations[].vm_properties.instance_name	String Especifica el nombre de la instancia de VM de Compute Engine. Nota: Es opcional para las colecciones locales.
sqlserver_configuration.credential_configurations[].vm_properties.instance_id	String Especifica el ID de tu instancia de VM de Compute Engine. Nota: Es opcional para las colecciones locales.
sqlserver_configuration.collection_timeout	Duration Tiempo de espera de la recogida de métricas, en segundos. El valor predeterminado es `10s`.
sqlserver_configuration.max_retries	Int Número máximo de reintentos cuando se produce un error en la recogida. El valor predeterminado es `3`.
sqlserver_configuration.retry_frequency	Duration Especifica la frecuencia con la que el agente debe volver a intentar la recogida cuando falle. El valor predeterminado es `3600s`.
sqlserver_configuration.remote_collection	Boolean Especifica true para indicar que el agente está recogiendo datos de forma remota. El valor predeterminado es false.

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 SQL Server:

Recogida local

{
"log_level": "INFO",
"common_discovery": {
    "collection_frequency": "10800s"
},
"sqlserver_configuration": {
    "enabled": true,
    "collection_configuration": {
        "collect_guest_os_metrics": true,
        "collect_sql_metrics": true,
        "collection_frequency": "60s"
    },
    "credential_configurations": [
        {
            "connection_parameters": [
                {
                    "host": ".",
                    "username": "db_user_name",
                    "secret": {
                        "project_id": "",
                        "secret_name": "idb_pwd_secret_name"
                    },
                    "port": 1433
                }
            ],
            "local_collection": true
        }
    ],
    "collection_timeout": "60s",
    "max_retries": 5,
    "retry_frequency": "3600s"
}
}

Recogida remota

{
"log_level": "INFO",
"common_discovery": {
    "collection_frequency": "10800s"
},
"sqlserver_configuration": {
    "enabled": true,
    "collection_configuration": {
        "collect_guest_os_metrics": true,
        "collect_sql_metrics": true,
        "collection_frequency": "60s"
    },
    "credential_configurations": [
        {
            "connection_parameters": [
                {
                    "host": "sql_server_instance",
                    "username": "db_user_name",
                    "secret": {
                        "project_id": "",
                        "secret_name": "db_pwd_secret_name"
                    },
                    "port": 1433
                }
            ],
            "remote_win": {
                "connection_parameters": {
                    "host": "sql_server_instance",
                    "username": "user_name",
                    "secret": {
                        "project_id": "",
                        "secret_name": "pwd_secret_name"
                    }
                }
            },
            "vm_properties": {
                "instance_name": "db01",
                "instance_id": "9999999999999999999"
            }
        },
        {
            "connection_parameters": [
                {
                    "host": "sql_server_instance",
                    "username": "db_user_name",
                    "secret": {
                        "project_id": "",
                        "secret_name": "db_pwd_secret_name"
                    },
                    "port": 1433
                }
            ],
            "remote_linux": {
                "connection_parameters": {
                    "host": "sql_server_instance",
                    "username": "user_name",
                    "secret": {
                        "project_id": "",
                        "secret_name": "pwd_secret_name"
                    },
                    "port": 22
                },
                "linux_ssh_private_key_path": "path of the private key"
            },
            "vm_properties": {
                "instance_name": "db02",
                "instance_id": "9999999999999999999"
            }
        }
    ],
    "collection_timeout": "10s",
    "max_retries": 3,
    "retry_frequency": "3600s",
    "remote_collection": true
}
}

Comprobar la versión del agente

Para comprobar la versión de tu agente, sigue estos pasos:

Windows

1. Usa RDP para conectarte al equipo host.
2. Como administrador, ejecuta el siguiente comando desde PowerShell:

   googet installed google-cloud-workload-agent

RHEL - 6, 7

1. Usa SSH para conectarte a la máquina host.
2. Ejecuta el siguiente comando:

   yum info google-cloud-workload-agent

SUSE

1. Usa SSH para conectarte a la máquina host.
2. Ejecuta el siguiente comando:

   zypper info google-cloud-workload-agent

Debian

1. Usa SSH para conectarte a la máquina host.
2. Ejecuta el siguiente comando:

   dpkg -s google-cloud-workload-agent | grep version

Reiniciar el agente

Si Agent for Compute Workloads deja de funcionar o actualiza su configuración, reinicie el agente.

Selecciona tu sistema operativo y sigue los pasos:

Windows

1. Usa RDP para conectarte al equipo host.
2. Como administrador, ejecuta el siguiente comando desde PowerShell:

   Restart-Service -Name 'google-cloud-workload-agent' -Force

Linux

1. Usa SSH para conectarte a la máquina host.
2. Ejecuta el siguiente comando:

   sudo systemctl restart google-cloud-workload-agent

Actualizar el agente

Para asegurarte de que tienes la versión más reciente del agente, debes comprobar si hay actualizaciones periódicamente y actualizar el agente.

Buscar actualizaciones

Selecciona tu sistema operativo y sigue los pasos:

Windows

1. Usa RDP para conectarte al equipo host.
2. Como administrador, ejecuta el siguiente comando desde PowerShell:

   googet latest google-cloud-workload-agent

RHEL - 6, 7

1. Usa SSH para conectarte a la máquina host.
2. Ejecuta el siguiente comando:

   sudo yum check-update google-cloud-workload-agent

SLES

1. Usa SSH para conectarte a la máquina host.
2. Ejecuta el siguiente comando:

   sudo zypper list-updates -r google-cloud-workload-agent

Debian

1. Usa SSH para conectarte a la máquina host.
2. Ejecuta el siguiente comando:

   sudo apt list google-cloud-workload-agent

Instalar una actualización

Selecciona tu sistema operativo y sigue los pasos:

Windows

1. Usa RDP para conectarte al equipo host.
2. Como administrador, ejecuta el siguiente comando desde PowerShell:

   googet install google-cloud-workload-agent

RHEL - 6, 7

1. Usa SSH para conectarte a la máquina host.
2. Ejecuta el siguiente comando:

   sudo yum --nogpgcheck update google-cloud-workload-agent

SLES

1. Usa SSH para conectarte a la máquina host.
2. Ejecuta el siguiente comando:

   sudo zypper --no-gpg-checks update google-cloud-workload-agent

Debian

1. Usa SSH para conectarte a la máquina host.
2. Ejecuta el siguiente comando:

   sudo apt-get install google-cloud-workload-agent

Ver los registros del agente en Cloud Logging

De forma predeterminada, los registros de Agente para cargas de trabajo de Compute se redirigen desde tus instancias de VM a Cloud Logging.

Para ver los registros del agente en Logging, sigue estos pasos:

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

   Ir a Explorador de registros

2. Ve al panel Consulta.

3. En el menú desplegable Recursos, selecciona Global y, a continuación, haz clic en Aplicar.

4. En el editor de consultas, escribe google-cloud-workload-agent.

5. Haz clic en Realizar una consulta.

   Deberías ver los registros generados por las instancias del agente que se ejecutan en todas tus instancias de VM. Para filtrar los registros de una máquina específica, usa los filtros disponibles en la interfaz.

Inhabilitar los registros del agente en Cloud Logging

Para inhabilitar la redirección predeterminada de los registros del agente a Cloud Logging, sigue estos pasos:

1. Establece una conexión RDP o SSH con la instancia de VM host.

2. Abre el archivo de configuración del agente:

   Windows

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

   Linux

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

3. En la propiedad log_to_cloud, actualiza el valor a false.

4. Guarda el archivo de configuración.

5. Reinicia el agente para que se aplique este cambio.

Solucionar problemas

En las siguientes secciones se proporciona información sobre los problemas habituales relacionados con el uso de Agent for Compute Workloads, sus causas y cómo solucionarlos.

Ámbitos de autenticación insuficientes

Problema: si limitas los ámbitos de acceso en tu instancia de VM host, es posible que los registros del agente de cargas de trabajo de Compute muestren un error de permisos de IAM insuficientes.

  googleapi: Error 403: Request had insufficient authentication scopes.
  Details:
  [
    {
      "@type": "type.googleapis.com/google.rpc.ErrorInfo",
      "domain": "googleapis.com",
      "metadata": {
        "method": "google.cloud.workloadmanager.datawarehouse.v1.DataCollectService.WriteInsight",
        "service": "workloadmanager.googleapis.com"
      },
      "reason": "ACCESS_TOKEN_SCOPE_INSUFFICIENT"
    }
  ]


More details:
  Reason: insufficientPermissions, Message: Insufficient Permission

Causa: El agente de cargas de trabajo de Compute requiere ámbitos de acceso mínimos a la API de Cloud en la instancia de VM host.

Solución: para solucionar este problema, habilita los ámbitos de acceso necesarios.

No se ha podido cargar el archivo de configuración

Problema: si el archivo de configuración tiene valores no válidos, aparece el siguiente error.

"Failed to load configuration","pid":3524,"error":"proto: (line 19:42): unknown
field "{field_name}"

Resolución: para solucionar este problema, actualice el archivo de configuración con los detalles que se indican en Parámetros de configuración.

No se ha podido inicializar la recogida de datos

Problema: después de instalar el agente, si el archivo de configuración no se actualiza, aparece el siguiente error:

"Failed to initialize guest collection","pid":2112,"error":"invalid value for "user_name" "secret_name"

Solución: para solucionar este problema, inicialice la configuración de las credenciales con los parámetros de configuración.

Siguientes pasos

• Más información sobre las evaluaciones de la carga de trabajo