Configura el agente para SAP para establecer la observabilidad

En este documento, se describe cómo configurar el agente de Google Cloudpara SAP y, así, establecer la observabilidad de tu carga de trabajo de SAP con Workload Manager.

El servicio de observabilidad de Workload Manager necesita que el agente recopile métricas de tu carga de trabajo de SAP y la infraestructura subyacente. Para obtener más información, consulta la descripción general de la observabilidad de SAP.

Antes de comenzar

Configura el agente para una carga de trabajo de una sola zona

Gestor de extensiones de VM

Para configurar y administrar el agente en una flota de instancias de Compute Engine, debes crear una política del Administrador de extensiones de VM para él.

Para configurar el agente de modo que establezca la observabilidad de una carga de trabajo de SAP que se ejecuta en una sola zona, completa los siguientes pasos:

  1. Configura el Administrador de extensiones de VM:

  2. Crea una política de extensión de VM que instale y administre el agente de Google Cloudpara SAP en las instancias de procesamiento que ejecutan tu carga de trabajo de SAP:

Administrador de paquetes

Si administras el ciclo de vida del agente de forma manual en lugar de usar VM Extension Manager, puedes configurar el agente de Google Cloudpara SAP con un administrador de paquetes:

  1. Establece una conexión SSH con la instancia de procesamiento que ejecuta tu carga de trabajo de SAP.

  2. Verifica que estés ejecutando la versión más reciente del agente para SAP.

    Si deseas obtener información para actualizar el agente, consulta Actualiza el agente de Google Cloudpara SAP.

  3. Para permitir que el agente busque detalles sobre la carga de trabajo de SAP y los envíe a Workload Manager, haz lo siguiente:

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

  4. Habilita el agente para recopilar métricas de los procesos que se ejecutan en tu carga de trabajo de SAP:

    1. Habilita la función de supervisión de procesos del agente:
    sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable
    1. Para permitir que el agente recopile métricas de procesos relacionadas con tus instancias de base de datos de SAP HANA, debes configurar parámetros adicionales en la sección hana_metrics_config.

    Para obtener más información, consulta Configura la recopilación de métricas de supervisión de procesos.

  5. Habilita el agente para recopilar métricas de las instancias de SAP HANA que se ejecutan en tu carga de trabajo de SAP:

    1. Habilita la función de supervisión de SAP HANA del agente:
    sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable
    1. Para permitir que el agente se conecte con las instancias de SAP HANA y recopile métricas, debes configurar parámetros adicionales.

    Para obtener más información, consulta Configura la recopilación de métricas de supervisión de SAP HANA.

  6. Guarda el archivo de configuración.

Para ver ejemplos de configuraciones del agente para la observabilidad, consulta Ejemplos de configuraciones del agente.

Configura el agente para una carga de trabajo multizona

Gestor de extensiones de VM

Para configurar y administrar el agente en una flota de instancias de Compute Engine, debes crear una política del Administrador de extensiones de VM para él.

Para configurar el agente de modo que establezca la observabilidad de una carga de trabajo de SAP que se ejecuta en dos o más zonas, completa los siguientes pasos:

  1. Configura el Administrador de extensiones de VM:

  2. Crea una política de extensión de VM que instale y administre el agente de SAP de Google Clouden las instancias de procesamiento que ejecutan el sitio principal de tu carga de trabajo de SAP:

  3. Si ejecutas una carga de trabajo de SAP de alta disponibilidad o tienes un sitio de recuperación ante desastres (DR) para tu carga de trabajo de SAP, crea una política de extensión de VM que instale y administre el agente de Google Cloudpara SAP en las instancias de procesamiento que ejecutan el sitio secundario o de DR de tu carga de trabajo de SAP.

Administrador de paquetes

Si administras el ciclo de vida del agente de forma manual en lugar de usar VM Extension Manager, puedes configurar el agente de Google Cloudpara SAP con un administrador de paquetes:

  1. Establece una conexión SSH con la instancia de procesamiento que ejecuta tu carga de trabajo de SAP.

  2. Verifica que estés ejecutando la versión más reciente del agente para SAP.

    Si deseas obtener información para actualizar el agente, consulta Actualiza el agente de Google Cloudpara SAP.

  3. Para permitir que el agente recopile detalles sobre la carga de trabajo de SAP y los envíe a Workload Manager, haz lo siguiente:

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

  4. Habilita el agente para recopilar métricas de los procesos que se ejecutan en tu carga de trabajo de SAP:

    1. Habilita la función de supervisión de procesos del agente:
    sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable
    1. Para permitir que el agente recopile métricas de procesos relacionadas con tus instancias de base de datos de SAP HANA, debes configurar parámetros adicionales en la sección hana_metrics_config.

    Para obtener más información, consulta Configura la recopilación de métricas de supervisión de procesos.

  5. Habilita el agente para recopilar métricas de las instancias de SAP HANA que se ejecutan en tu carga de trabajo de SAP:

    1. Habilita la función de supervisión de SAP HANA del agente:
    sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable
    1. Para permitir que el agente se conecte con las instancias de SAP HANA y recopile métricas, debes configurar parámetros adicionales.

    Para obtener más información, consulta Configura la recopilación de métricas de supervisión de SAP HANA.

  6. Guarda el archivo de configuración.

  7. Si ejecutas una carga de trabajo de SAP de alta disponibilidad o tienes un sitio de recuperación ante desastres (DR) para tu carga de trabajo de SAP, repite este procedimiento para todas las demás instancias de procesamiento que ejecutan tu carga de trabajo de SAP.

Para ver ejemplos de configuraciones del agente para la observabilidad, consulta Ejemplos de configuraciones del 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 comando status del agente.

Para validar la configuración de Google Cloud , completa los siguientes pasos:

  1. Establece una conexión SSH con la instancia de Compute Engine que ejecuta tu carga de trabajo de SAP.

  2. Verifica la configuración de Google Cloud para la observabilidad:

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

  4. Si usas más de una instancia de procesamiento para ejecutar tu carga de trabajo, repite este procedimiento para todas las demás instancias de procesamiento que ejecuten tu carga de trabajo.

Ejemplos de configuraciones de agentes

Los siguientes ejemplos son archivos de configuración completos del agente de Google Cloudpara SAP que está configurado para admitir la observabilidad de una carga de trabajo de SAP HANA:

En el siguiente ejemplo, se usa una clave de almacenamiento seguro de usuario (hdbuserstore) para la autenticación de SAP HANA:

  {
    "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,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hdbuserstore_key": "user_store_key"
      }
    },
    "discovery_configuration": {
      "enable_workload_discovery": true,
      "enable_discovery": true
    },
    "hana_monitoring_configuration": {
      "enabled": true,
      "hana_instances": [
        {
          "name": "local",
          "sid": "DEH",
          "user": "system",
          "hdbuserstore_key": "user_store_key"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "user": "system",
          "hdbuserstore_key": "user_store_key"
        }
      ]
    }
  }

En el siguiente ejemplo, se usan un nombre de usuario y un secreto de Secret Manager para la autenticación de SAP HANA:

  {
    "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,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hana_db_password_secret_name": "db_pwd_secret_name"
      }
    },
    "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": "db_user_name",
          "hdbuserstore_key": "user_store_key"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "host": "10.123.0.12",
          "port": "30015",
          "user": "db_user_name",
          "secret_name": "db_pwd_secret_name"
        }
      ]
    }
  }

En el siguiente ejemplo, se usan un nombre de usuario y una contraseña para la autenticación de SAP HANA. En su lugar, te recomendamos que uses una clave de almacenamiento seguro de usuario (hdbuserstore) o un secreto de Secret Manager para la autenticación de SAP HANA.

  {
    "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,
      "hana_metrics_config": {
        "hana_db_user": "db_user_name",
        "sid": "DEH",
        "hana_db_password": "TempPa55word"
      }
    },
    "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": "db_user_name",
          "password": "TempPa55word"
        },
        {
          "name": "remote",
          "sid": "DEH",
          "host": "10.123.0.12",
          "port": "30015",
          "user": "db_user_name",
          "password": "TempPa55word"
        }
      ]
    }
  }

Para obtener información sobre los parámetros de configuración admitidos por el agente, consulta Parámetros de configuración.

¿Qué sigue?

  • Una vez que completes correctamente la configuración de observabilidad para una carga de trabajo de SAP, es posible que transcurran hasta 15 minutos para que esa carga de trabajo aparezca en la página Observabilidad de Workload Manager en la consola de Google Cloud .

    Si deseas obtener información para observar tu carga de trabajo de SAP, consulta Visualiza métricas de observabilidad para SAP.