Guía de operaciones del Agente de Google Cloud para SAP

En esta guía, se abordan las consideraciones operativas y los procedimientos para ejecutar la versión 3.2 (más reciente) del agente de Google Cloud para SAP en instancias de VM de Compute Engine y servidores de la solución Bare Metal.

Comprende el ciclo de vida del agente

Cuando administras las operaciones del agente de Google Cloud para SAP, es útil comprender lo que hace el agente. En general, funciona de la siguiente manera:

Debes instalar el agente de Google Cloud para SAP en cada instancia de VM de Compute Engine o servidor de solución Bare Metal que aloja sistemas SAP. El agente se ejecuta como un servicio de Linux o Windows.
En las instancias de VM de Compute Engine, el agente combina los datos de supervisión de Monitoring y las APIs de Compute Engine.
En los servidores de la solución Bare Metal, el agente no accede a las APIs de Google Cloud para recopilar solo las métricas de SAP Host Agent.
SAP Host Agent solicita al agente de Google Cloud para SAP sus datos almacenados en caché a través de HTTP. Agrega las métricas de SAP Host Agent, las informa y las almacena en la base de datos de SAP NetWeaver.
La transacción ST06 de SAP o la interfaz de línea de comandos saposcol muestran las métricas agregadas de SAP Host Agent.
Puedes ver las métricas de SAP Host Agent del agente de Google Cloud para SAP si ejecutas un comando en una ventana de la terminal.

Verifica que el agente esté en ejecución

Después de instalar o reiniciar el agente, puedes verificar que el agente se ejecute como se espera.

Para verificar si el agente está en ejecución, sigue estos pasos:

Linux

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

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

Windows

Usa RDP para conectarte a la instancia de VM.
Como administrador, ejecuta el siguiente comando desde PowerShell:
```
$(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
```
Si el agente está en ejecución, el estado muestra Running.

Si el agente de Google Cloud para SAP no está en ejecución, reinicia el agente.

Verifica la versión del agente

Después de instalar o reiniciar el agente de Google Cloud para SAP, puedes verificar la versión del agente.

Para ver la versión de tu agente, completa los siguientes pasos:

Linux

Para RHEL, sigue estos pasos:

Usa SSH para conectarte a la máquina anfitrión.
Ejecuta el siguiente comando:
```
yum info google-cloud-sap-agent
```

Para SLES, sigue estos pasos:

Usa SSH para conectarte a la máquina anfitrión.
Ejecuta el siguiente comando:
```
zypper info google-cloud-sap-agent
```

Windows

Usa RDP para conectarte a la máquina anfitrión.
Como administrador, ejecuta el siguiente comando desde PowerShell:
```
googet installed google-cloud-sap-agent
```

Obtén una lista de todas las versiones disponibles del agente

Si deseas obtener una lista de todas las versiones disponibles del agente de Google Cloud para SAP, haz lo siguiente:

RHEL

Establece una conexión SSH con tu host.

Ejecuta el siguiente comando:

sudo yum list --showduplicates google-cloud-sap-agent

SLES

Establece una conexión SSH con tu host.

Ejecuta el siguiente comando:

sudo zypper search -s -t package -r google-cloud-sap-agent google-cloud-sap-agent

Verifica que SAP Host Agent 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

Visualiza las métricas de SAP Host Agent

Después de instalar o actualizar la configuración del agente de Google Cloud para SAP, puedes ver las métricas recopiladas de SAP Host Agent.

Si deseas ver las métricas de SAP Host Agent que recopila el agente de Google Cloud para SAP, sigue estos pasos:

Linux

Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.

Ejecuta el siguiente comando:

curl http://localhost:18181

Si las métricas están disponibles, deberías recibir un resultado XML que contenga información sobre tu sistema. Por ejemplo:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <metrics>
  <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422670" refresh-interval="60">
  <name>VM Processing Power Consumption</name>
  <value>0.0</value>
  </metric>

Windows

Usa RDP para conectarte a la instancia de VM.

Como administrador, ejecuta el siguiente comando desde PowerShell:

(Invoke-WebRequest -Uri 'http://localhost:18181').RawContent

Si las métricas están disponibles, deberías ver un resultado de XML que contenga información sobre tu sistema. Por ejemplo:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
  <metrics>
  <metric category="cpu" context="vm" type="double" unit="Percent" last-refresh="1670422528" refresh-interval="60">
  <name>VM Processing Power Consumption</name>
  <value>10.0</value>
  </metric>

Visualiza las otras métricas

Después de actualizar la configuración del agente de Google Cloud para SAP con el fin de recopilar las métricas de Process Monitoring o las métricas de supervisión de SAP HANA, recomendamos verlas para verificar que el agente esté recopilando las métricas como se esperaba.

Si completas estos pasos, puedes ver las métricas y la información que recopila el agente de Google Cloud para SAP en Cloud Monitoring:

En la consola de Google Cloud, ve a la página Explorador de métricas de Cloud Monitoring.

Ir al Explorador de métricas
Selecciona la pestaña Configuración.
Expande el menú Seleccionar una métrica.
En el menú Recursos activos, selecciona Instancia de VM.
En el menú Categoría de métrica, selecciona sap.
En el menú Métrica, selecciona metric: workload.googleapis.com/sap/service/active o cualquiera de las métricas nuevas para representar.
Haz clic en Aplicar.

Deberías ver un gráfico con los valores de la métrica de series temporales.

Valida la función de Backint

Después de habilitar la función de Backint del agente, debes validarla mediante la creación y el restablecimiento de una copia de seguridad.

Para obtener instrucciones, consulta Valida la copia de seguridad y recuperación.

Reinicia el agente

Si el agente de Google Cloud para SAP deja de funcionar o actualizas su configuración, reinicia el agente.

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

Linux

Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.

Ejecuta el siguiente comando:

sudo systemctl restart google-cloud-sap-agent

Windows

Establece una conexión RDP con la VM del host.
Como administrador, ejecuta el siguiente comando desde PowerShell:
```
Restart-Service -Name 'google-cloud-sap-agent' -Force
```

Actualiza al agente de Google Cloud para SAP desde otros agentes de Google Cloud

El agente de Google Cloud para SAP es el sucesor de otros agentes de Google Cloud. En las siguientes secciones, se proporciona información para actualizar de estos agentes a la versión 3.2 (más reciente) del agente de Google Cloud para SAP.

Si quieres obtener instrucciones para instalar y configurar el agente de Google Cloud para SAP, consulta la Guía de instalación y configuración del agente de Google Cloud para SAP.

Actualiza desde el agente de Backint de Cloud Storage para SAP HANA

Para actualizar el agente de Backint de Cloud Storage para SAP HANA a la versión 3.2 (más reciente), completa los siguientes pasos:

Asegúrate de que no haya copias de seguridad de datos en curso ni programadas para el período que se superpone con la actualización.
Para inhabilitar las copias de seguridad automáticas de registros, establece el parámetro enable_auto_log_backup de SAP HANA en no. Para obtener instrucciones, consulta el documento de SAP HANA Enable and Disable Automatic Log Backup.
Instala el agente de Google Cloud para SAP Para obtener instrucciones, consulta la guía de instalación de tu situación.
Habilita la función de Backint del agente de Google Cloud para SAP. Para obtener instrucciones, consulta Configura la copia de seguridad y recuperación basadas en Backint.

Si habilitas la función de Backint del agente de Google Cloud para SAP, se detecta de forma automática el agente de Backint en tu host y lo inhabilita desde la máquina anfitriona.
Para crear una versión JSON de tu archivo de texto de configuración de Backint existente, ejecuta el siguiente comando para cada uno de tus archivos de texto:
```
/usr/bin/google_cloud_sap_agent configurebackint -f=PATH_TO_PARAMETERS_FILE
```
Reemplaza PATH_TO_PARAMETERS_FILE por la ruta de acceso a tu archivo PARAMETERS.txt.

Los archivos JSON se crean en la misma ubicación del sistema de archivos que los archivos de texto, siempre que el agente de Google Cloud para SAP tenga permiso para acceder a esas ubicaciones. Si bien el agente de Google Cloud para SAP puede interpretar los parámetros relacionados de Backint especificados en el archivo de texto, te recomendamos que uses los archivos JSON para actualizar cualquier configuración.
Para habilitar las copias de seguridad automáticas de registros, establece el parámetro enable_auto_log_backup de SAP HANA en yes. Para obtener instrucciones, consulta el documento de SAP HANA Enable and Disable Automatic Log Backup.
Valida la copia de seguridad y la recuperación.

Cuando realizas esta actualización, sucede lo siguiente:

Para fines de copia de seguridad y referencia, todos los archivos de instalación en el directorio backint-gcs del agente de Backint se copian en backint-gcs-old-TIMESTAMP/. Estos son obligatorios en caso de que necesites volver a usar el agente de Backint.
La carpeta backint-gcs se limpia luego para que contenga solo los archivos necesarios a fin de ejecutar el agente de Google Cloud para SAP, que incluye su archivo de configuración, parameters.json, y los archivos de configuración de Backint, comoPARAMETERS.txt.

Si quieres obtener información sobre la asignación de los parámetros de configuración entre el agente de Backint y el agente de Google Cloud para SAP, expande la siguiente sección.

Asignación de parámetros de configuración

Nombre del parámetro en el agente de Backint	Nombre del parámetro en el agente de Google Cloud para SAP
`BUCKET`	`bucket`
`DISABLE_COMPRESSION`	`compress`
`ENCRYPTION_KEY`	`encryption_key`
`KMS_KEY_NAME`	`kms_key`
`MAX_GCS_RETRY`	`retries`
`PARALLEL_FACTOR`	`parallel_streams`
`PARALLEL_PART_SIZE`	Esto no está disponible en el agente de Google Cloud para SAP.
`RATE_LIMIT_MB`	`rate_limit_mb`
`SERVICE_ACCOUNT`	`service_account_key`
`THREADS`	`thread`
`READ_IDLE_TIMEOUT`	`file_read_timeout_ms`
`CHUNK_SIZE_MB`	`buffer_size_mb`
`HTTP_READ_TIMEOUT`	Esto no está disponible en el agente de Google Cloud para SAP.

Actualiza desde el agente de supervisión para SAP HANA

Cuando se instala la versión 3.2 (más reciente) del agente de Google Cloud para SAP, se detectan automáticamente las versiones del agente de supervisión para SAP HANA, se inhabilitan y, luego, quitan de tus máquinas anfitrión durante la instalación.

Si se detecta este agente, su configuración se migra al agente de Google Cloud para SAP durante la instalación. Con fines de copia de seguridad y referencia, la configuración del agente de supervisión para SAP HANA se copia en el siguiente archivo:

/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml

Actualiza instancias habilitadas para SSL

Si configuraste el agente de supervisión para SAP HANA a fin de usar certificados SSL para comunicarse con tus instancias de SAP HANA, cuando instales el agente de Google Cloud para SAP, toda la configuración de supervisión de SAP HANA, excepto la configuración de SSL, se migra al agente de Google Cloud para SAP. En ese caso, debes usar el agente de Google Cloud para SAP a fin de supervisar tus instancias de SAP HANA, debes completar los siguientes pasos:

Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.
Abre el archivo de configuración del agente de Google Cloud para SAP:
```
/etc/google-cloud-sap-agent/configuration.json
```
En la sección hana_monitoring_configuration, configura el parámetro enabled como true.
En la sección hana_monitoring_configuration.hana_instances, realiza lo siguiente para cada instancia de SAP HANA que usa el protocolo TLS/SSL a fin de lograr una comunicación segura:
1. Especifica el parámetro enable_ssl y establece su valor en true.
2. Especifica el parámetro host_name_in_certificate y establece el nombre de host de SAP HANA, como se especifica en el certificado TLS/SSL, como su valor.
3. Especifica el parámetro tls_root_ca_file y establece la ruta de acceso, en la que se almacena el certificado TLS/SSL, como su valor.
Guarda el archivo de configuración.
Reinicia el agente para que se aplique la configuración nueva:
```
sudo systemctl restart google-cloud-sap-agent
```
Verifica que el agente recopile las métricas de supervisión de SAP HANA. Para obtener instrucciones, consulta Visualiza las otras métricas.
Desinstala el agente de supervisión para SAP HANA.

Si tienes problemas de conexión con tus instancias de SAP HANA después de esta actualización, puedes ver los registros del agente en Logging y usar la guía de solución de problemas para resolver el problema.

Actualiza desde el agente de supervisión para SAP NetWeaver

La instalación de la versión 3.2 (más reciente) del agente de Google Cloud para SAP detecta automáticamente las versiones del agente de supervisión para SAP NetWeaver.

Si se detecta este agente, su configuración se migra al agente de Google Cloud para SAP durante la instalación.

Actualiza el agente de Google Cloud para SAP

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.

Comprueba actualizaciones

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

RHEL

Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.

Ejecuta el siguiente comando:

sudo yum check-update google-cloud-sap-agent

SLES

Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.

Ejecuta el siguiente comando:

sudo zypper list-updates -r google-cloud-sap-agent

Windows

Establece una conexión RDP con la VM del host.
Como administrador, ejecuta el siguiente comando desde PowerShell:
```
googet latest google-cloud-sap-agent
```

Instala una actualización

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

RHEL

Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.
Actualiza la instancia del agente:
- (Recomendado) Para actualizar a la versión 3.2 (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

Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.
Actualiza la instancia del agente:
- (Recomendado) Para actualizar a la versión 3.2 (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.

Windows

Establece una conexión RDP con la VM del host.
Para actualizar a la versión 3.2 (más reciente) del agente, como administrador, ejecuta el siguiente comando desde PowerShell:
```
googet install google-cloud-sap-agent
```

Revierte al uso de los otros agentes de Google Cloud

En esta sección, se proporciona información sobre cómo revertir el uso de la versión 3.2 (más reciente) del agente de Google Cloud para SAP y el uso de sus agentes antecesores.

Revierte al uso del agente de Backint

Si deseas revertir al agente de Backint y dejar de usar la función de Backint del agente de Google Cloud para SAP, sigue estos pasos:

Borra todos los archivos relacionados con la función de Backint del agente de Google Cloud para SAP:
```
rm -r /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs
```
Reemplaza SID por el SID de tu sistema SAP.
Restablece los archivos del agente de Backint que se almacenaron como una copia de seguridad cuando actualizaste al agente de Google Cloud para SAP. Para ello, cópialos en el directorio backint-gcs:
```
cp -r /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs-old-TIMESTAMP /usr/sap/SID/SYS/global/hdb/opt/backint/backint-gcs
```
Reemplaza lo siguiente:
- SID: el SID de tu sistema SAP
- TIMESTAMP: el valor de marca de tiempo en el nombre de la carpeta que se creó cuando actualizaste del agente de Backint al agente de Google Cloud para SAP.
Usa SAP HANA Studio o SAP HANA Cockpit para editar el archivo global.ini y actualiza las rutas de acceso a los archivos de configuración .txt. Si deseas obtener información sobre los parámetros para los que debes especificar la ruta de acceso a los archivos .txt, consulta Configura SAP HANA para la función de Backint.
Guarda los cambios que realizaste en el archivo global.ini.

Revierte al uso del agente de supervisión para SAP HANA

Si deseas revertir al uso del agente de supervisión para SAP HANA y dejar de usar la función de supervisión de SAP HANA del agente de Google Cloud para SAP, sigue estos pasos:

RHEL

Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.
Para evitar la recopilación de métricas duplicadas, inhabilita la recopilación de métricas de supervisión de SAP HANA del agente de Google Cloud para SAP:
1. Abre el archivo de configuración del agente de Google Cloud para SAP:
```
/etc/google-cloud-sap-agent/configuration.json
```
2. En la sección hana_monitoring_configuration, configura el parámetro enabled como false.
3. Guarda el archivo de configuración.
4. Reinicia el agente para que se aplique la configuración nueva:
```
sudo systemctl restart google-cloud-sap-agent
```
Copia la configuración del agente de supervisión para SAP HANA desde el siguiente archivo:
```
/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml
```
Instala el agente de supervisión para SAP HANA versión 2. Si deseas obtener instrucciones de instalación, consulta la guía de instalación y operación del agente de supervisión para SAP HANA V2.0.
En el siguiente archivo, pega la configuración del agente de supervisión para SAP HANA que copiaste en un paso anterior:
```
/usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml
```

Reinicia el agente de supervisión para SAP HANA:

sudo systemctl start google-saphanamonitoring-agent

SLES

Establece una conexión SSH con la instancia de VM del host del servidor de la solución Bare Metal.
Para evitar la recopilación de métricas duplicadas, inhabilita la recopilación de métricas de supervisión de SAP HANA del agente de Google Cloud para SAP:
1. Abre el archivo de configuración del agente de Google Cloud para SAP:
```
/etc/google-cloud-sap-agent/configuration.json
```
2. En la sección hana_monitoring_configuration, configura el parámetro enabled como false.
3. Guarda el archivo de configuración.
4. Reinicia el agente para que se aplique la configuración nueva:
```
sudo systemctl restart google-cloud-sap-agent
```
Copia la configuración del agente de supervisión para SAP HANA desde el siguiente archivo:
```
/etc/google-cloud-sap-agent/backup-of-hanamonitoring-configuration.yaml
```
Instala el agente de supervisión para SAP HANA versión 2. Si deseas obtener instrucciones de instalación, consulta la guía de instalación y operación del agente de supervisión para SAP HANA V2.0.
En el siguiente archivo, pega la configuración del agente de supervisión para SAP HANA que copiaste en un paso anterior:
```
/usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml
```

Reinicia el agente de supervisión para SAP HANA:

sudo systemctl start google-saphanamonitoring-agent

Desinstala el agente

Para desinstalar o quitar el agente del host, sigue estos pasos:

RHEL

Establece una conexión SSH con tu host.
Ejecuta el siguiente comando:
```
sudo yum remove google-cloud-sap-agent
```

SLES

Establece una conexión SSH con tu host.

Ejecuta el siguiente comando:

sudo zypper remove google-cloud-sap-agent

Windows

Establece una conexión RDP con la VM del host.
Como administrador, ejecuta el siguiente comando desde PowerShell:
```
Remove-Service -Name 'google-cloud-sap-agent'
```

Visualiza los registros del agente en Cloud Logging

De forma predeterminada, los registros para el agente de Google Cloud para SAP se redireccionan de tus instancias de VM y los servidores de la solución Bare Metal a Cloud Logging.

Para ver los registros del agente en Logging, sigue estos pasos:

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

Ir al Explorador de registros
Ve al panel Consulta.
En el menú desplegable Recursos, selecciona Global y, luego, haz clic en Aplicar.
En el Editor de consultas, ingresa google-cloud-sap-agent.
Haz clic en Ejecutar consulta.

Deberías ver los registros que generaron las instancias de agente que se ejecutan en todas tus instancias de VM o servidores de la solución Bare Metal. Para filtrar los registros de una máquina específica, usa los filtros disponibles en la interfaz.

Puedes inhabilitar el redireccionamiento predeterminado de los registros del agente que se relacionan con la recopilación de métricas. Para ello, completa los siguientes pasos:

Establece una conexión SSH con la instancia de VM del host o el servidor de la solución Bare Metal.

Abre el siguiente archivo de configuración:

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

Para el parámetro log_to_cloud, actualiza el valor a false.
Guarda el archivo de configuración.
Reinicia el agente para que se aplique este cambio.

Para inhabilitar el redireccionamiento predeterminado de los registros relacionados con la función de Backint del agente de Google Cloud para SAP, edita tu archivo de configuración de Backint y configura el parámetro log_to_cloud como false