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 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
oerror
.
Para el descubrimiento del sistema SAP
-
Para permitir que el agente recopile los nombres y las versiones de los productos SAP que usa tu sistema SAP, haz lo siguiente:
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -enable
Para evitar que el agente recopile los nombres y las versiones de los productos SAP que usa tu sistema SAP, haz lo siguiente:
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -disable
-
Para permitir que el agente envíe la información descubierta del sistema SAP a Cloud Logging y a Workload Manager si la API de Workload Manager está habilitada en tu proyecto de Google Cloud, haz lo siguiente:
sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -enable
Para evitar que el agente envíe la información descubierta a Cloud Logging y Workload Manager, 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_evaluation -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_evaluation -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_evaluation -workload_evaluation_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_evaluation -workload_evaluation_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 |
-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
|
Configura la función de agente que deseas configurar. Los siguientes son los valores admitidos:
|
-h o -help |
Muestra la información de ayuda para el comando. |
-loglevel =LOG_LEVEL
|
Establece el nivel de registro para el agente. Los valores admitidos son |
-path =PATH |
Establece la ruta de acceso para el archivo de configuración del agente: |
-process_metrics_to_skip ="LIST_OF_METRICS " |
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 |
-process_metrics_frequency =FREQUENCY |
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 |
-slow_process_metrics_frequency =FREQUENCY |
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 |
-query_timeout_sec =TIMEOUT |
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 |
-sample_interval_sec =INTERVAL |
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 |
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 |
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_evaluation_metrics_frequency =FREQUENCY |
Establece la frecuencia con la que el agente recopila las métricas de evaluación de Workload Manager. |
-workload_evaluation_db_metrics_frequency =FREQUENCY |
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. |