Configura la recopilación de métricas de Process Monitoring

En esta guía, se muestra cómo configurar el agente de Google Cloudpara SAP a fin de recopilar las métricas de Process Monitoring de tus sistemas SAP.

Si deseas obtener más información sobre esta función, consulta Supervisión de procesos con el agente de Google Cloudpara SAP.

Antes de comenzar

Configura los roles de IAM

Para permitir que el agente de Google Cloudpara SAP recopile las métricas de Process Monitoring, debes asegurarte de que la cuenta de servicio que usa tu instancia de Compute Engine o el servidor de la solución Bare Metal incluya los siguientes roles:

Para agregar estos roles necesarios a tu cuenta de servicio, sigue estos pasos:

  1. En la consola de Google Cloud , ve a la página IAM.

    Ir a IAM

  2. Selecciona tu proyecto de Google Cloud .

  3. Identifica la cuenta de servicio a la que le quieres agregar un rol.

    • Si la cuenta de servicio no se encuentra aún en la lista de principales, no tiene ningún rol asignado. Haz clic en Agregar e ingresa la dirección de correo electrónico de la cuenta de servicio.
    • Si la cuenta de servicio ya se encuentra en la lista de principales es porque tiene roles existentes. Haz clic en el botón Editar de la cuenta de servicio que deseas editar.

  4. Selecciona el rol necesario de la lista de funciones disponibles:

    • Visualizador de Compute
    • Monitoring > Escritor de métricas de Monitoring
    • Secret Manager > Usuario con acceso a secretos de Secret Manager

  5. Haz clic en Agregar o Guardar para aplicar los roles a la cuenta de servicio.

Para obtener un nivel de acceso detallado, puedes configurar los siguientes permisos de IAM en tu propio rol personalizado:

  • Recopilación de métricas:
    • monitoring.timeSeries.create
    • compute.instances.get
    • compute.nodeGroups.list
    • compute.nodeGroups.get
  • Secret Manager:
    • secretmanager.versions.access

Para obtener más información sobre cómo crear un rol personalizado, consulta Crea y administra roles personalizados.

Habilitar la recopilación de métricas de Monitoring

Si deseas habilitar la recopilación de métricas de supervisión de procesos con el agente deGoogle Cloudpara SAP, sigue estos pasos:

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

  2. Reemplaza el archivo de configuración del agente:

    /etc/google-cloud-sap-agent/configuration.json

    Como alternativa, también puedes realizar esta configuración mediante la ejecución de comandos. Si deseas obtener más información, consulta Comandos de configuración para el agente de Google Cloudpara SAP.

  3. En la sección collection_configuration, realiza lo siguiente:

    • Para el parámetro collect_process_metrics, especifica el valor true.
    • Para habilitar la recopilación de métricas de supervisión de procesos relacionadas con las instancias de base de datos de SAP HANA, debes configurar los parámetros adicionales en la sección hana_metrics_config. Para obtener más información sobre estos parámetros, consulta Parámetros de configuración.

  4. De manera opcional, en la sección cloud_properties, puedes actualizar los valores del parámetro que se configuran de forma automática. Para hacerlo, agrega la sección cloud_properties a tu archivo de configuración y, luego, especifica las propiedades obligatorias y sus valores.

  5. Guarda el archivo de configuración.

  6. Reinicia el agente para que se aplique la configuración nueva:

    sudo systemctl restart google-cloud-sap-agent

Archivos de configuración de ejemplo

Instancia de Compute Engine

Los siguientes ejemplos son archivos de configuración completos del agente de SAP paraGoogle Cloud, que se ejecuta en uninstancia de Compute Engine, en el que se habilita la recopilación de métricas de Process Monitoring:

Para la autenticación de SAP HANA, el agente usa el siguiente orden de preferencia: si se especifica, el parámetro de configuración hdbuserstore_key se prefiere al parámetro hana_db_password, que se prefiere al parámetro hana_db_password_secret_name. Te recomendamos que configures solo una opción de autenticación en tu archivo de configuración.

  • 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,
    "process_metrics_frequency": 5,
    "slow_process_metrics_frequency": 30,
    "hana_metrics_config": {
      "hana_db_user": "db_user_name",
      "sid": "DEH",
      "hdbuserstore_key": "user_store_key"
    }
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "instance-1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}
  • En el siguiente ejemplo, se usa 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,
    "process_metrics_frequency": 5,
    "slow_process_metrics_frequency": 30,
    "hana_metrics_config": {
      "hana_db_user": "db_user_name",
      "sid": "DEH",
      "hana_db_password_secret_name": "db_pwd_secret_name"
    }
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "instance-1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}
  • En el siguiente ejemplo, se usa un nombre de usuario y una contraseña para la autenticación de SAP HANA. En su lugar, te recomendamos que uses un secreto de Secret Manager o 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,
    "process_metrics_frequency": 5,
    "slow_process_metrics_frequency": 30,
    "hana_metrics_config": {
      "hana_db_user": "db_user_name",
      "sid": "DEH",
      "hana_db_password": "TempPa55word"
    }
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "instance-1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Servidor de solución Bare Metal

Los siguientes ejemplos son archivos de configuración completos del agente de SAP paraGoogle Cloud, que se ejecuta en unservidor de la solución Bare Metal, en el que se habilita la recopilación de métricas de Process Monitoring:

Para la autenticación de SAP HANA, el agente usa el siguiente orden de preferencia: si se especifica, el parámetro de configuración hdbuserstore_key se prefiere al parámetro hana_db_password, que se prefiere al parámetro hana_db_password_secret_name. Te recomendamos que configures solo una opción de autenticación en tu archivo de configuración.

  • 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": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "collect_process_metrics": true,
    "process_metrics_frequency": 5,
    "slow_process_metrics_frequency": 30,
    "hana_metrics_config": {
      "hana_db_user": "db_user_name",
      "sid": "DEH",
      "hdbuserstore_key": "user_store_key"
    }
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1"
        "region": "us-central1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}
  • En el siguiente ejemplo, se usa 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": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "collect_process_metrics": true,
    "process_metrics_frequency": 5,
    "slow_process_metrics_frequency": 30,
    "hana_metrics_config": {
      "hana_db_user": "db_user_name",
      "sid": "DEH",
      "hana_db_password_secret_name": "db_pwd_secret_name"
    }
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1"
        "region": "us-central1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}
  • En el siguiente ejemplo, se usa un nombre de usuario y una contraseña para la autenticación de SAP HANA. En su lugar, te recomendamos que uses un secreto de Secret Manager o una clave de almacenamiento seguro de usuario (hdbuserstore) para la autenticación de SAP HANA. 
    {
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "collect_process_metrics": true,
    "process_metrics_frequency": 5,
    "slow_process_metrics_frequency": 30,
    "hana_metrics_config": {
      "hana_db_user": "db_user_name",
      "sid": "DEH",
      "hana_db_password": "TempPa55word"
    }
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1"
        "region": "us-central1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Parámetros de configuración

En la siguiente tabla, se explican los parámetros de configuración del agente de SAP paraGoogle Cloudque son específicos de la recopilación de métricas de Process Monitoring.

Parámetros
provide_sap_host_agent_metrics

Boolean

Para habilitar la recopilación de las métricas que requiere SAP Host Agent, especifica true. La ruta predeterminada es true.
No establezcas provide_sap_host_agent_metrics en false, a menos que te dirijan el servicio de atención al cliente de Cloud o el de asistencia de SAP.

bare_metal

Boolean

Cuando el agente se instale en un servidor de solución Bare Metal, especifica true. La ruta predeterminada es false.
log_level

String

Para establecer el nivel de registro del agente, establece el valor requerido. Los niveles de registro disponibles son los siguientes:

  • DEBUG
  • INFO
  • WARNING
  • ERROR

El valor predeterminado es INFO. No cambies el nivel de registro, a menos que te dirija el servicio de atención al cliente de Cloud.
log_to_cloud

Boolean

Para redireccionar los registros del agente a Cloud Logging, especifica true. El valor predeterminado es true.
cloud_properties.project_id

String

Si tu sistema SAP se ejecuta en un servidor de la solución Bare Metal, especifica el ID del proyecto de Google Cloud que usas con la solución Bare Metal.

Cuando el agente se ejecuta en una instancia de Compute Engine, de forma predeterminada, detecta el ID del proyecto automáticamente.
cloud_properties.instance_name

String

Si el sistema SAP se ejecuta en una instancia de Compute Engine, especifica el nombre de esa instancia de procesamiento. El agente detecta automáticamente el nombre de la instancia de procesamiento durante la instalación.

Si tu sistema SAP se ejecuta en un servidor de la solución Bare Metal, especifica el nombre de ese servidor.
cloud_properties.region

String

Si tu sistema SAP se ejecuta en un servidor de la solución Bare Metal, especifica la región del servidor de la solución Bare Metal.

Cuando el agente se ejecuta en una instancia de procesamiento, de forma predeterminada, usa la región en la que se implementa la instancia de procesamiento.
cloud_properties.zone

String

Cuando el agente se ejecuta en una instancia de procesamiento, de forma predeterminada, usa la zona en la que se implementa la instancia de procesamiento.
cloud_properties.image

String

Especifica el nombre de la imagen de SO de la instancia.

Cuando el agente se ejecuta en una instancia de procesamiento, de forma predeterminada, detecta automáticamente la imagen de SO que usa la instancia de procesamiento.
cloud_properties.numeric_project_id

String

Especifica el ID numérico del proyecto de Google Cloud en el que se ejecuta el sistema SAP.

Cuando el agente se ejecuta en una instancia de procesamiento, de forma predeterminada, detecta automáticamente el número de proyecto.
discovery_configuration.enable_workload_discovery

Boolean

Para permitir que el agente recopile los nombres y las versiones de los productos SAP que se ejecutan en el host, especifica true. El valor predeterminado es true.

Para obtener más información, consulta la base de código del agente en el repositorio google-cloud-sap-agent de GitHub en GoogleCloudPlatform/sapagent.

discovery_configuration.enable_discovery

Boolean

Para enviar a Cloud Logging la información que el agente recopila sobre los productos de SAP que se ejecutan en el host, especifica true. El valor predeterminado es true.

Si especificas el valor false, el agente almacenará la información recopilada en el host y no la enviará a Cloud Logging.

collection_configuration.collect_process_metrics

Boolean

Para habilitar la recopilación de métricas de supervisión, especifica true. La ruta predeterminada es false.
Este parámetro solo se aplica a Linux.

Si habilitas la recopilación de métricas de procesos para SAP HANA, debes configurar los parámetros adicionales que se enumeran en hana_metrics_config.
collection_configuration.process_metrics_frequency

Int

A partir de la versión 2.6, este parámetro determina la frecuencia de recopilación de las métricas de Process Monitoring que cambian rápidamente, en segundos. Las métricas de Process Monitoring que cambian rápidamente son: sap/hana/availability, sap/hana/ha/availability y sap/nw/availability.

El valor predeterminado para este parámetro es 5 segundos. Te recomendamos usar este valor predeterminado.

Todas las demás métricas (de cambio lento) de Monitoring se recopilan con una frecuencia predeterminada de 30 segundos. Para cambiar la frecuencia de recopilación de las métricas de Process Monitoring que cambian lentamente, usa el parámetro slow_process_metrics_frequency.
collection_configuration.slow_process_metrics_frequency

Int

Especifica la frecuencia de recopilación de las métricas de Process Monitoring que cambian lentamente, en segundos.

El valor predeterminado para este parámetro es 30 segundos.
collection_configuration.process_metrics_to_skip

Array

Especifica las métricas de Process Monitoring que no quieres que recopile el agente. Este parámetro acepta un valor separado por comas de los nombres de las métricas de Process Monitoring. Por ejemplo: "process_metrics_to_skip": ["/sap/nw/abap/sessions", "/sap/nw/abap/rfc"].

collection_configuration.hana_metrics_config.hana_db_user

String

Especifica la cuenta de usuario de la base de datos que el agente usa para consultar SAP HANA. El valor predeterminado es SYSTEM.
collection_configuration.hana_metrics_config.hana_db_password

String

Especifica la contraseña de texto sin formato para la cuenta de usuario de la base de datos que el agente usa a fin de consultar SAP HANA.

En lugar de especificar una contraseña de texto sin formato, te recomendamos que uses una de las siguientes opciones:

  • hana_db_password_secret_name, para el que especificas un objeto Secret almacenado en Secret Manager.
  • hdbuserstore_key, para el que especificas una clave hdbuserstore.

Para la autenticación de SAP HANA, el agente usa el siguiente orden de preferencia: si se especifica, el parámetro de configuración hdbuserstore_key se prefiere al parámetro hana_db_password, que se prefiere al parámetro hana_db_password_secret_name. Te recomendamos que configures solo una opción de autenticación en tu archivo de configuración.

collection_configuration.hana_metrics_config.hana_db_password_secret_name

String

A fin de proporcionar de forma segura la contraseña de la cuenta de usuario de la base de datos que el agente usa para consultar SAP HANA, especifica el nombre del secreto que contiene las credenciales de seguridad de la cuenta de usuario de la base de datos.

El agente recopila las métricas relacionadas con SAP HANA solo cuando especificas hana_db_password_secret_name, hdbuserstore_key o hana_db_password.

Para la autenticación de SAP HANA, el agente usa el siguiente orden de preferencia: si se especifica, el parámetro de configuración hdbuserstore_key se prefiere al parámetro hana_db_password, que se prefiere al parámetro hana_db_password_secret_name. Te recomendamos que configures solo una opción de autenticación en tu archivo de configuración.

collection_configuration.hana_metrics_config.hdbuserstore_key

String

Para conectarte de forma segura a un sistema SAP HANA, especifica una clave de almacenamiento seguro de usuario (hdbuserstore) que hayas creado para ese sistema.

Para usar una clave hdbuserstore para la autenticación, asegúrate de lo siguiente:

  • Las herramientas de SAP hdbsql y hdbuserstore se instalan en la instancia de procesamiento que aloja el agente.
  • La clave hdbuserstore corresponde a una instancia específica de SAP HANA. No puedes usar claves que contengan nombres de host de varias instancias de SAP HANA.
  • El usuario SIDadm puede consultar la base de datos de SAP HANA con esta clave. Aquí, SID hace referencia al valor que especificaste para el parámetro sid. Para verificarlo, ejecuta el siguiente comando como el usuario SIDadm: 
    hdbsql -U HDB_USERSTORE_KEY "SELECT * FROM DUMMY"

Este parámetro de configuración es compatible con la versión 3.3 del agente.

Para la autenticación de SAP HANA, el agente usa el siguiente orden de preferencia: si se especifica, el parámetro de configuración hdbuserstore_key se prefiere al parámetro hana_db_password, que se prefiere al parámetro hana_db_password_secret_name. Te recomendamos que configures solo una opción de autenticación en tu archivo de configuración.

collection_configuration.hana_metrics_config.sid

String

Especifica el SID de tu instancia de SAP HANA. Si usas una clave hdbuserstore para autenticarte en SAP HANA, consulta la sección hdbuserstore_key.

Visualiza las métricas recopiladas

Para visualizar las métricas de supervisión de procesos que recopila el agente, puedes usar los siguientes paneles personalizados que proporcionaGoogle Cloud :

  • Descripción general del agente de SAP - HANA En este panel, se proporcionan gráficos que muestran la descripción general del estado de las siguientes métricas: disponibilidad de SAP HANA, disponibilidad de SAP HANA con alta disponibilidad, replicación de SAP HANA con alta disponibilidad, estado del servicio de SAP HANA, clúster con alta disponibilidad: estado del nodo y clúster con alta disponibilidad: estado de recursos para instancias de SAP.

    El archivo JSON para este panel es sap-agent-status-overview.json.

  • Métricas sin procesar del agente de SAP - HANA: en este panel, se proporcionan gráficos que muestran valores de métricas sin procesar para las siguientes métricas: disponibilidad de SAP HANA, disponibilidad de SAP HANA con alta disponibilidad, replicación de SAP HANA con alta disponibilidad, estado del servicio de SAP HANA, clúster con alta disponibilidad: estado del nodo y clúster de alta disponibilidad: estado de recursos para instancias de SAP.

    El archivo JSON para este panel es sap-agent-raw-metrics.json.

Instala paneles

Para instalar un panel personalizado, sigue estos pasos:

consola de

  1. En la consola de Google Cloud , ve a la página Monitoring:

    Ir a Monitoring

  2. En el panel de navegación de Monitoring, haz clic en Paneles.

  3. Haz clic en la pestaña Biblioteca de muestra.

    Se muestra la pestaña de la biblioteca de muestra seleccionada.

  4. Para filtrar los paneles personalizados específicos del agente, en el campo Filtro, escribe Agent for SAP.

  5. (Opcional) Para ver los detalles sobre un panel o la vista previa de su contenido, haz clic en Vista previa.

  6. Selecciona el panel que deseas instalar.

  7. Haz clic en Importar y, luego, en Confirmar.

    El panel se agrega a los paneles disponibles en tu proyecto deGoogle Cloud . Para ver tu panel, sigue las instrucciones en Visualiza el panel instalado.

Google Cloud CLI

  1. Abre Cloud Shell:

    Abra Cloud Shell

  2. En Cloud Shell, clona o descarga el repositorio:

    git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples/

  3. En Cloud Shell, instala el panel necesario con el archivo JSON correspondiente:

    gcloud monitoring dashboards create --config-from-file=CONFIG_FROM_FILE

    Reemplaza CONFIG_FROM_FILE por la ruta de acceso al archivo JSON que contiene la configuración del panel. Los archivos de configuración del panel se pueden ubicar en la ruta: monitoring-dashboard-samples/dashboards/google-cloud-agent-for-sap.

    El panel se agrega a los paneles disponibles en tu proyecto de Google Cloud . Para ver tu panel, sigue las instrucciones en Visualiza el panel instalado.

Visualiza los paneles instalados

Para ver los paneles instalados, sigue estos pasos:

  1. En la consola de Google Cloud , ve a la página Monitoring:

    Ir a Monitoring

  2. En el panel de navegación de Monitoring, haz clic en Paneles.

  3. Haz clic en el nombre del panel de la lista.

Si tienes muchos paneles, puedes filtrar los paneles personalizados o el nombre del panel nuevo. Si deseas obtener información para filtrar esta lista, consulta Visualiza paneles personalizados.

La siguiente imagen es un ejemplo que muestra una parte del panel personalizado para las métricas de SAP HANA en Monitoring.

La captura de pantalla muestra el panel personalizado para las métricas de SAP HANA en Monitoring