Configura la recopilación de métricas de evaluación Workload Manager

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

Si deseas obtener más información sobre esta función, consulta Evaluación de Workload Manager mediante el agente de Google Cloud para SAP.

Antes de comenzar

Configura los roles de IAM

Para permitir que el agente de Google Cloud para SAP recopile las métricas de Workload Manager, 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:

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

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

    Ir a IAM

  2. Selecciona tu proyecto de Google Cloud.

  3. 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.
  4. Selecciona el rol necesario de la lista de funciones disponibles:

    • Visualizador de Compute
    • Administrador de cargas de trabajo > Escritor de estadísticas del administrador de cargas de trabajo
    • Secret Manager > Usuario con acceso a secretos de Secret Manager
  5. Haz clic en Agregar o Guardar para aplicar los roles a la cuenta de servicio.

Verifica la versión del agente

Google Cloud recomienda que instales la versión más reciente del agente para SAP para obtener una evaluación precisa de tus cargas de trabajo de SAP, ya que las versiones periódicas del agente para SAP podrían agregar o cambiar métricas que se usan en la evaluación.

A fin de asegurarte de tener la última versión del agente de Google Cloud para SAP, debes verificar si hay actualizaciones periódicamente y actualizar el agente.

Instala una actualización

Selecciona tu sistema operativo y, luego, sigue estos pasos:

RHEL

  1. Establece una conexión SSH con tu instancia.
  2. Actualiza la instancia del agente:
    • (Recomendado) Para actualizar a la versión 3.3 (más reciente) del agente, haz lo siguiente:
      sudo yum --nogpgcheck update google-cloud-sap-agent
    • Para actualizar a una versión específica del agente, sigue estos pasos:
      sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      Reemplaza VERSION_NUMBER por el número de versión del agente que deseas instalar, como 3.1-606637668. Para obtener información sobre las versiones de agentes que puedes instalar, consulta Lista de todas las versiones disponibles del agente.

SLES

  1. Establece una conexión SSH con tu instancia.
  2. Actualiza la instancia del agente:
    • (Recomendado) Para actualizar a la versión 3.3 (más reciente) del agente, haz lo siguiente:
      sudo zypper --no-gpg-checks update google-cloud-sap-agent
    • Para actualizar a una versión específica del agente, sigue estos pasos:
      sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      Reemplaza VERSION_NUMBER por el número de versión del agente que deseas instalar, como 3.1-606637668. Para obtener información sobre las versiones de agentes que puedes instalar, consulta Lista de todas las versiones disponibles del agente.

Habilita la recopilación de métricas de evaluación de Workload Manager

A partir de la versión 3.2, las instalaciones nuevas del agente de Google Cloud para SAP están habilitadas de forma predeterminada para recopilar las métricas de evaluación de Workload Manager. Si actualizas a la versión 3.2 desde una versión anterior, también puedes habilitar la función de forma explícita. Para ello, completa los siguientes pasos:

  1. Establece una conexión SSH con tu instancia de VM de Compute Engine o el servidor de la solución Bare Metal.

  2. Para permitir que el agente recopile las métricas de evaluación de Workload Manager, haz lo siguiente:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -enable

  3. Para habilitar la recopilación de las métricas “Estadísticas de SAP HANA” y “Prácticas recomendadas de seguridad de SAP HANA” haz lo siguiente:

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

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

      Como alternativa, también puedes realizar esta configuración mediante la ejecución de comandos. Si deseas obtener más información, consulta Comandos de configuración para el agente de Google Cloud para SAP.

    2. 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 de la base de datos de SAP HANA que se usa para consultar la instancia de SAP HANA.
      • 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.
      • sid: especifica el SID de tu instancia de SAP HANA
      • hana_db_password_secret_name: especifica el nombre del objeto Secret en Secret Manager que almacena la contraseña de la cuenta de usuario

        Como alternativa al objeto Secret, puedes usar el parámetro de configuración hdbuserstore_key.

      • hdbuserstore_key: especifica la clave hdbuserstore que autentica al usuario que especificaste para hana_db_user.

        Si especificas hdbuserstore_key, omites la especificación de los parámetros hostname y port.

      Para obtener más información sobre estos parámetros, consulta Parámetros de configuración.

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

  5. Guarda el archivo de configuración.

  6. 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 de la solución Bare Metal, en el que está habilitada la recopilación de las métricas de evaluación de Workload Manager:
{
  "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": "system",
      "sid": "DEH",
      "hdbuserstore_key": "user_store_key",
      "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
      "hostname": "localhost",
      "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 una instancia de VM de Compute Engine de un servidor, en el que está habilitada la recopilación de las métricas de evaluación de Workload Manager:
{
  "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": "system",
      "sid": "DEH",
      "hdbuserstore_key": "user_store_key",
      "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
      "hostname": "localhost",
      "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 evaluació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 evaluación de Workload Manager, especifica true. A partir de la versión 3.2, el valor predeterminado es true.
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 evaluación de Workload Manager, en segundos. El valor predeterminado es 300 segundos.

Si necesitas modificar la frecuencia de recopilación de las métricas del Administrador de cargas de trabajo, 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 último conjunto de métricas de evaluación del Administrador de cargas de trabajo sin necesidad de que actualices 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.

Como alternativa, puedes especificar el parámetro de configuración hdbuserstore_key para autenticar el usuario de SAP HANA especificado.

collection_configuration.workload_validation_db_metrics_config.hdbuserstore_key

String

A fin de autenticar el usuario de SAP HANA que especifiques para hana_db_user, especifica una clave hdbuserstore que creaste para ese usuario.

A fin de usar una clave hdbuserstore para la autenticación, asegúrate de cumplir con las siguientes condiciones:

  • Las herramientas de SAP hdbsql y hdduserstore se instalan en la instancia de procesamiento que aloja el agente.
  • La clave hdbuserstore corresponde a una instancia específica de SAP HANA. No puedes usar claves que contengan nombres de host de varias instancias de SAP HANA.

Si especificas hdbuserstore_key, puedes omitir la especificación de los parámetros hostname y port.

collection_configuration.workload_validation_db_metrics_config.sid

String

Especifica el SID de tu instancia de SAP HANA.

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 evaluació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.