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

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

• Asegúrate de que la API de Workload Manager esté habilitada para tu proyecto de Google Cloud.

  Habilita la API de Workload Manager

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:

• Visualizador de Compute (roles/compute.viewer)
• Escritor de estadísticas del administrador de cargas de trabajo (roles/workloadmanager.insightWriter)
• 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:

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:

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 del Administrador de cargas de trabajo, 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

{
  "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
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

{
  "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,
    "enable_workload_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.

Visualiza las métricas recopiladas

Para ver las métricas de evaluación de Workload Manager que recopila el agente, puedes hacer lo siguiente:

• Consulta el archivo de registro del agente:

  1. Define el nivel de registro del agente en DEBUG:

     sudo /usr/bin/google_cloud_sap_agent configure -loglevel=debug

  2. Después de que el agente se reinicie para afectar el nivel de registro nuevo, consulta el archivo de registro del agente:

     /var/log/google-cloud-sap-agent.log

  3. En el archivo de registro, busca entradas que contengan la siguiente información:

     workload.googleapis.com/sap/validation/

     El siguiente es un ejemplo que muestra las métricas de evaluación de Workload Manager en el archivo de registro del agente:

     {"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
     "metric":"workload.googleapis.com/sap/validation/system","value":1}
     {"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
     "key":"instance_name","value":"n1-hana-sles15"}
     {"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
     "key":"os","value":"sles-15-SP4"}
     ...
     {"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
     "metric":"workload.googleapis.com/sap/validation/corosync","value":0}
     ...

• Si tu instancia de agente está configurada para enviar registros a Cloud Logging, puedes ver los registros del agente en Cloud Logging.

• Crea y ejecuta una evaluación para la carga de trabajo de SAP en Workload Manager. Para obtener más información, consulta Crea y ejecuta una evaluación.

  Si quieres obtener información sobre las prácticas recomendadas que admite Workload Manager para evaluar las cargas de trabajo de SAP que se ejecutan en Google Cloud, consulta Prácticas recomendadas de Workload Manager para SAP.