Configura el agente para SAP para establecer la observabilidad

En este documento, se describe cómo configurar Google Cloudel agente de para SAP para configurar la observabilidad de tu carga de trabajo de SAP con Gestor de cargas de trabajo.

El servicio de observabilidad de Gestor de cargas de trabajo necesita el agente para recopilar métricas de tu carga de trabajo de SAP y la infraestructura subyacente. Para obtener más información, consulta 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 Gestor de extensiones de VM para él.

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

  1. Configura el Gestor de extensiones de VM:

  2. Crea una política de extensión de VM que instale y administre Google Cloud's agente de para 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 el Gestor de extensiones de VM, puedes configurar Google Cloud's Agent for 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 de para SAP.

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

  3. Para permitir que el agente busque detalles sobre la carga de trabajo de SAP y los envíe a Gestor de cargas de trabajo, 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 las 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 de agentes para la observabilidad, consulta Configuraciones de agentes de ejemplo.

Configura el agente para una carga de trabajo de varias zonas

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 Gestor de extensiones de VM para él.

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

  1. Configura el Gestor de extensiones de VM:

  2. Crea una política de extensión de VM que instale y administre Google Cloud's agente de para SAP en 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 el Gestor de extensiones de VM, puedes configurar Google Cloud's Agent for 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 de para SAP.

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

  3. Para permitir que el agente recopile detalles sobre la carga de trabajo de SAP y los envíe a Gestor de cargas de trabajo, 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 las 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 de agentes para la observabilidad, consulta Configuraciones de agentes de ejemplo.

Valida la configuración para la observabilidad del Gestor de cargas de trabajo

Puedes validar si tienes la configuración Google Cloud correcta para usar el servicio de observabilidad de Gestor de cargas de trabajo ejecutando el comando del agentestatus.

Para validar la Google Cloud configuración, 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 Google Cloud configuración para la observabilidad:

    sudo /usr/bin/google_cloud_sap_agent status

    Si la Google Cloud configuración para usar el servicio de observabilidad de Gestor de cargas de trabajo es correcta, el resultado incluye lo siguiente. Es posible que tu configuración tenga valores distintos de los default.

    Agent Status:
    Installed version: 3.15-....
    ...
    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 ejecutan tu carga de trabajo.

Configuraciones de agentes de ejemplo

Los siguientes ejemplos son archivos de configuración completos del Google Cloud's agente de para 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 del 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 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. Te recomendamos que uses una clave de almacenamiento seguro del 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 compatibles con 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, puede tardar hasta 15 minutos en aparecer en la página Observabilidad de Gestor de cargas de trabajo en la Google Cloud consola.

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