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

El agente deGoogle Cloudpara SAP proporciona asistencia para supervisar tus 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 a SAP Host Agent. Para obtener más información, consulta la Nota SAP 2469354.

Para recopilar las métricas de infraestructura y aplicaciones subyacentes que se usan para la observabilidad, debes habilitar funciones adicionales para el agente de 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 desees supervisar.
El agente para SAP se empaqueta con las siguientes imágenes de SO públicas “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 ya se instaló, te recomendamos que lo actualices a la versión más reciente.

Para ver las anotaciones de los casos de eventos predefinidos de SAP, necesitas la versión 3.7 o posterior del agente.

Si deseas obtener más información, consulta Actualiza el agente de Google Cloud para SAP. Google Cloud
Habilita la función de descubrimiento del sistema 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 detección 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 supervisión de procesos 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 Process Monitoring.
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 de la instancia de HANA, el SID, el host, el puerto, el usuario y la contraseña (ya sea con Secret o con 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.

Si deseas 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 Valida la configuración de la observabilidad de Workload Manager.
Cómo reiniciar el agente para SAP		 Reinicia el agente para que los cambios surtan efecto ejecutando el siguiente comando: 
         sudo systemctl restart google-cloud-sap-agent

Para obtener más información, consulta Reinicia el agente.

Valida la configuración de la observabilidad de Workload Manager

Para validar si tienes la configuración Google Cloud correcta para usar el servicio de observabilidad de Workload Manager, ejecuta el comandostatusdel 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 configuración de Google Cloud para usar el servicio de observabilidad de Workload Manager es correcta, el resultado incluirá lo siguiente. Es posible que tu configuración tenga 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:      30    (default)
        process_metrics_to_skip:        []   (default)
        slow_process_metrics_frequency: 120   (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 alguna 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 habilites las funciones de observabilidad, el archivo de configuración del agente de 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?