Configura la recopilación de métricas de validación del Administrador de cargas de trabajo

En esta guía se muestra cómo configurar el agente de Google Cloud para SAP a fin de recopilar las métricas de validación de Workload Manager de tus sistemas SAP.

Si deseas obtener más información sobre esta función, consulta Validación del administrador de cargas de trabajo mediante el agente de Google Cloud para SAP.

Antes de comenzar

Valida la instalación del agente de Google Cloud para SAP. Para obtener instrucciones, consulta la guía de instalación de tu situación.
Si instalaste el agente en un servidor de la solución Bare Metal, asegúrate de que hayas completado los requisitos previos necesarios y configurado una cuenta de servicio. Si deseas obtener instrucciones, consulta Configura el agente de Google Cloud para SAP en Linux.

Configura las funciones de IAM

Para permitir que el agente de Google Cloud para SAP recopile las métricas de Process Monitoring, debes asegurarte de que la cuenta de servicio que usa tu instancia de VM de Compute Engine o el servidor de la solución Bare Metal incluya los siguientes roles:

Visualizador de Compute (roles/compute.viewer)
Escritor de métricas de Monitoring (roles/monitoring.metricWriter)
Descriptor de acceso secreto de Secret Manager (roles/secretmanager.secretAccessor), si usas Secret Manager para almacenar la contraseña de la base de datos de SAP HANA.

Para agregar estos roles necesarios a tu cuenta de servicio, sigue estos pasos:

En la consola de Google Cloud, ve a la página IAM.

Ir a IAM
Selecciona tu proyecto de Google Cloud.
Identifica la cuenta de servicio a la que le quieres agregar un rol.
- Si la cuenta de servicio no se encuentra aún en la lista de principales, no tiene ningún rol asignado. Haz clic en Agregar e ingresa la dirección de correo electrónico de la cuenta de servicio.
- Si la cuenta de servicio ya se encuentra en la lista de principales es porque tiene roles existentes. Haz clic en el botón Editar de la cuenta de servicio que deseas editar.
Selecciona el rol necesario de la lista de funciones disponibles:
- Visualizador de Compute
- Monitoring > Escritor de métricas de Monitoring
- Secret Manager > Usuario con acceso a secretos de Secret Manager
Haz clic en Agregar o Guardar para aplicar los roles a la cuenta de servicio.

Habilita la recopilación de métricas de validación del administrador de cargas de trabajo

Si deseas habilitar la recopilación de métricas de validación de Workload Manager mediante el agente de Google Cloud para SAP, sigue estos pasos:

Establece una conexión SSH con tu instancia de VM de Compute Engine o el servidor de la solución Bare Metal.
Reemplaza el archivo de configuración del agente:
```
/etc/google-cloud-sap-agent/configuration.json
```
En la sección collection_configuration, para el parámetro collect_workload_validation_metrics, establece el valor true.
Para habilitar la recopilación de la métrica workload.googleapis.com/sap/validation/hanasecurity que habilita las reglas de validación de seguridad en Workload Manager, agrega la sección workload_validation_db_metrics_config después de collect_workload_validation_metrics y, luego, especifica los siguientes parámetros:
- hana_db_user: especifica la cuenta de usuario que se usa para consultar la instancia de SAP HANA.
- hana_db_password_secret_name: especifica el nombre del secreto en Secret Manager que almacena la contraseña de la cuenta de usuario.
- hostname: especifica el identificador de la máquina, ya sea local o remoto, que aloja la instancia de SAP HANA.
- port: especifica el puerto en el que la instancia de SAP HANA acepta consultas.
Para obtener más información sobre estos parámetros, consulta Parámetros de configuración.
De manera opcional, en la sección cloud_properties, puedes actualizar los valores del parámetro que se configuran de forma automática. Para hacerlo, agrega la sección cloud_properties a tu archivo de configuración y, luego, especifica las propiedades obligatorias y sus valores.
Guarda el archivo de configuración.
Reinicia el agente para que se aplique la configuración nueva:
```
sudo systemctl restart google-cloud-sap-agent
```

Archivos de configuración de ejemplo

Instancia de VM de Compute Engine

El siguiente ejemplo es un archivo de configuración completo del agente de Google Cloud para SAP, que se ejecuta en una instancia de VM de Compute Engine, en el que se habilita la recopilación de las métricas de Process Monitoring:

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user":"db_user_name",
      "hana_db_password_secret_name": "db_pwd_secret_name",
      "hostname": "hana_hostname",
      "port": "30015"
    },
    "collect_process_metrics": false
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "vm-instance-1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Servidor de solución Bare Metal

El siguiente ejemplo es un archivo de configuración completo del agente de Google Cloud para SAP, que se ejecuta en un servidor de solución Bare Metal, en el que se habilita la recopilación de las métricas de Process Monitoring:

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user":"db_user_name",
      "hana_db_password_secret_name": "db_pwd_secret_name",
      "hostname": "hana_hostname",
      "port": "30015"
    },
    "collect_process_metrics": false
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1"
    "region": "us-central1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Parámetros de configuración

En la siguiente tabla, se explican los parámetros de configuración del agente de Google Cloud para SAP que son específicas de la recopilación de las métricas de validación de Workload Manager.

Parámetros
`provide_sap_host_agent_metrics`	`Boolean` Para habilitar la recopilación de las métricas que requiere SAP Host Agent, especifica `true`. La ruta predeterminada es `true`. No establezcas `provide_sap_host_agent_metrics` en `false`, a menos que te dirijan el servicio de atención al cliente de Cloud o el de asistencia de SAP.
`bare_metal`	`Boolean` Cuando el agente se instale en un servidor de solución Bare Metal, especifica `true`. La ruta predeterminada es `false`.
`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 valor 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`.
`cloud_properties.project_id`	`String` Si tu sistema SAP se ejecuta en un servidor de la solución Bare Metal, especifica el ID del proyecto de Google Cloud que usas con la solución Bare Metal. Cuando el agente se ejecuta en una instancia de VM, de forma predeterminada, detecta el ID del proyecto automáticamente.
`cloud_properties.instance_name`	`String` Si el sistema SAP se ejecuta en una instancia de VM de Compute Engine, especifica el nombre de esa instancia de VM. El agente detecta automáticamente el nombre de la instancia de VM durante la instalación. Si tu sistema SAP se ejecuta en un servidor de la solución Bare Metal, especifica el nombre de ese servidor.
`cloud_properties.region`	`String` Si tu sistema SAP se ejecuta en un servidor de la solución Bare Metal, especifica la región del servidor de la solución Bare Metal. Cuando el agente se ejecuta en una instancia de VM, de forma predeterminada, usa la región de la instancia de VM en la que está instalado el agente.
`cloud_properties.zone`	`String` Cuando el agente se ejecuta en una instancia de VM, de forma predeterminada, usa la zona de la instancia de VM en la que está instalado el agente.
`cloud_properties.image`	`String` Especifica el nombre de la imagen de SO de la instancia. Cuando el agente se ejecuta en una instancia de VM, de forma predeterminada, detecta el imagen de SO de la instancia de VM en la que está instalado el agente.
`cloud_properties.numeric_project_id`	`String` El ID numérico del proyecto de Google Cloud en el que se ejecuta el sistema SAP. Cuando el agente se ejecuta en una instancia de VM, de forma predeterminada, detecta el ID del proyecto numérico automáticamente.
`discovery_configuration.enable_workload_discovery`	`Boolean` Para permitir que el agente recopile los nombres y las versiones de los productos SAP que se ejecutan en el host, especifica `true`. El valor predeterminado es `true`. Para obtener más información, consulta la base de código del agente en el repositorio `google-cloud-sap-agent` de GitHub en GoogleCloudPlatform/sapagent.
`discovery_configuration.enable_discovery`	`Boolean` Para enviar a Cloud Logging la información que el agente recopila sobre los productos de SAP que se ejecutan en el host, especifica `true`. El valor predeterminado es `true`. Si especificas el valor `false`, el agente almacenará la información recopilada en el host y no la enviará a Cloud Logging.
`collection_configuration.collect_workload_validation_metrics`	`Boolean` Para habilitar la recopilación de métricas de validación de Workload Manager, especifica `true`. La ruta predeterminada es `false`. Este parámetro solo se aplica a Linux.
`collection_configuration.workload_validation_metrics_frequency`	`Int` La frecuencia de recopilación de las métricas de validación del Administrador de cargas de trabajo, en segundos. El valor predeterminado es `300` segundos. Aunque puedes actualizar la frecuencia de recopilación de las métricas de validación del administrador de cargas de trabajo, te recomendamos que uses el valor predeterminado. Si necesitas modificar el valor predeterminado, agrega el parámetro `workload_validation_metrics_frequency` en la sección `collection_configuration` y proporciona el valor requerido.
`collection_configuration.workload_validation_collection_definition.fetch_latest_config`	`Boolean` Opcional. El valor predeterminado es `true`, que permite que el agente recopile el conjunto más reciente de métricas de validación de Workload Manager sin necesidad de actualizar el agente. Si deseas desactivar este comportamiento, especifica este parámetro en tu archivo de configuración y establece su valor en `false`.
`collection_configuration.workload_validation_db_metrics_config.hana_db_user`	`String` Especifica la cuenta de usuario que se usa para consultar la instancia de SAP HANA. La cuenta de usuario debe tener el permiso de lectura para la base de datos de SAP HANA.
`collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name`	`String` Especifica el nombre del secreto en Secret Manager que almacena la contraseña de la cuenta de usuario.
`collection_configuration.workload_validation_db_metrics_config.hostname`	`String` Especifica el identificador de la máquina, ya sea local o remoto, que aloja la instancia de SAP HANA. Los siguientes son los valores admitidos: Si el host es una máquina local, especifica la cadena `localhost` o la dirección IP de bucle invertido del host local, como `127.0.0.1`. Si el host es una máquina remota, especifica su dirección IP interna o externa.
`collection_configuration.workload_validation_db_metrics_config.port`	`String` Especifica el puerto en el que la instancia de SAP HANA acepta consultas. Para la primera o única instancia de base de datos de usuario, el puerto es `3NN15`, en el que `NN` es el número de instancia de la instancia de SAP HANA.
`collection_configuration.workload_validation_db_metrics_frequency`	`Int` La frecuencia de recopilación de las métricas de la base de datos de SAP HANA, en segundos, para la validación de Workload Manager. El valor predeterminado es `3600` segundos. Si bien puedes actualizar la frecuencia de recopilación de las métricas de la base de datos de SAP HANA, te recomendamos que uses el valor predeterminado. Si necesitas modificar el valor predeterminado, agrega el parámetro `workload_validation_db_metrics_frequency` en la sección `collection_configuration` y proporciona el valor requerido. Asegúrate de no establecer una frecuencia de recopilación mayor que `3600` segundos.