Configura la recopilación de métricas de estado del agente

En esta guía, se muestra cómo configurar el agente de Google Cloud para SAP a fin de recopilar las métricas de estado del proceso daemon del agente en tu instancia de VM de Compute Engine o en el servidor de la solución Bare Metal.

Para obtener información sobre esta función, consulta Recopilación de métricas de estado del agente.

Antes de comenzar

Valida la instalación del agente de Google Cloud para SAP. Para obtener instrucciones, consulta la guía de instalación de tu situación.
Si instalaste el agente en un servidor de la solución Bare Metal, asegúrate de que hayas completado los requisitos previos necesarios y configurado una cuenta de servicio. Si deseas obtener instrucciones, consulta Configura el agente de Google Cloud para SAP en Linux.

Configura los roles de IAM

Para habilitar el agente de Google Cloud para SAP y recopilar las métricas de estado, debes asegurarte de que la cuenta de servicio que usa tu instancia de VM 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:

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

Ir a IAM
Selecciona tu proyecto de Google Cloud.
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 Otorgar acceso y, luego, 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.
Selecciona el rol necesario de la lista de funciones disponibles:
- Compute Engine > Visualizador de Compute
- Monitoring > Escritor de métricas de Monitoring
Haz clic en Guardar para aplicar las funciones a la cuenta de servicio.

Habilita la recopilación de métricas de estado del agente

Si deseas permitir que el agente de Google Cloud para SAP recopile las métricas de estado de su proceso daemon en tu host, sigue estos pasos:

Establece una conexión SSH con la instancia de VM del host o el servidor de la solución Bare Metal.
Habilita la recopilación de las métricas de estado del agente:
Ejecuta el comando
1. Para habilitar la recopilación de las métricas de estado del agente, ejecuta el siguiente comando:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -enable
```
2. De manera opcional, puedes modificar la frecuencia con la que el agente recopila el uso de CPU y memoria de su proceso daemon y lo envía a Cloud Monitoring. La frecuencia predeterminada es de 60 segundos.
  
  Para modificar esta frecuencia, ejecuta el siguiente comando:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_metrics_frequency=FREQUENCY
```
  Reemplaza FREQUENCY por el valor requerido, en segundos. La frecuencia no debe ser inferior a 5 segundos.
3. De manera opcional, puedes modificar la frecuencia con la que el agente verifica su estado operativo y envía esa información a Cloud Monitoring. La frecuencia predeterminada es de 60 segundos.
  
  Para modificar esta frecuencia, ejecuta el siguiente comando. La frecuencia no debe ser inferior a 5 segundos.
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_health_frequency=FREQUENCY
```
Edita el archivo de configuración
Como alternativa a la ejecución del comando del agente, puedes modificar de forma manual la configuración del agente de la siguiente manera:
1. Abre el archivo de configuración de Backint:
```
/etc/google-cloud-sap-agent/configuration.json
```
2. En la sección collection_configuration, incluye lo siguiente:
```
"collect_agent_metrics": true
```
3. De manera opcional, puedes modificar la frecuencia con la que el agente recopila el uso de CPU y memoria de su proceso daemon y lo envía a Cloud Monitoring. La frecuencia predeterminada es de 60 segundos.
  
  Para modificar esta frecuencia, incluye lo siguiente en la sección collection_configuration.
```
"agent_metrics_frequency": FREQUENCY
```
  Reemplaza FREQUENCY por el valor requerido, en segundos. La frecuencia no debe ser inferior a 5 segundos.
4. De manera opcional, puedes modificar la frecuencia con la que el agente verifica su estado operativo y envía esa información a Cloud Monitoring. La frecuencia predeterminada es de 60 segundos.
  
  Para modificar esta frecuencia, incluye lo siguiente en la sección collection_configuration. La frecuencia no debe ser inferior a 5 segundos.
```
"agent_health_frequency": FREQUENCY
```
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 VM de Compute Engine

El siguiente ejemplo es un archivo de configuración completo del agente de Google Cloud para SAP, que se ejecuta en una instancia de VM de Compute Engine, donde se habilita la recopilación de las métricas de estado del agente:

{
  "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": false,
    "collect_agent_metrics": true,
    "agent_metrics_frequency": 60,
    "agent_health_frequency": 60
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "vm-instance-1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Servidor de solución Bare Metal

El siguiente ejemplo es un archivo de configuración completo del agente de Google Cloud para SAP, que se ejecuta enun servidor de la solución Bare Metal, donde se habilita la recopilación de las métricas de estado del agente:

{
  "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,
    "collect_agent_metrics": true,
    "agent_metrics_frequency": 60,
    "agent_health_frequency": 60
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1"
    "region": "us-central1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_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 Google Cloud para SAP que son específicas de la recopilación de métricas de estado del agente:

Parámetros

Parámetros
`collection_configuration.collect_agent_metrics`	`Boolean` Opcional. Especifica `true` para permitir que el agente recopile la siguiente información y la envíe a Cloud Monitoring: Uso de memoria y CPU mediante el proceso daemon del agente en tu host. El estado operativo del proceso daemon del agente en tu host. El valor predeterminado es `false`.
`collection_configuration.agent_metrics_frequency`	`Int` Opcional. Especifica la frecuencia con la que el agente recopila el uso de CPU y memoria de su proceso daemon en el host y lo envía a Cloud Monitoring. Las métricas `sap/agent/cpu/utilization` y `sap/agent/memory/utilization` captan esta información. El valor predeterminado es `60` segundos. La frecuencia no debe ser inferior a 5 segundos.
`collection_configuration.agent_health_frequency`	`Int` Opcional. Especifica la frecuencia con la que el agente verifica su estado operativo y envía esa información a Cloud Monitoring. La métrica `sap/agent/health` captura esta información. El valor predeterminado es `60` segundos. La frecuencia no debe ser inferior a 5 segundos.

collection_configuration.collect_agent_metrics

Boolean

Opcional. Especifica true para permitir que el agente recopile la siguiente información y la envíe a Cloud Monitoring:

Uso de memoria y CPU mediante el proceso daemon del agente en tu host.
El estado operativo del proceso daemon del agente en tu host.

El valor predeterminado es false.

collection_configuration.agent_metrics_frequency

Int

Opcional. Especifica la frecuencia con la que el agente recopila el uso de CPU y memoria de su proceso daemon en el host y lo envía a Cloud Monitoring. Las métricas sap/agent/cpu/utilization y sap/agent/memory/utilization captan esta información. El valor predeterminado es 60 segundos. La frecuencia no debe ser inferior a 5 segundos.

collection_configuration.agent_health_frequency