En esta guía, se muestra cómo configurar el agente de Google Cloudpara SAP a fin de recopilar las métricas de estado del proceso daemon del agente en tu instancia 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 Cloudpara 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 Cloudpara SAP en Linux.
Roles obligatorios
Para garantizar que la cuenta de servicio tenga los permisos necesarios para permitir que el agente de Google Cloudpara SAP recopile métricas de estado del agente, pídele a tu administrador que le otorgue a la cuenta de servicio los siguientes roles de IAM en tu proyecto:
-
Escritor de métricas de Monitoring (
roles/monitoring.metricWriter
): Para escribir las métricas recopiladas en Cloud Monitoring.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Estos roles predefinidos contienen los permisos necesarios para permitir que el agente de Google Cloudpara SAP recopile métricas de estado del agente. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para permitir que el agente de Google Cloudpara SAP recopile métricas de estado del agente:
-
Para recopilar las métricas de estado del agente de la instancia de Compute Engine host y escribirlas en Cloud Monitoring, sigue estos pasos:
monitoring.timeSeries.create
Es posible que tu administrador también pueda otorgar estos permisos a la cuenta de servicio con roles personalizados o con otros roles predefinidos.
Habilita la recopilación de métricas de estado del agente
Si deseas permitir que el agente de Google Cloudpara SAP recopile las métricas de estado de su proceso daemon en tu host, sigue estos pasos:
Establece una conexión SSH con tu instancia de Compute Engine 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
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
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.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:
Abre el archivo de configuración de Backint:
/etc/google-cloud-sap-agent/configuration.json
En la sección
collection_configuration
, incluye lo siguiente:"collect_agent_metrics": true
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.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
Guarda el archivo de configuración.
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
El siguiente ejemplo es un archivo de configuración completo del agente deGoogle Cloudpara SAP que se ejecuta en una instanciade Compute Engine, en el que 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 }, "discovery_configuration": { "enable_discovery": true, "enable_workload_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 deGoogle Cloudpara SAP que se ejecuta en una instanciade un servidor de la solución Bare Metal, en el que 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, "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 deGoogle Cloudpara SAP que son específicos de la recopilación de métricas de estado del agente:
Parámetros | |
---|---|
collection_configuration.collect_agent_metrics |
Opcional. Especifica
El valor predeterminado es |
collection_configuration.agent_metrics_frequency |
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 |
collection_configuration.agent_health_frequency |
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 |