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 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 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 -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_evaluation
  • 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_evaluation_metrics_frequency=FREQUENCY

INT

Establece la frecuencia con la que el agente recopila las métricas de evaluación de Workload Manager.

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