El Agente de Google Cloud para SAP es necesario para la compatibilidad con SAP en los sistemas SAP que se ejecutan en un servidor de la solución Bare Metal.
Si usas las siguientes imágenes de SO de RHEL o SLES “para SAP” que proporciona Google Cloud, el agente de Google Cloud para SAP se empaqueta con las imágenes de SO:
- RHEL: todas las imágenes “para SAP”
- SLES: SLES 15 SP4 para SAP y versiones posteriores
Para obtener información sobre los sistemas operativos disponibles para ejecutar SAP en los servidores de la solución Bare Metal, consulta los siguientes vínculos:
- Para obtener información sobre SAP HANA, consulta Sistemas operativos certificados.
- Para obtener información sobre SAP NetWeaver, consulta Sistemas operativos certificados.
Si deseas instalar y configurar la versión 3.2 (más reciente) del agente de Google Cloud para SAP en una instancia de VM de Compute Engine, consulta Instala el agente de Google Cloud para SAP en una instancia de VM de Compute Engine.
Descripción general de instalación
Para instalar el agente de Google Cloud para SAP, usa los comandos de administración de paquetes del sistema operativo estándar: en RHEL, el comando yum
; en SLES, el comando zypper
. El comando de administración de paquetes completa las siguientes tareas:
- Descarga la última versión del agente de Google Cloud para SAP.
- Crea el agente como un servicio
systemd
de Linux, llamadogoogle-cloud-sap-agent
. - Habilita e inicia el servicio,
google-cloud-sap-agent
.
Instala el agente
Si deseas instalar el agente de Google Cloud para SAP en un servidor de la solución Bare Metal, sigue estos pasos:
Establece una conexión SSH a tu servidor de la solución Bare Metal.
En tu terminal, instala el agente mediante la ejecución del comando específico de tu sistema operativo:
- (Recomendado) Para instalar la versión 3.2 (más reciente) del agente, sigue estos pasos:
RHEL
sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM [google-cloud-sap-agent] name=Google Cloud Agent for SAP baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-\\$basearch enabled=1 gpgcheck=1 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-sap-agent
SLES
sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-\\$basearch google-cloud-sap-agent sudo zypper install google-cloud-sap-agent
SLES 12
sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-\\$basearch google-cloud-sap-agent sudo zypper install google-cloud-sap-agent
Para instalar una versión específica del agente, ejecuta este comando:
RHEL
sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM [google-cloud-sap-agent] name=Google Cloud Agent for SAP baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-\\$basearch enabled=1 gpgcheck=1 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-sap-agent-VERSION_NUMBER.x86_64
SLES
sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-\\$basearch google-cloud-sap-agent sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64
SLES 12
sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-\\$basearch google-cloud-sap-agent 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 instalar la versión 3.2 (más reciente) del agente, sigue estos pasos:
Abre el siguiente archivo de configuración:
/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.
Modifica o agrega los siguientes parámetros al archivo de configuración:
- En la primera sección:
bare_metal
: establecido comotrue
.
- Agrega la sección
cloud_properties
y especifica los siguientes parámetros:project_id
: especifica tu proyecto de Google Cloudinstance_name
: especifica el nombre de tu servidor de la solución Bare Metalregion
: especifica la región de tu servidor de la solución Bare Metal
- En la primera sección:
Guarda el archivo de configuración.
Reinicia el agente:
sudo systemctl restart google-cloud-sap-agent
Después de instalar el Agente de Google Cloud para SAP y SAP Host Agent, valida la instalación del Agente de Google Cloud para SAP, como se describe en Valida la instalación del agente.
Valida la instalación del agente
Establece una conexión SSH con tu servidor de la solución Bare Metal.
Ejecuta el siguiente comando:
systemctl status google-cloud-sap-agent
Si el agente funciona de forma correcta, el resultado contendrá
active (running)
. Por ejemplo:google-cloud-sap-agent.service - Google Cloud Agent for SAP Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; enabled; vendor preset: disabled) Active: active (running) since Fri 2022-12-02 07:21:42 UTC; 4 days ago Main PID: 1337673 (google-cloud-sa) Tasks: 9 (limit: 100427) Memory: 22.4 M (max: 1.0G limit: 1.0G) CGroup: /system.slice/google-cloud-sap-agent.service └─1337673 /usr/bin/google-cloud-sap-agent
Si el agente no está en ejecución, reinicia el agente.
Verifica que el agente de host SAP reciba métricas
Para verificar que el Agente de Google Cloud para SAP recopile las métricas de infraestructura y que se envíen de forma correcta al agente de host SAP, sigue estos pasos:
- En el sistema SAP, ingresa la transacción
ST06
. En el panel de descripción general, revisa la disponibilidad y el contenido de los siguientes campos para verificar la configuración completa y correcta de la infraestructura de supervisión de SAP y Google:
- Proveedor de servicios en la nube:
Google Cloud Platform
- Acceso de supervisión mejorada:
TRUE
- Detalles de supervisión mejorada:
ACTIVE
- Proveedor de servicios en la nube:
Configura el agente de Google Cloud para SAP en Linux
Después de instalar el agente de Google Cloud para SAP, de forma opcional, puedes habilitar otras funciones del agente si realizas las siguientes configuraciones. De forma predeterminada, la recopilación de métricas de SAP Host Agent y métricas de evaluación de Workload Manager está habilitada.
Requisitos previos
Para permitir que el agente acceda a los recursos de Google Cloud desde un entorno de la solución Bare Metal, debes completar los siguientes requisitos previos:
- Crea una cuenta de servicio de IAM para que el agente acceda a los recursos de Google Cloud y, luego, otorga las funciones de IAM necesarias a la cuenta de servicio. Consulta Configura una cuenta de servicio para obtener más detalles.
- En el servidor de la solución Bare Metal, instala la gcloud CLI. Consulta Instala la gcloud CLI para obtener más detalles.
- Para acceder a Google Cloud, autoriza la gcloud CLI. Consulta Autoriza la gcloud CLI para obtener más detalles.
- Establece la conexión con las API de Google Cloud. Consulta Configura el Acceso privado a Google para hosts locales a fin de obtener más detalles.
Configurar una cuenta de servicio
Para permitir que el agente acceda a los recursos de Google Cloud desde un entorno de la solución Bare Metal, debes configurar una cuenta de servicio de IAM.
Como mínimo, la cuenta de servicio que usa el agente debe incluir el rol Escritor de estadísticas de Workload Manager (roles/workloadmanager.insightWriter
).
Para crear una cuenta de servicio, sigue estos pasos:
-
Create a service account:
-
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.
In the Service account description field, enter a description. For example,
Service account for quickstart
. - Click Create and continue.
-
Grant the Workload Manager > Workload Manager Insights Writer role to the service account.
To grant the role, find the Select a role list, then select Workload Manager > Workload Manager Insights Writer.
- Click Continue.
-
Click Done to finish creating the service account.
Do not close your browser window. You will use it in the next step.
-
-
Create a service account key:
- In the Google Cloud console, click the email address for the service account that you created.
- Click Keys.
- Click Add key, and then click Create new key.
- Click Create. A JSON key file is downloaded to your computer.
- Click Close.
Después de crear la cuenta de servicio, asegúrate de subir su archivo de claves JSON a una ubicación segura en el servidor de la solución Bare Metal que sea accesible para el agente.
Habilita funciones
Una vez que configures una cuenta de servicio para tu solución Bare Metal y le otorgues las funciones necesarias, puedes habilitar otras funciones del agente de Google Cloud para SAP mediante las siguientes opciones de configuración:
- Configure la recopilación de métricas de Process Monitoring
- Configura la recopilación de métricas de evaluación Workload Manager
- Configura la recopilación de métricas de supervisión de SAP HANA.
- Configura la copia de seguridad y recuperación basadas en Backint para SAP HANA.
Archivo de configuración predeterminada
El siguiente fragmento es un ejemplo de la configuración predeterminada de la versión 3.2 (más reciente) del agente de Google Cloud para SAP:
{ "provide_sap_host_agent_metrics": true, "bare_metal": true, "log_level": "INFO", "log_to_cloud": true, "collection_configuration": { "collect_workload_validation_metrics": true, "collect_process_metrics": false }, "discovery_configuration": { "enable_discovery": true }, "hana_monitoring_configuration": { "enabled": false } }
Para ver los archivos de configuración de ejemplo específicos de la función, consulta la guía de configuración para esa función.
Parámetros de configuración
En la siguiente tabla, se describen los parámetros de configuración del agente de Google Cloud para SAP que se ejecuta en un servidor de la solución Bare Metal, incluidos los parámetros relacionados con la recopilación de métricas. Para obtener información sobre los parámetros de configuración relacionados con la función de Backint del agente, consulta Parámetros de configuración.
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 de Google Cloud que usas con la solución Bare Metal. |
cloud_properties.instance_name
|
Especifica el nombre del servidor de la solución Bare Metal en el que instalaste el agente. |
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 VM, de forma predeterminada, usa la zona de la instancia de VM en la que está instalado el agente. |
cloud_properties.image |
Especifica el nombre de la imagen de SO de la instancia. |
cloud_properties.numeric_project_id |
El ID numérico del proyecto de Google Cloud 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_process_metrics |
Para habilitar la recopilación de métricas de supervisión, especifica |
collection_configuration.process_metrics_frequency |
A partir de la versión 2.6, este parámetro determina la frecuencia de recopilación de las métricas de Process Monitoring que cambian rápidamente, en segundos. Las métricas de Process Monitoring que cambian rápidamente son: El valor predeterminado para este parámetro es Todas las demás métricas (de cambio lento) de Monitoring se recopilan con una frecuencia predeterminada de 30 segundos. Para cambiar la frecuencia de recopilación de las métricas de Process Monitoring que cambian lentamente, usa el parámetro |
collection_configuration.slow_process_metrics_frequency |
Especifica la frecuencia de recopilación de las métricas de Process Monitoring que cambian lentamente, en segundos. El valor predeterminado para este parámetro es |
collection_configuration.process_metrics_to_skip |
Especifica las métricas de Process Monitoring que no quieres que recopile el agente. Este parámetro acepta un valor separado por comas de los nombres de las métricas de Process Monitoring. Por ejemplo: |
collection_configuration.hana_metrics_config.hana_db_user |
Especifica la cuenta de usuario de la base de datos que el agente usa para consultar SAP HANA. El valor predeterminado es |
collection_configuration.hana_metrics_config.hana_db_password |
Especifica la contraseña de texto sin formato para la cuenta de usuario de la base de datos que el agente usa a fin de consultar SAP HANA. |
collection_configuration.hana_metrics_config.hana_db_password_secret_name |
A fin de proporcionar de forma segura la contraseña de la cuenta de usuario de la base de datos que el agente usa para consultar SAP HANA, especifica el nombre del secreto que contiene las credenciales de seguridad de la cuenta de usuario de la base de datos. Las métricas relacionadas con SAP HANA se recopilan solo si se configura |
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_secret_name |
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 |
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 |
hana_monitoring_configuration.enabled |
Opcional. Si deseas habilitar el agente de Google Cloud para SAP a fin de recopilar las métricas de supervisión de SAP HANA, especifica hana_monitoring_configuration.enabled: true .
|
hana_monitoring_configuration.sample_interval_sec |
Opcional. Especifica el intervalo de muestra, en segundos, que determina la frecuencia con la que el agente de Google Cloud para SAP consulta tus instancias de SAP HANA para recopilar las métricas de supervisión de SAP HANA. El valor predeterminado es 300 segundos. Para cada consulta definida en el archivo de configuración del agente de Google Cloud para SAP, puedes reemplazar el intervalo de muestra global si especificas el intervalo requerido en el parámetro |
hana_monitoring_configuration.query_timeout_sec |
Opcional. Especifica el tiempo de espera para cada consulta realizada a las instancias de SAP HANA. El valor predeterminado es 300 segundos. |
hana_monitoring_configuration.execution_threads |
Opcional. Especifica la cantidad de subprocesos que se usan para enviar consultas a las instancias de SAP HANA. Cada consulta se ejecuta en su propio subproceso. El valor predeterminado es 10. |
hana_monitoring_configuration.hana_instances.name |
Especifica el identificador de nombre para tu instancia de SAP HANA. |
hana_monitoring_configuration.hana_instances.sid |
Especifica el SID de tu instancia de SAP HANA. Esta string se agrega como una etiqueta a todas las métricas resultantes de la consulta de tus instancias de SAP HANA. |
hana_monitoring_configuration.hana_instances.host |
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:
|
hana_monitoring_configuration.hana_instances.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 |
hana_monitoring_configuration.hana_instances.user |
Especifica la cuenta de usuario que se usa para consultar la instancia de SAP HANA. |
hana_monitoring_configuration.hana_instances.password |
Opcional. Especifica la contraseña, como texto sin formato, que autentica la cuenta de usuario para consultar la instancia de SAP HANA. Para habilitar la autenticación, debes especificar una de las siguientes opciones:
Si usas ambos parámetros, se usa el parámetro |
hana_monitoring_configuration.hana_instances.secret_name |
Opcional. Especifica el nombre del secreto en Secret Manager que almacena la contraseña de la cuenta de usuario. |
hana_monitoring_configuration.hana_instances.enable_ssl |
Opcional. Especifica si SSL está habilitado en tu instancia de SAP HANA. El valor predeterminado es |
hana_monitoring_configuration.hana_instances.host_name_in_certificate |
Si especificas |
hana_monitoring_configuration.hana_instances.tls_root_ca_file |
Si especificas |
hana_monitoring_configuration.queries.enabled |
Opcional. A fin de habilitar una consulta en SQL para todas tus instancias de SAP HANA, especifica el valor |
hana_monitoring_configuration.queries.name |
Si definiste consultas personalizadas en tu archivo de configuración, debes especificar un nombre único para cada consulta personalizada. El nombre de la consulta debe ser único, ya que se usa para compilar la URL predeterminada de la métrica en Monitoring. |
hana_monitoring_configuration.queries.sql |
Especifica la instrucción de SQL que el agente emite a tus instancias de SAP HANA. La instrucción de SQL debe cumplir con la sintaxis de SQL definida por SAP en SAP HANA SQL and System Views Reference. |
hana_monitoring_configuration.queries.sample_interval_sec |
Opcional. Especifica el intervalo de muestra para la consulta de SQL. Esto anula el intervalo de muestra global. El valor debe ser de 5 segundos o más. |
hana_monitoring_configuration.queries.columns.name |
Especifica un nombre que identifique de forma única cada columna. El nombre de columna debe ser único porque se usa para compilar la URL predeterminada de la métrica en Monitoring. |
hana_monitoring_configuration.queries.columns.metric_type |
Para el manejo mediante Monitoring, especifica uno de los siguientes tipos de métricas: Las métricas de tipo |
hana_monitoring_configuration.queries.columns.value_type |
Para el control de Monitoring, especifica un tipo de datos que sea compatible con el tipo de métrica. Los tipos de datos compatibles son los siguientes: |
hana_monitoring_configuration.queries.columns.name_override |
Opcional. Para el manejo mediante Monitoring, especifica la ruta de acceso que deseas mostrar en la URL de la métrica en lugar de los nombres de columna y consulta. Por ejemplo:
|
Soluciona problemas
Si deseas obtener información sobre el diagnóstico y la resolución de problemas que puedes encontrar cuando instalas y configuras el agente de Google Cloud para SAP, consulta Guía de solución de problemas del Agente de Google Cloud para SAP.
Obtenga asistencia
Si necesitas ayuda para resolver problemas con el agente de Google Cloud para SAP, recopila toda la información de diagnóstico disponible y comunícate con Atención al cliente de Cloud. Si deseas obtener más información para comunicarte con el equipo de Atención al cliente de Cloud, consulta Obtén asistencia para SAP en Google Cloud.