Configura el agente para SAP para la recopilación de métricas

El Agente deGoogle Cloudpara SAP proporciona asistencia para supervisar las cargas de trabajo de SAP que se ejecutan en instancias de Compute Engine y te ayuda a ejecutar sistemas SAP de manera eficiente en Google Cloud. Debes instalar el agente de Google Cloudpara SAP en todas las VMs que ejecuten cualquier sistema SAP. Este agente recopila y envía toda la información requerida que SAP exige al agente de host de SAP. Para obtener más información, consulta SAP Note 2469354.

Para recopilar las métricas de infraestructura y aplicación subyacentes que se usan para la observabilidad, debes habilitar funciones adicionales para el agente para SAP.

En este documento, se describe cómo habilitar estas funciones en el Agente para SAP.

Lista de tareas del Agente para SAP

En la siguiente lista de tareas, se resumen las tareas que debes realizar para asegurarte de que el agente para SAP esté configurado correctamente para la observabilidad:

Instala y configura el Agente para SAP		 Instala y configura el Agente de Google Cloudpara SAP en cada VM de Compute Engine que quieras supervisar.
El agente para SAP se empaqueta con las siguientes imágenes públicas de SO “para SAP”:
  • RHEL: todas las imágenes “para SAP”
  • SLES: SLES 15 SP4 para SAP y versiones posteriores

Para obtener más información, consulta Instala y configura el agente para SAP en una VM.
Actualiza el agente para SAP		 La versión 3.5 del agente para SAP contiene todas las funciones necesarias para configurar la observabilidad de SAP. Si el agente se instaló anteriormente, te recomendamos que lo actualices a la versión más reciente.

Para obtener más información, consulta Actualiza el agente de Google Cloudpara SAP.
Habilita la función de descubrimiento de sistemas del agente para SAP		 En el archivo de configuración del agente, los siguientes parámetros deben establecerse en true. Si instalaste el agente después del 14 de febrero de 2024, estas marcas se establecen en true de forma predeterminada y no es necesario realizar ningún cambio.
  • discovery_configuration.enable_workload_discovery
  • discovery_configuration.enable_discovery
Si instalaste el agente antes del 14 de febrero de 2024 o si inhabilitaste la función de descubrimiento del sistema, ejecuta los siguientes comandos:
         sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -enable 

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

Para obtener más información, consulta Configura el agente de Google Cloudpara SAP.
Habilita la recopilación de métricas de Process Monitoring del agente para SAP		 En el archivo de configuración del agente, el parámetro collection_configuration.collect_process_metrics debe establecerse en true. Para habilitar la función, ejecuta el siguiente comando: 
         sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable

Para obtener más información, consulta Configura la recopilación de métricas de supervisión de procesos.
Habilita la recopilación de métricas de supervisión de HANA del agente para SAP		 En las VMs de HANA, debes habilitar la recopilación de métricas de supervisión de procesos de HANA. Para habilitar esta función, ejecuta el siguiente comando: 
         sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable

Edita la sección hana_monitoring_configuration en el archivo de configuración del agente para proporcionar el nombre, el SID, el host, el puerto, el usuario y la contraseña de la instancia de HANA (ya sea con un secreto o una clave hdbuserstore).

Ten en cuenta que el usuario de HANA especificado debe tener acceso de lectura a las tablas que consultan las consultas predeterminadas.

Para obtener más información, consulta Configura la recopilación de métricas de SAP HANA Monitoring.
Valida la configuración del agente y la Google Cloud configuración		 Ejecuta el siguiente comando para verificar que el agente esté configurado correctamente: 
         sudo /usr/bin/google_cloud_sap_agent status

Para obtener más información, consulta Cómo validar la configuración de la observabilidad de Workload Manager.
Cómo reiniciar el agente para SAP		 Ejecuta el siguiente comando para reiniciar el agente y que se apliquen los cambios: 
         sudo systemctl restart google-cloud-sap-agent

Para obtener más información, consulta Cómo reiniciar el agente.

Valida la configuración de la observabilidad de Workload Manager

Para validar si tienes la configuración correcta de Google Cloud para usar el servicio de observabilidad de Workload Manager, 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:

  1. Establece una conexión SSH con tu instancia de Compute Engine.

  2. Ejecuta el siguiente comando:

    sudo /usr/bin/google_cloud_sap_agent status

    Si la Google Cloud configuración para usar el servicio de observabilidad de Workload Manager es correcta, el resultado incluirá lo siguiente. Tu configuración puede tener valores distintos de los de default.

    Agent Status:
    Installed version: 3.7-....
    ...
    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
...
----------------------------------------------------------------------------
Process Metrics: Enabled
    Status: Fully Functional
    IAM Permissions: All granted
    Configuration:
        collect_process_metrics:        true (configuration file)
        process_metrics_frequency:      5    (default)
        process_metrics_to_skip:        []   (default)
        slow_process_metrics_frequency: 30   (default)
...
----------------------------------------------------------------------------
HANA Monitoring Metrics: Enabled
    Status: Fully Functional
    IAM Permissions: All granted
    Configuration:
        connection_timeout:       120   (default)
        enabled:                  true  (configuration file)
        execution_threads:        10    (default)
        max_connect_retries:      1     (default)
        query_timeout_sec:        300   (default)
        sample_interval_sec:      300   (default)
        send_query_response_time: false (default)
...
----------------------------------------------------------------------------
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)
...

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

Archivo de configuración de ejemplo

Una vez que hayas habilitado las funciones de visibilidad, el archivo de configuración del agente para SAP será similar al siguiente:

  {
    "provide_sap_host_agent_metrics": true,
    "bare_metal": false,
    "log_level": "INFO",
    "log_to_cloud": true,
    "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "collect_process_metrics": true
  },
  "discovery_configuration": {
     "enable_workload_discovery": true,
     "enable_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": true,
    "hana_instances": [
      {
        "name": "local",
        "sid": "DEH",
        "host": "localhost",
        "port": "30015",
        "user": "system",
        "secret_name": "password-secret-name"
      },
    ],
   }
  }

¿Qué sigue?