Configurar el agente de SAP para recoger métricas

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

Para recoger las métricas de la infraestructura y las aplicaciones subyacentes que se usan para la observabilidad, debe habilitar funciones adicionales en el agente para SAP.

En este documento se describe cómo habilitar estas funciones en Agent for SAP.

Lista de comprobación del agente de SAP

La siguiente lista de comprobación resume las tareas que debe realizar para asegurarse de que el agente de SAP esté configurado correctamente para la observabilidad:

Instalar y configurar el agente para SAP		 Instala y configura el agente de SAP Google Clouden cada máquina virtual de Compute Engine que quieras monitorizar.
El agente de SAP se incluye en los siguientes SO públicos "para SAP":
  • RHEL: todas las imágenes "for SAP"
  • SLES: SLES 15 SP4 para SAP y versiones posteriores

Para obtener más información, consulta Instalar y configurar el agente para SAP en una VM.
Update Agent para SAP		 La versión 3.5 del agente de SAP contiene todas las funciones necesarias para configurar la observabilidad de SAP. Si el agente ya estaba instalado, te recomendamos que lo actualices a la versión más reciente.

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

Para obtener más información, consulta el agente de Google Cloudpara SAP.
Habilitar la función de descubrimiento del sistema de Agent for SAP		 En el archivo de configuración del agente, los siguientes parámetros deben tener el valor true. Si instalaste el agente después del 14 de febrero del 2024, estas marcas están definidas como true de forma predeterminada y no es necesario hacer ningún cambio.
  • discovery_configuration.enable_workload_discovery
  • discovery_configuration.enable_discovery
Si instalaste el agente antes del 14 de febrero del 2024 o has inhabilitado 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 Configurar el agente de Google Cloudpara SAP.
Habilitar la recogida de métricas de monitorización de procesos del agente para SAP		 En el archivo de configuración del agente, el parámetro collection_configuration.collect_process_metrics debe tener el valor 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 el artículo Configurar la recogida de métricas de monitorización de procesos.
Habilitar la recogida de métricas de monitorización de SAP HANA para el agente		 En las VMs de HANA, debes habilitar la recogida de métricas de monitorizació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 del archivo de configuración del agente para indicar 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.

Para obtener más información, consulta Configurar la recogida de métricas de monitorización de SAP HANA.
Validar la configuración y la Google Cloud configuración del agente		 Para comprobar que el agente está configurado correctamente, ejecuta el siguiente comando: 
         sudo /usr/bin/google_cloud_sap_agent status

Para obtener más información, consulta Validar la configuración de la observabilidad de Gestor de cargas de trabajo.
Restart Agent para SAP		 Para que los cambios se apliquen, reinicia el agente ejecutando el siguiente comando: 
         sudo systemctl restart google-cloud-sap-agent

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

Validar la configuración de la observabilidad de Workload Manager

Para comprobar si tiene la Google Cloud configuración correcta para usar el servicio de observabilidad de Workload Manager, ejecute el comando statusdel agente. Este comando es compatible con la versión 3.7 del agente.

Para validar la configuración de Google Cloud , sigue estos 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, la salida incluye 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 vuelve a ejecutar el comando status para volver a validar la configuración.

Ejemplo de archivo de configuración

Una vez que haya habilitado las funciones de observabilidad, el archivo de configuración del agente para SAP tendrá un aspecto 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"
        }
      ]
    }
  }

Siguientes pasos