En esta guía, se muestra cómo configurar el agente de Google Cloudpara 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 Cloudpara SAP.
Antes de comenzar
- Valida la instalación del agente de Google Cloudpara 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 Cloudpara SAP en Linux.
Asegúrate de que la API de Workload Manager esté habilitada para tu proyecto deGoogle Cloud .
Roles de IAM obligatorios
Para garantizar que la cuenta de servicio tenga los permisos necesarios para permitir que el agente de Google Cloudpara SAP recopile métricas de evaluación de Workload Manager, pídele a tu administrador que le otorgue a la cuenta de servicio los siguientes roles de IAM en tu proyecto:
-
Visualizador de Compute (
roles/compute.viewer
): Para recopilar las métricas de evaluación de Workload Manager de la instancia de Compute Engine que aloja tu sistema SAP. -
Escritor de estadísticas de Workload Manager (
roles/workloadmanager.insightWriter
): Para escribir las métricas recopiladas en el almacén de datos de Workload Manager. -
(Opcional) Descriptor de acceso a secretos de Secret Manager (
roles/secretmanager.secretAccessor
): Si usas Secret Manager para almacenar la contraseña y conectarte a la base de datos de SAP HANA.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Estos roles predefinidos contienen los permisos necesarios para permitir que el agente de Google Cloudpara SAP recopile métricas de evaluación de Workload Manager. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para permitir que el agente de Google Cloudpara SAP recopile métricas de evaluación de Workload Manager:
-
Para recopilar las métricas de evaluación de Workload Manager de la instancia de Compute Engine host y escribirlas en el almacén de datos de Workload Manager, haz lo siguiente:
-
monitoring.timeSeries.create
-
compute.zoneOperations.list
-
compute.disks.list
-
compute.nodeGroups.get
-
workloadmanager.insights.write
-
-
Si usas Secret Manager para almacenar la contraseña y conectarte a la base de datos de SAP HANA, sigue estos pasos para acceder al secreto:
secretmanager.versions.access
Es posible que tu administrador también pueda otorgar estos permisos a la cuenta de servicio con roles personalizados o con otros roles predefinidos.
Roles obligatorios de SAP HANA
Para permitir que el agente recopile métricas de tu base de datos de SAP HANA, asegúrate de que el usuario de SAP HANA que especifiques en el archivo de configuración del agente tenga el rol MONITORING
.
Para obtener información sobre este rol, consulta el documento de SAP Funciones de base de datos estándar.
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.
Para asegurarte de tener la última versión del agente de Google Cloudpara 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
- Establece una conexión SSH con tu instancia.
- Actualiza la instancia del agente:
- (Recomendado) Para actualizar a la versión 3.8 (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, como3.1-606637668
. Para obtener información sobre las versiones de agentes que puedes instalar, consulta Lista de todas las versiones disponibles del agente.
- (Recomendado) Para actualizar a la versión 3.8 (más reciente)
del agente, haz lo siguiente:
SLES
- Establece una conexión SSH con tu instancia.
- Actualiza la instancia del agente:
- (Recomendado) Para actualizar a la versión 3.8 (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, como3.1-606637668
. Para obtener información sobre las versiones de agentes que puedes instalar, consulta Lista de todas las versiones disponibles del agente.
- (Recomendado) Para actualizar a la versión 3.8 (más reciente)
del agente, haz lo siguiente:
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 Cloudpara 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:
Establece una conexión SSH con tu instancia de Compute Engine o el servidor de la solución Bare Metal.
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
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:
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. Para obtener más información, consulta Comandos de configuración para el agente de Google Cloudpara SAP.
Agrega la sección
workload_validation_db_metrics_config
después decollect_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 de la base de datos en el que la instancia de SAP HANA acepta consultas. Por ejemplo, ingresa30015
si la base de datos de tu inquilino está escuchando en el puerto30015
.sid
: especifica el SID de tu instancia de SAP HANAhana_db_password_secret_name
: especifica el nombre del objeto Secret en Secret Manager que almacena la contraseña de la cuenta de usuarioComo alternativa al objeto Secret, puedes usar el parámetro de configuración
hdbuserstore_key
.hdbuserstore_key
: especifica la clavehdbuserstore
que autentica al usuario que especificaste parahana_db_user
.Si especificas
hdbuserstore_key
, omites la especificación de los parámetroshostname
yport
.
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óncloud_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 Compute Engine
Los siguientes ejemplos son archivos de configuración completos del agente deGoogle Cloudpara SAP que se ejecuta en unainstancia de Compute Engine, en el que está habilitada la recopilación de las métricas de evaluación de Workload Manager.
Para la autenticación de SAP HANA, el agente usa el siguiente orden de preferencia: si se especifica, el parámetro de configuración hdbuserstore_key
se prefiere al parámetro hana_db_password
, que se prefiere al parámetro hana_db_password_secret_name
. Te recomendamos que configures solo una opción de autenticación en tu archivo de configuración.
- En el siguiente ejemplo, se usa una clave de almacenamiento seguro de usuario (
hdbuserstore
) para la autenticación de SAP HANA:{ "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" }, "collect_process_metrics": false }, "discovery_configuration": { "enable_discovery": true, "enable_workload_discovery": true }, "hana_monitoring_configuration": { "enabled": false } }
- En el siguiente ejemplo, se usa un nombre de usuario y un secreto de Secret Manager para la autenticación de SAP HANA:
{ "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", "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 } }
- En el siguiente ejemplo, se usa un nombre de usuario y una contraseña para la autenticación de SAP HANA. En su lugar, te recomendamos que uses un secreto de Secret Manager o una clave de almacenamiento seguro de usuario (
hdbuserstore
) para la autenticación de SAP HANA.{ "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", "hana_db_password": "TempPa55word", "hostname": "localhost", "port": "30015" }, "collect_process_metrics": false }, "discovery_configuration": { "enable_discovery": true, "enable_workload_discovery": true }, "hana_monitoring_configuration": { "enabled": false } }
Servidor de solución Bare Metal
Los siguientes ejemplos son archivos de configuración completos del agente deGoogle Cloudpara SAP que se ejecuta en unade un servidor de la solución Bare Metal, en el que está habilitada la recopilación de las métricas de evaluación de Workload Manager.
Para la autenticación de SAP HANA, el agente usa el siguiente orden de preferencia: si se especifica, el parámetro de configuración hdbuserstore_key
se prefiere al parámetro hana_db_password
, que se prefiere al parámetro hana_db_password_secret_name
. Te recomendamos que configures solo una opción de autenticación en tu archivo de configuración.
- En el siguiente ejemplo, se usa una clave de almacenamiento seguro de usuario (
hdbuserstore
) para la autenticación de SAP HANA:{ "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" }, "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 } } - En el siguiente ejemplo, se usa un nombre de usuario y un secreto de Secret Manager para la autenticación de SAP HANA:
{ "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", "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 } } - En el siguiente ejemplo, se usa un nombre de usuario y una contraseña para la autenticación de SAP HANA. En su lugar, te recomendamos que uses un secreto de Secret Manager o una clave de almacenamiento seguro de usuario (
hdbuserstore
) para la autenticación de SAP HANA.{ "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", "hana_db_password": "TempPa55word", "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 deGoogle Cloudpara 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 |
Para habilitar la recopilación de las métricas que requiere SAP Host Agent, especifica |
bare_metal |
Cuando el agente se instale en un servidor de solución Bare Metal, especifica
|
log_level |
Para establecer el nivel de registro del agente, establece el valor requerido. Los niveles de registro disponibles son los siguientes:
El valor predeterminado es |
log_to_cloud |
Para redireccionar los registros del agente a Cloud Logging, especifica |
cloud_properties.project_id |
Si tu sistema SAP se ejecuta en un servidor de la solución Bare Metal, especifica el ID del proyecto Google Cloud que usas con la solución Bare Metal. |
cloud_properties.instance_name
|
Si el sistema SAP se ejecuta en una instancia de Compute Engine, especifica el nombre de esa instancia de procesamiento. El agente detecta automáticamente el nombre de la instancia de procesamiento 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 |
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. |
cloud_properties.zone |
Cuando el agente se ejecuta en una instancia de procesamiento, de forma predeterminada, usa la zona en la que se implementa la instancia de procesamiento. |
cloud_properties.image |
Especifica el nombre de la imagen de SO de la instancia. |
cloud_properties.numeric_project_id |
Especifica el ID numérico del Google Cloud proyecto en el que se ejecuta el sistema SAP. |
discovery_configuration.enable_workload_discovery |
Para permitir que el agente recopile los nombres y las versiones de los productos SAP que se ejecutan en el host, especifica Para obtener más información, consulta la base de código del agente en el repositorio |
discovery_configuration.enable_discovery |
Para enviar a Cloud Logging la información que el agente recopila sobre los productos de SAP que se ejecutan en el host, especifica Si especificas el valor |
collection_configuration.collect_workload_validation_metrics |
Para habilitar la recopilación de métricas de evaluación de Workload Manager, especifica |
collection_configuration.workload_validation_metrics_frequency |
La frecuencia de recopilación de las métricas de evaluación de Workload Manager, en segundos. El valor predeterminado es Si necesitas modificar la frecuencia de recopilación de las métricas del Administrador de cargas de trabajo, agrega el parámetro |
collection_configuration.workload_validation_collection_definition.fetch_latest_config |
Opcional. El valor predeterminado es |
collection_configuration.workload_validation_db_metrics_config.hana_db_user |
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 |
Especifica la contraseña de la cuenta de usuario que se usa para consultar la instancia de SAP HANA. Para la autenticación de SAP HANA, el agente usa el siguiente orden de preferencia: si se especifica, el parámetro de configuración |
collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name |
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 Para la autenticación de SAP HANA, el agente usa el siguiente orden de preferencia: si se especifica, se prefiere el parámetro de configuración |
collection_configuration.workload_validation_db_metrics_config.hdbuserstore_key
|
Para conectarte de forma segura a un sistema SAP HANA, especifica una
clave de almacenamiento seguro de usuario ( Para usar una clave
Este parámetro de configuración es compatible con la versión 3.3 del agente. Si especificas Para la autenticación de SAP HANA, el agente usa el siguiente orden de preferencia: si se especifica, se prefiere el parámetro de configuración |
collection_configuration.workload_validation_db_metrics_config.sid |
Especifica el SID de tu instancia de SAP HANA. |
collection_configuration.workload_validation_db_metrics_config.hostname |
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:
|
collection_configuration.workload_validation_db_metrics_config.port |
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 |
collection_configuration.workload_validation_db_metrics_frequency |
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 |
Valida la configuración para la recopilación de métricas de evaluación de Workload Manager
Para validar si tienes la configuración correcta de Google Cloud para la recopilación de las métricas de evaluación del Administrador de cargas de trabajo, ejecuta el comando status
del agente. Este comando es compatible con la versión 3.7 del agente.
Para validar la configuración de Google Cloud , completa los siguientes pasos:
- Establece una conexión SSH con tu instancia de Compute Engine.
- Ejecuta el siguiente comando:
sudo /usr/bin/google_cloud_sap_agent status
Si la Google Cloud configuración para la recopilación de métricas de evaluación de Workload Manager es correcta, el resultado incluirá lo siguiente. Tu configuración puede tener valores distintos de los de
default
.Agent Status: ... Systemd Service Enabled: True Systemd Service Running: True Cloud API Full Scopes: True Configuration File: /etc/google-cloud-sap-agent/configuration.json Configuration Valid: True ... ---------------------------------------------------------------------------- System Discovery: Enabled Status: Fully Functional IAM Permissions: All granted Configuration: enable_discovery: true (default) enable_workload_discovery: true (default) sap_instances_update_frequency: 60 (default) system_discovery_update_frequency: 14400 (default) ---------------------------------------------------------------------------- Workload Manager Evaluation: Enabled Status: Fully Functional IAM Permissions: All granted Configuration: collect_workload_validation_metrics: true (default) config_target_environment: PRODUCTION (default) fetch_latest_config: true (default) workload_validation_db_metrics_frequency: 3600 (default) workload_validation_metrics_frequency: 300 (default) ...
- Si el resultado indica que falta algún parámetro de configuración, revisa la información proporcionada en las secciones anteriores, realiza las acciones necesarias y, luego, vuelve a ejecutar el comando
status
para volver a validar la configuración.
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:
Define el nivel de registro del agente en
DEBUG
:sudo /usr/bin/google_cloud_sap_agent configure -loglevel=debug
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
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 deseas 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.