Instala y configura el agente de Google Cloud para SAP en un servidor de la solución Bare Metal

El agente deGoogle Cloudpara SAP es necesario para la asistencia de SAP de los sistemas SAP que se ejecutan en un servidor de la solución Bare Metal.

Si usas las siguientes imágenes de SO de RHEL o SLES “para SAP” que proporciona Google Cloud, el agente de Google Cloudpara SAP se empaqueta con las imágenes de SO:

  • RHEL: todas las imágenes “para SAP”
  • SLES: SLES 15 SP4 para SAP y versiones posteriores

Para obtener información sobre los sistemas operativos disponibles para ejecutar SAP en los servidores de la solución Bare Metal, consulta los siguientes vínculos:

Descripción general de instalación

Para instalar el agente de Google Cloudpara SAP, usa los comandos de administración de paquetes del sistema operativo estándar: en RHEL, el comando yum; en SLES, el comando zypper. El comando de administración de paquetes completa las siguientes tareas:

  • Descarga la versión más reciente del agente para SAP de Google Cloud.
  • Crea el agente como un servicio systemd de Linux, llamado google-cloud-sap-agent.
  • Habilita e inicia el servicio, google-cloud-sap-agent.

Instala el agente

Si deseas instalar el agente de Google Cloudpara SAP en un servidor de la solución Bare Metal, sigue estos pasos:

  1. Establece una conexión SSH a tu servidor de la solución Bare Metal.

  2. En tu terminal, instala el agente mediante la ejecución del comando específico de tu sistema operativo:

    • (Recomendado) Para instalar la versión 3.8 (más reciente) del agente, sigue estos pasos:

      RHEL

      sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM
[google-cloud-sap-agent]
name=Google Cloud Agent for SAP
baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM
sudo yum install google-cloud-sap-agent

      SLES15

      sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent

      SLES 12

      sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-x86_64 google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent

    • Para instalar una versión específica del agente, ejecuta este comando:

      RHEL

      sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM
[google-cloud-sap-agent]
name=Google Cloud Agent for SAP
baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM
sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      SLES15

      sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      SLES 12

      sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-x86_64 google-cloud-sap-agent
sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64

      Reemplaza VERSION_NUMBER por el número de versión del agente que deseas instalar, como 3.1-606637668. Para obtener información sobre las versiones de agentes que puedes instalar, consulta Lista de todas las versiones disponibles del agente.

  3. Abre el siguiente archivo de configuración:

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

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

  4. Modifica o agrega los siguientes parámetros al archivo de configuración:

    • En la primera sección:
      • bare_metal: establecido como true.
    • Agrega la sección cloud_properties y especifica los siguientes parámetros:
      • project_id: Especifica tu Google Cloud proyecto.
      • instance_name: especifica el nombre de tu servidor de la solución Bare Metal
      • region: especifica la región de tu servidor de la solución Bare Metal

  5. Guarda el archivo de configuración.

  6. Reinicia el agente:

    sudo systemctl restart google-cloud-sap-agent
Para obtener más información sobre los parámetros de configuración, consulta Parámetros de configuración y configuración de ejemplo.

Después de instalar el agente de Google Cloudpara SAP y SAP Host Agent, valida la instalación del agente de Google Cloudpara SAP, como se describe en Valida la instalación del agente.

Valida la instalación del agente

  1. Establece una conexión SSH con tu servidor de la solución Bare Metal.

  2. Ejecuta el siguiente comando: 

    systemctl status google-cloud-sap-agent

    Si el agente funciona de forma correcta, el resultado contendrá active (running). Por ejemplo: 

    google-cloud-sap-agent.service - Google Cloud Agent for SAP
Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; enabled; vendor preset: disabled)
Active:  active (running)  since Fri 2022-12-02 07:21:42 UTC; 4 days ago
Main PID: 1337673 (google-cloud-sa)
Tasks: 9 (limit: 100427)
Memory: 22.4 M (max: 1.0G limit: 1.0G)
CGroup: /system.slice/google-cloud-sap-agent.service
       └─1337673 /usr/bin/google-cloud-sap-agent

Si el agente no está en ejecución, reinicia el agente.

Verifica que SAP Host Agent reciba métricas

Para verificar que el agente deGoogle Cloudpara SAP recopile las métricas de infraestructura y que se envíen de forma correcta al agente de host SAP, sigue estos pasos:

  1. En el sistema SAP, ingresa la transacción ST06.

  2. En el panel de descripción general, revisa la disponibilidad y el contenido de los siguientes campos para verificar la configuración completa y correcta de la infraestructura de supervisión de SAP y Google:

    • Proveedor de servicios en la nube: Google Cloud Platform
    • Acceso de supervisión mejorada: TRUE
    • Detalles de supervisión mejorada: ACTIVE

Configura el agente de Google Cloudpara SAP en Linux

Después de instalar el agente de Google Cloudpara SAP, de forma opcional, puedes habilitar otras funciones del agente si realizas las siguientes configuraciones. De forma predeterminada, la recopilación de métricas de SAP Host Agent y métricas de evaluación de Workload Manager está habilitada.

Requisitos previos

Para permitir que el agente acceda a los recursos de Google Cloud desde un entorno de la solución Bare Metal, debes completar los siguientes requisitos previos:

Configurar una cuenta de servicio

Para permitir que el agente acceda a los recursos Google Cloud desde un entorno de la solución Bare Metal, debes configurar una cuenta de servicio de IAM.

Como mínimo, la cuenta de servicio que usa el agente debe incluir el rol Escritor de estadísticas de Workload Manager (roles/workloadmanager.insightWriter).

Para crear una cuenta de servicio, sigue estos pasos:

  1. Create a service account:

    1. In the Google Cloud console, go to the Create service account page.

      Go to Create service account
    2. Select your project.

    3. In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.

      In the Service account description field, enter a description. For example, Service account for quickstart.

    4. Click Create and continue.

    5. Grant the Workload Manager > Workload Manager Insights Writer role to the service account.

      To grant the role, find the Select a role list, then select Workload Manager > Workload Manager Insights Writer.

    6. Click Continue.

    7. Click Done to finish creating the service account.

      Do not close your browser window. You will use it in the next step.

  2. Create a service account key:

    1. In the Google Cloud console, click the email address for the service account that you created.
    2. Click Keys.
    3. Click Add key, and then click Create new key.
    4. Click Create. A JSON key file is downloaded to your computer.
    5. Click Close.

Después de crear la cuenta de servicio, asegúrate de subir su archivo de claves JSON a una ubicación segura en el servidor de la solución Bare Metal que sea accesible para el agente.

Habilita funciones

Una vez que configures una cuenta de servicio para tu solución Bare Metal y le otorgues los roles necesarios, puedes habilitar otras funciones del agente de Google Cloudpara SAP realizando las siguientes configuraciones:

Archivo de configuración predeterminada

El siguiente fragmento es un ejemplo de la configuración predeterminada de la versión 3.8 (más reciente) del agente de Google Cloudpara SAP:

{
  "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": false
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Para ver los archivos de configuración de ejemplo específicos de la función, consulta la guía de configuración para esa función.

Parámetros de configuración

En la siguiente tabla, se describen los parámetros de configuración del agente deGoogle Cloudpara SAP que se ejecuta en un servidor de la solución Bare Metal, incluidos los parámetros relacionados con la recopilación de métricas. Para obtener información sobre los parámetros de configuración relacionados con la función de Backint del agente, consulta Parámetros de configuración.

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

Especifica el nombre del servidor de la solución Bare Metal en el que instalaste el agente.
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 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, se prefiere el parámetro de configuración hdbuserstore_key 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, se prefiere el parámetro de configuración hdbuserstore_key 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, se prefiere el parámetro de configuración hdbuserstore_key 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.

collection_configuration.collect_workload_validation_metrics

Boolean

Para habilitar la recopilación de métricas de evaluación de Workload Manager, especifica true. A partir de la versión 3.2, el valor predeterminado es true.
Este parámetro solo se aplica a Linux.
collection_configuration.workload_validation_metrics_frequency

Int

La frecuencia de recopilación de las métricas de evaluación de Workload Manager, en segundos. El valor predeterminado es 300 segundos.

Si necesitas modificar la frecuencia de recopilación de las métricas del Administrador de cargas de trabajo, agrega el parámetro workload_validation_metrics_frequency en la sección collection_configuration y proporciona el valor requerido.
collection_configuration.workload_validation_collection_definition.fetch_latest_config

Boolean

Opcional. El valor predeterminado es true, que permite que el agente recopile el último conjunto de métricas de evaluación del Administrador de cargas de trabajo sin necesidad de que actualices el agente. Si deseas desactivar este comportamiento, especifica este parámetro en tu archivo de configuración y establece su valor en false.
collection_configuration.workload_validation_db_metrics_config.hana_db_user

String

Especifica la cuenta de usuario que se usa para consultar la instancia de SAP HANA. La cuenta de usuario debe tener el permiso de lectura para la base de datos de SAP HANA.
collection_configuration.workload_validation_db_metrics_config.hana_db_password

String

Especifica la contraseña de la cuenta de usuario que se usa para consultar la instancia de SAP HANA.

Para la autenticación de SAP HANA, el agente usa el siguiente orden de preferencia: si se especifica, se prefiere el parámetro de configuración hdbuserstore_key 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.workload_validation_db_metrics_config.hana_db_password_secret_name

String

Especifica el nombre del secreto en Secret Manager que almacena la contraseña de la cuenta de usuario.

Como alternativa, puedes especificar el parámetro de configuración hdbuserstore_key para autenticar el usuario de SAP HANA especificado.

Para la autenticación de SAP HANA, el agente usa el siguiente orden de preferencia: si se especifica, se prefiere el parámetro de configuración hdbuserstore_key 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.workload_validation_db_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.

Si especificas hdbuserstore_key, puedes omitir la especificación de los parámetros hostname y port.

Para la autenticación de SAP HANA, el agente usa el siguiente orden de preferencia: si se especifica, se prefiere el parámetro de configuración hdbuserstore_key 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.workload_validation_db_metrics_config.sid

String

Especifica el SID de tu instancia de SAP HANA.
collection_configuration.workload_validation_db_metrics_config.hostname

String

Especifica el identificador de la máquina, ya sea local o remoto, que aloja la instancia de SAP HANA. Los siguientes son los valores admitidos:

  • Si el host es una máquina local, especifica la cadena localhost o la dirección IP de bucle invertido del host local, como 127.0.0.1.
  • Si el host es una máquina remota, especifica su dirección IP interna o externa.
collection_configuration.workload_validation_db_metrics_config.port

String

Especifica el puerto en el que la instancia de SAP HANA acepta consultas. Para la primera o única instancia de base de datos de usuario, el puerto es 3NN15, en el que NN es el número de instancia de la instancia de SAP HANA.
collection_configuration.workload_validation_db_metrics_frequency

Int

La frecuencia de recopilación de las métricas de la base de datos de SAP HANA, en segundos, para la evaluación de Workload Manager. El valor predeterminado es 3600 segundos.

Si bien puedes actualizar la frecuencia de recopilación de las métricas de la base de datos de SAP HANA, te recomendamos que uses el valor predeterminado. Si necesitas modificar el valor predeterminado, agrega el parámetro workload_validation_db_metrics_frequency en la sección collection_configuration y proporciona el valor requerido. Asegúrate de no establecer una frecuencia de recopilación mayor que 3600 segundos.
hana_monitoring_configuration.enabled

Boolean

Opcional. Si deseas habilitar el agente de Google Cloudpara SAP para recopilar las métricas de supervisión de SAP HANA, especifica true. El valor predeterminado es false.

Los siguientes parámetros secundarios solo se aplican cuando especificas hana_monitoring_configuration.enabled: true.
hana_monitoring_configuration.sample_interval_sec

Int

Opcional. Especifica el intervalo de muestra, en segundos, que determina la frecuencia con la que el agente de Google Cloudpara SAP consulta tus instancias de SAP HANA para recopilar las métricas de supervisión de SAP HANA. El valor predeterminado es 300 segundos.

Para cada consulta definida en el archivo de configuración del agente de Google Cloudpara SAP, puedes reemplazar el intervalo de muestra global si especificas el intervalo requerido en el parámetro sample_interval_sec. Los intervalos de muestra deben ser de 5 segundos o más.
hana_monitoring_configuration.query_timeout_sec

Int

Opcional. Especifica el tiempo de espera para cada consulta realizada a las instancias de SAP HANA. El valor predeterminado es 300 segundos.
hana_monitoring_configuration.execution_threads

Int

Opcional. Especifica la cantidad de subprocesos que se usan para enviar consultas a las instancias de SAP HANA. Cada consulta se ejecuta en su propio subproceso. El valor predeterminado es 10.
hana_monitoring_configuration.send_query_response_time

Boolean

Opcional. Especifica true para que el agente capture el tiempo de respuesta de cada consulta de supervisión de SAP HANA definida en el archivo de configuración del agente.
hana_monitoring_configuration.hana_instances.name

String

Especifica el identificador de nombre para tu instancia de SAP HANA.
hana_monitoring_configuration.hana_instances.sid

String

Especifica el SID de tu instancia de SAP HANA. Esta cadena se agrega como una etiqueta a todas las métricas resultantes de la consulta de tus instancias de SAP HANA.
hana_monitoring_configuration.hana_instances.host

String

Especifica el identificador de la máquina, ya sea local o remoto, que aloja la instancia de SAP HANA. Los siguientes son los valores admitidos:

  • Si el host es una máquina local, especifica la cadena localhost o la dirección IP de bucle invertido del host local, como 127.0.0.1.
  • Si el host es una máquina remota, especifica su dirección IP interna o externa.
hana_monitoring_configuration.hana_instances.port

String

Especifica el puerto en el que la instancia de SAP HANA acepta consultas. Para la primera o única instancia de base de datos de usuario, el puerto es 3NN15, en el que NN es el número de instancia de la instancia de SAP HANA.
hana_monitoring_configuration.hana_instances.user

String

Especifica la cuenta de usuario que se usa para consultar la instancia de SAP HANA.

Asegúrate de que este usuario tenga el privilegio para leer las vistas de supervisión en tu base de datos de SAP HANA. Si no se otorga este privilegio, las métricas de supervisión de SAP HANA relacionadas con las vistas de supervisión no contienen datos.
hana_monitoring_configuration.hana_instances.password

String

Opcional. Especifica la contraseña, como texto sin formato, que autentica la cuenta de usuario para consultar la instancia de SAP HANA.

Para la autenticación, debes especificar una de las siguientes opciones:

  • La contraseña de texto sin formato al parámetro password.
  • (Recomendado) Si usas Secret Manager para almacenar la contraseña como un secreto, debes especificar el nombre del secreto correspondiente al parámetro secret_name.
  • (Recomendado) Una clave hdbuserstore para el parámetro hdbuserstore_key.

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 tiene prioridad sobre el parámetro password, que tiene prioridad sobre el parámetro secret_name. Te recomendamos que configures solo una opción de autenticación en tu archivo de configuración.
hana_monitoring_configuration.hana_instances.secret_name

String

Opcional. Especifica el nombre del secreto en Secret Manager que almacena la contraseña de la cuenta de usuario.

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 tiene prioridad sobre el parámetro password, que tiene prioridad sobre el parámetro secret_name. Te recomendamos que configures solo una opción de autenticación en tu archivo de configuración.
hana_monitoring_configuration.hana_instances.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.

Si especificas hdbuserstore_key, puedes omitir la especificación de los parámetros host y port.
hana_monitoring_configuration.hana_instances.is_local

Boolean

Para supervisar los sistemas de HA, especifica true para indicarle al agente que la instancia de SAP HANA definida se aloja en la misma instancia de Compute Engine que el agente. Luego, el agente verifica en el tiempo de ejecución si la instancia de SAP HANA definida es el nodo principal o secundario en ese sistema de HA. El agente requiere este conocimiento para ejecutar las consultas de supervisión de SAP HANA en el tipo de instancia de SAP HANA que especifiques para el parámetro queries.run_on.

El valor predeterminado de este parámetro es false, lo que hace que el agente ejecute todas las consultas de supervisión de SAP HANA habilitadas en la instancia de SAP HANA correspondiente. Para obtener más información, consulta Supervisión de sistemas de alta disponibilidad y de múltiples usuarios.

Este parámetro es compatible con la versión 3.7 del agente.
hana_monitoring_configuration.hana_instances.instance_num

String

Especifica el número de instancia que configuraste para tu instancia de SAP HANA. Esta información es necesaria para que el agente detecte tu instancia de SAP HANA.

Este parámetro es compatible con la versión 3.7 del agente.
hana_monitoring_configuration.hana_instances.queries_to_run.run_all

Boolean

Opcional. Especifica true para ejecutar todas las consultas de supervisión de SAP HANA, tanto las predeterminadas como las personalizadas, que estén habilitadas en el archivo de configuración del agente en la instancia de SAP HANA especificada. El valor predeterminado es false.
hana_monitoring_configuration.hana_instances.queries_to_run.query_name

String

Opcional. Especifica las consultas que deseas ejecutar en la instancia de SAP HANA especificada.

Si ejecutas una base de datos de SAP HANA multiusuario, puedes configurar la supervisión específica del inquilino con este parámetro de configuración. En la siguiente configuración de ejemplo, se ejecutan dos consultas en HANA_TENANT_1 y todas las consultas definidas en la configuración se ejecutan en HANA_TENANT_2:

    "hana_instances": [
      {
        "name": "HANA_TENANT_1,
        "queries_to_run": {
          "query_name": ["QUERY_NAME_1", "QUERY_NAME_2"]
        }
      },
      {
        "name": "HANA_TENANT_2,
        "queries_to_run": {
          "run_all": true
        }
      }
      ...
    ]
hana_monitoring_configuration.hana_instances.enable_ssl

Boolean

Opcional. Especifica si SSL está habilitado en tu instancia de SAP HANA. El valor predeterminado es false.
hana_monitoring_configuration.hana_instances.host_name_in_certificate

String

Si especificas enable_ssl: true para una instancia de SAP HANA, debes especificar el nombre de host que se configura en el certificado SSL.
hana_monitoring_configuration.hana_instances.tls_root_ca_file

String

Si especificas enable_ssl: true para una instancia de SAP HANA, debes especificar la ruta de acceso de tu certificado de seguridad.
hana_monitoring_configuration.queries.enabled

Boolean

Opcional. A fin de habilitar una consulta en SQL para todas tus instancias de SAP HANA, especifica el valor true del parámetro enabled de esa consulta de SQL.
hana_monitoring_configuration.queries.name

String

Si definiste consultas personalizadas en tu archivo de configuración, debes especificar un nombre único para cada consulta personalizada.

El nombre de la consulta debe ser único, ya que se usa para compilar la URL predeterminada de la métrica en Monitoring.
hana_monitoring_configuration.queries.run_on

String

Opcional. Especifica este parámetro si supervisas un sistema SAP HANA de alta disponibilidad y deseas ejecutar las consultas de supervisión de SAP HANA en el nodo principal o secundario. Valores admitidos: PRIMARY, SECONDARY, ALL. Cuando especificas el valor ALL, el agente ejecuta las consultas de supervisión de SAP HANA en los nodos principal y secundario de tu clúster de HA.

Este parámetro es compatible con la versión 3.7 del agente. Además, para ejecutar las consultas en el nodo secundario, asegúrate de que tu sistema de HA se implemente con la configuración Active/Active (Read Enabled).

hana_monitoring_configuration.queries.sql

String

Especifica la instrucción de SQL que el agente emite a tus instancias de SAP HANA.

La instrucción de SQL debe cumplir con la sintaxis de SQL definida por SAP en SAP HANA SQL and System Views Reference.
hana_monitoring_configuration.queries.sample_interval_sec

Int

Opcional. Especifica el intervalo de muestra para la consulta de SQL. Esto anula el intervalo de muestra global. El valor debe ser de 5 segundos o más.
hana_monitoring_configuration.queries.columns.name

String

Especifica un nombre que identifique de forma única cada columna.

El nombre de columna debe ser único porque se usa para compilar la URL predeterminada de la métrica en Monitoring.
hana_monitoring_configuration.queries.columns.metric_type

String

Para el manejo mediante Monitoring, especifica uno de los siguientes tipos de métricas: METRIC_LABEL, METRIC_GAUGE o METRIC_CUMULATIVE.

Las métricas de tipo METRIC_LABEL se agregan como etiquetas a todas las métricas METRIC_GAUGE y METRIC_CUMULATIVE que se envían a Monitoring.
hana_monitoring_configuration.queries.columns.value_type

String

Para el control de Monitoring, especifica un tipo de datos que sea compatible con el tipo de métrica.

Los tipos de datos compatibles son los siguientes: VALUE_BOOL, VALUE_INT64, VALUE_STRING o VALUE_DOUBLE. Para obtener más información, consulta Combinación compatible.
hana_monitoring_configuration.queries.columns.name_override

String

Opcional. Para el manejo mediante Monitoring, especifica la ruta de acceso que deseas mostrar en la URL de la métrica en lugar de los nombres de columna y consulta. Por ejemplo:

  • URL predeterminada de la métrica: workload.googleapis.com/sap/hanamonitoring/QUERY_NAME/COLUMN_NAME
  • URL de la métrica con ruta de acceso personalizada: workload.googleapis.com/sap/hanamonitoring/CUSTOM_PATH

Soluciona problemas

Si deseas obtener información para diagnosticar y resolver problemas que puedes encontrar cuando instalas y configuras el agente de Google Cloudpara SAP, consulta la guía de solución de problemas del agente deGoogle Cloudpara SAP.

Obtenga asistencia

Si necesitas ayuda para resolver problemas con el agente deGoogle Cloudpara SAP, recopila toda la información de diagnóstico disponible y comunícate con el servicio de atención al cliente de Cloud. Si deseas obtener más información para comunicarte con el equipo de Atención al cliente, consulta Obtén asistencia para SAP en Google Cloud.