Comandos de configuración para el agente de Google Cloud para SAP

En este documento, se muestran los comandos que puedes usar a fin de modificar la configuración del agente de Google Cloud para SAP. Estos comandos son compatibles con la versión 3.2 del agente.

Los comandos de configuración son una alternativa a la edición del archivo de configuración del agente: /etc/google-cloud-sap-agent/configuration.json. Cada comando de configuración también reinicia el agente para garantizar que el cambio se aplique.

Límite de reinicio del agente

Puedes reiniciar el agente de Google Cloud para SAP hasta 3 veces en 60 segundos. Durante este período, mientras puedes continuar con la configuración del agente mediante la ejecución de los comandos de configuración, todas las operaciones de reinicio automático que superen este límite fallarán con el resultado Could not restart the agent.

Si ves este resultado, después de ejecutar todos los comandos de configuración necesarios, debes reiniciar el agente de forma manual para que se apliquen los cambios. Para obtener instrucciones, consulta Reinicia el agente.

Comandos de ayuda

Para imprimir una ayuda resumida para el comando google_cloud_sap_agent configure del agente y salir, haz lo siguiente:
```
sudo /usr/bin/google_cloud_sap_agent configure -help
```
Para imprimir el estado de las funciones de tu instancia de agente, sigue estos pasos:
```
sudo /usr/bin/google_cloud_sap_agent configure -showall
```
Para imprimir la versión de tu instancia de agente, sigue estos pasos:
```
sudo /usr/bin/google_cloud_sap_agent configure -version
```

Para obtener información sobre los argumentos compatibles con el comando google_cloud_sap_agent configure, consulta Argumentos admitidos.

Para la configuración de nivel superior

Para configurar el agente para un servidor de la solución Bare Metal, haz lo siguiente:
```
sudo /usr/bin/google_cloud_sap_agent configure -setting=bare_metal -enable
```
Para configurar el agente de una instancia de VM de Compute Engine, sigue estos pasos:
```
sudo /usr/bin/google_cloud_sap_agent configure -setting=bare_metal -disable
```
Para configurar el nivel de registro del agente, sigue estos pasos:
```
sudo /usr/bin/google_cloud_sap_agent configure -loglevel=LOG_LEVEL
```
Reemplaza LOG_LEVEL por uno de los niveles de registro compatibles: debug, info, warn o error.
Para permitir que el agente descubra los sistemas SAP que se ejecutan en el host, haz lo siguiente:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -enable
```
Para no permitir que el agente descubra tus sistemas SAP, haz lo siguiente:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -disable
```

Para la recopilación de métricas de SAP Host Agent

Para permitir que el agente recopile las métricas de SAP Host Agent, sigue estos pasos:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=host_metrics -enable
```
Para detener la recopilación de las métricas de SAP Host Agent, haz lo siguiente:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=host_metrics -disable
```

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

Para habilitar la recopilación de las métricas de estado del agente:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -enable
```
Para inhabilitar la recopilación de las métricas de estado del agente, sigue estos pasos:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -disable
```
Para modificar la frecuencia con la que el agente recopila el uso de memoria y CPU de su proceso daemon y los envía a Cloud Monitoring, haz lo siguiente:
```
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.
Para modificar la frecuencia con la que el agente verifica su estado operativo y envía esa información a Cloud Monitoring, haz lo siguiente:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_health_frequency=FREQUENCY
```

Para la recopilación de métricas de supervisión de procesos

Para permitir que el agente recopile las métricas de supervisión de procesos, haz lo siguiente:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable
```
Para detener la recopilación de las métricas de supervisión de procesos, haga lo siguiente:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -disable
```
Para modificar la frecuencia con la que el agente debe recopilar las métricas de supervisión de procesos que cambian con rapidez, haz lo siguiente:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_frequency=FREQUENCY
```
Para modificar la frecuencia con la que el agente debe recopilar las métricas de supervisión de procesos que cambian lentamente, haz lo siguiente:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -slow_process_metrics_frequency=FREQUENCY
```
Reemplaza FREQUENCY por la frecuencia, en segundos, con la que el agente debe recopilar las métricas.
Para detener la recopilación de cualquier métrica de Monitoring, haz lo siguiente:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_to_skip="LIST_OF_METRICS" -add
```
Para reanudar la recopilación de cualquier métrica de Monitoring de procesos en la que hayas detenido el agente, haz lo siguiente:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_to_skip="LIST_OF_METRICS" -remove
```
Reemplaza LIST_OF_METRICS por los nombres de las métricas de supervisión de procesos que deseas que el agente continúe recopilando. Usa una coma para separar los nombres de las métricas.

Para la recopilación de métricas de evaluación de Workload Manager

Para permitir que el agente recopile las métricas de evaluación del Administrador de cargas de trabajo, haz lo siguiente:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_validation -enable
```
Para detener la recopilación de las métricas de evaluación de Workload Manager, haz lo siguiente:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_validation -disable
```
Para modificar la frecuencia con la que el agente debe recopilar las métricas de evaluación de Workload Manager, haz lo siguiente:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_validation -workload_validation_metrics_frequency=FREQUENCY
```
Reemplaza FREQUENCY por la frecuencia, en segundos, con la que el agente debe recopilar las métricas de evaluación del administrador de cargas de trabajo.
A fin de modificar la frecuencia con la que el agente debe recopilar las métricas de la base de datos de SAP HANA para la evaluación de Workload Manager, haz lo siguiente:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_validation -workload_validation_db_metrics_frequency=FREQUENCY
```
Reemplaza FREQUENCY por la frecuencia, en segundos, con la que el agente debe recopilar las métricas de la base de datos de SAP HANA para la evaluación de Workload Manager.

Para la recopilación de métricas de supervisión de SAP HANA

Para permitir que el agente recopile las métricas de supervisión de SAP HANA:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable
```
Para detener la recopilación de las métricas de supervisión de SAP HANA, haz lo siguiente:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -disable
```
Para modificar el intervalo de muestra en el que el agente debe recopilar las métricas de supervisión de SAP HANA, haz lo siguiente:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -sample_interval_sec=SAMPLE_INTERNAL
```
Reemplaza SAMPLE_INTERNAL por el intervalo, en segundos. El intervalo debe ser de 5 segundos o más.
Para modificar el valor de tiempo de espera de una consulta realizada a tu instancia de SAP HANA, sigue estos pasos:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -query_timeout_sec=QUERY_TIMEOUT
```
Reemplaza QUERY_TIMEOUT por un valor, en segundos.

Argumentos admitidos

En la siguiente tabla, se describen los argumentos que puedes usar con el comando google_cloud_sap_agent configure:

Argumento	Descripción
`-add`	Este argumento hace que el agente deje de recopilar las métricas de supervisión de procesos que especificas para el argumento `-process_metrics_to_skip`.
`-disable`	Inhabilita la función o el parámetro especificado del agente.
`-enable`	Habilita la función o el parámetro especificados del agente.
`-f`=`FEATURE_NAME` o `-feature`=`FEATURE_NAME`	`STRING` Configura la función de agente que deseas configurar. Los siguientes son los valores admitidos: `host_metrics` `process_metrics` `agent_metrics` `hana_monitoring` `workload_validation` `sap_discovery`
`-h` o `-help`	Muestra la información de ayuda para el comando.
`-loglevel`=`LOG_LEVEL`	`STRING` Establece el nivel de registro para el agente. Los valores admitidos son `debug`, `info`, `warn` y `error`.
`-path`=`PATH`	`STRING` Establece la ruta de acceso para el archivo de configuración del agente: `/etc/google-cloud-sap-agent/configuration.json`.
`-process_metrics_to_skip`="`LIST_OF_METRICS`"	`STRING` Especifica las métricas de supervisión de procesos que el agente debe dejar de recopilar. Usa una coma para separar los nombres de las métricas. Usa los argumentos `-add` y `-remove` con `-process_metrics_to_skip`.
`-process_metrics_frequency`=`FREQUENCY`	`INT` Establece la frecuencia con la que el agente recopila las métricas de supervisión de procesos que cambian con rapidez. El valor predeterminado es `5` segundos.
`-slow_process_metrics_frequency`=`FREQUENCY`	`INT` Establece la frecuencia con la que el agente recopila las métricas de supervisión de procesos que cambian con lentitud. El valor predeterminado es `30` segundos.
`-query_timeout_sec`=`TIMEOUT`	`INT` Establece el tiempo de espera de la consulta, en segundos, para la recopilación de las métricas de supervisión de SAP HANA.
`-remove`	Este argumento hace que el agente reanude la recopilación de las métricas de Process Monitoring que detuviste mediante el argumento `-process_metrics_to_skip`.
`-sample_interval_sec`=`INTERVAL`	`INT` Establece la frecuencia, en segundos, con la que el agente consulta tu instancia de SAP HANA y recopila las métricas de supervisión de SAP HANA.
`-setting`=`SETTING`	`STRING` Especifica la configuración del agente que deseas configurar.
`-showall`	Imprime el estado de las funciones de la instancia del agente.
`-slow_process_metrics_frequency`=`FREQUENCY`	`INT` Especifica la frecuencia de recopilación de las métricas de Process Monitoring que cambian lentamente, en segundos.
`-v` o `-version`	Imprime la versión del agente.
`-workload_validation_metrics_frequency`=`FREQUENCY`	`INT` Establece la frecuencia con la que el agente recopila las métricas de evaluación de Workload Manager.
`-workload_validation_db_metrics_frequency`=`FREQUENCY`	`INT` Establece la frecuencia con la que el agente recopila las métricas de la base de datos de SAP HANA para la evaluación de Workload Manager.