Comandi di configurazione per l'agente di Google Cloud per SAP

Questo documento mostra i comandi che puoi utilizzare per modificare la configurazione di Agent di Google Cloud per SAP. Questi comandi sono supportati dalla versione 3.2 dell'agente.

I comandi di configurazione sono un'alternativa alla modifica del file di configurazione dell'agente: /etc/google-cloud-sap-agent/configuration.json. Ogni comando di configurazione riavvia anche l'agente per garantire che la modifica venga applicata.

Limite di riavvio dell'agente

Puoi riavviare l'agente di Google Cloud per SAP fino a 3 volte in 60 secondi. Durante questo periodo di tempo, anche se puoi continuare a configurare l'agente eseguendo i comandi di configurazione, tutte le operazioni di riavvio automatico oltre questo limite non andranno a buon fine e restituiranno l'output: Could not restart the agent.

Se vedi questo output, dopo aver eseguito tutti i comandi di configurazione richiesti, devi riavviare manualmente l'agente affinché le modifiche abbiano effetto. Per le istruzioni, vedi Riavviare l'agente.

Comandi della guida

  • Per stampare una guida di riepilogo per il comando google_cloud_sap_agent configure dell'agente ed uscire:

    sudo /usr/bin/google_cloud_sap_agent configure -help
  • Per stampare lo stato delle funzionalità dell'istanza dell'agente:

    sudo /usr/bin/google_cloud_sap_agent configure -showall
  • Per stampare la versione dell'istanza dell'agente:

    sudo /usr/bin/google_cloud_sap_agent configure -version

Per informazioni sugli argomenti supportati dal comando google_cloud_sap_agent configure, consulta la pagina Argomenti supportati.

Per le impostazioni di primo livello

  • Per configurare l'agente per un server Bare Metal Solution:
    sudo /usr/bin/google_cloud_sap_agent configure -setting=bare_metal -enable

    Per configurare l'agente per un'istanza VM di Compute Engine:

    sudo /usr/bin/google_cloud_sap_agent configure -setting=bare_metal -disable

  • Per impostare il livello di logging dell'agente:

    sudo /usr/bin/google_cloud_sap_agent configure -loglevel=LOG_LEVEL

    Sostituisci LOG_LEVEL con uno dei livelli di log supportati: debug, info, warn o error.

  • Per consentire all'agente di rilevare i sistemi SAP in esecuzione sull'host:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -enable

    Per non consentire all'agente di rilevare i tuoi sistemi SAP:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=sap_discovery -disable

Per la raccolta delle metriche di SAP Host Agent

  • Per consentire all'agente di raccogliere le metriche dell'agente host SAP:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=host_metrics -enable

    Per interrompere la raccolta delle metriche di SAP Host Agent:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=host_metrics -disable

Per la raccolta delle metriche di integrità dell'agente

  • Per abilitare la raccolta delle metriche di integrità dell'agente:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -enable

    Per disabilitare la raccolta delle metriche di integrità dell'agente:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -disable

  • Per modificare la frequenza con cui l'agente raccoglie la CPU e la memoria utilizzata del proprio processo daemon e li invia a Cloud Monitoring:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_metrics_frequency=FREQUENCY

    Sostituisci FREQUENCY con il valore richiesto, in secondi. La frequenza non deve essere inferiore a 5 secondi.

  • Per modificare la frequenza con cui l'agente controlla il proprio integrità operativa e invia queste informazioni a Cloud Monitoring:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_health_frequency=FREQUENCY

Per la raccolta delle metriche di monitoraggio dei processi

  • Per consentire all'agente di raccogliere le metriche di monitoraggio dei processi:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable

    Per interrompere la raccolta delle metriche di Process Monitoring:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -disable
  • Per modificare la frequenza con cui l'agente deve raccogliere le metriche di Process Monitoring in rapida evoluzione:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_frequency=FREQUENCY

    Per modificare la frequenza con cui l'agente deve raccogliere le metriche di Process Monitoring che cambiano lentamente:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -slow_process_metrics_frequency=FREQUENCY

    Sostituisci FREQUENCY con la frequenza, in secondi, con cui l'agente deve raccogliere le metriche.

  • Per interrompere la raccolta di metriche di Process Monitoring:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_to_skip="LIST_OF_METRICS" -add

    Per riprendere la raccolta di tutte le metriche di Process Monitoring che l'agente ha arrestato:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_to_skip="LIST_OF_METRICS" -remove

    Sostituisci LIST_OF_METRICS con i nomi delle metriche di Process Monitoring che l'agente deve riprendere a raccogliere. Utilizza una virgola per separare i nomi delle metriche.

Per la raccolta delle metriche di valutazione del Gestore carichi di lavoro

  • Per consentire all'agente di raccogliere le metriche di valutazione di Workload Manager:
    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -enable
  • Per interrompere la raccolta delle metriche di valutazione del Gestore carichi di lavoro:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -disable
  • Per modificare la frequenza con cui l'agente deve raccogliere le metriche di valutazione di Workload Manager:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -workload_evaluation_metrics_frequency=FREQUENCY

    Sostituisci FREQUENCY con la frequenza, in secondi, con cui l'agente deve raccogliere le metriche di valutazione del Gestore carichi di lavoro.

  • Per modificare la frequenza con cui l'agente deve raccogliere le metriche del database SAP HANA, per la valutazione di Workload Manager:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_evaluation -workload_evaluation_db_metrics_frequency=FREQUENCY

    Sostituisci FREQUENCY con la frequenza, in secondi, con cui l'agente deve raccogliere le metriche del database SAP HANA per la valutazione di Workload Manager.

Per la raccolta delle metriche di monitoraggio di SAP HANA

  • Per consentire all'agente di raccogliere le metriche di monitoraggio SAP HANA:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -enable

    Per arrestare la raccolta delle metriche di monitoraggio SAP HANA:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -disable
  • Per modificare l'intervallo di esempio in cui l'agente deve raccogliere le metriche di SAP HANA Monitoring:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -sample_interval_sec=SAMPLE_INTERNAL

    Sostituisci SAMPLE_INTERNAL con l'intervallo, in secondi. L'intervallo deve essere di almeno 5 secondi.

  • Per modificare il valore di timeout per una query effettuata sulla tua istanza SAP HANA:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -query_timeout_sec=QUERY_TIMEOUT

    Sostituisci QUERY_TIMEOUT con un valore, in secondi.

Argomenti supportati

La seguente tabella descrive gli argomenti che puoi utilizzare con il comando google_cloud_sap_agent configure:

Argomento Descrizione
-add

Questo argomento impedisce all'agente di raccogliere le metriche di monitoraggio dei processi specificate per l'argomento -process_metrics_to_skip.

-disable

Disattiva la funzionalità o il parametro specificati dell'agente.

-enable

Abilita la funzionalità o il parametro specificati dell'agente.

-f=FEATURE_NAME
o
-feature=FEATURE_NAME

STRING

Imposta la funzionalità di agente che vuoi configurare. Di seguito sono riportati i valori supportati:

  • host_metrics
  • process_metrics
  • agent_metrics
  • hana_monitoring
  • workload_evaluation
  • sap_discovery
-h o -help

Visualizza le informazioni della guida relative al comando.

-loglevel=LOG_LEVEL

STRING

Imposta il livello di logging per l'agente. I valori supportati sono: debug, info, warn e error.

-path=PATH

STRING

Imposta il percorso del file di configurazione dell'agente: /etc/google-cloud-sap-agent/configuration.json.

-process_metrics_to_skip="LIST_OF_METRICS"

STRING

Specifica le metriche di monitoraggio dei processi che l'agente deve interrompere la raccolta. Utilizza una virgola per separare i nomi delle metriche. Utilizza gli argomenti -add e -remove con -process_metrics_to_skip.

-process_metrics_frequency=FREQUENCY

INT

Imposta la frequenza con cui l'agente raccoglie le metriche di monitoraggio dei processi in rapida evoluzione. Il valore predefinito è 5 secondi.

-slow_process_metrics_frequency=FREQUENCY

INT

Imposta la frequenza con cui l'agente raccoglie le metriche di monitoraggio dei processi che cambiano lentamente. Il valore predefinito è 30 secondi.

-query_timeout_sec=TIMEOUT

INT

Imposta il timeout della query, in secondi, per la raccolta delle metriche di monitoraggio SAP HANA.

-remove

Questo argomento fa sì che l'agente riprenda la raccolta delle metriche di monitoraggio dei processi che hai interrotto utilizzando l'argomento -process_metrics_to_skip.

-sample_interval_sec=INTERVAL

INT

Imposta la frequenza, in secondi, con cui l'agente esegue una query sull'istanza SAP HANA e raccoglie le metriche di monitoraggio SAP HANA.

-setting=SETTING

STRING

Specifica l'impostazione dell'agente che vuoi configurare.

-showall

Stampa lo stato delle funzionalità dell'istanza dell'agente.

-slow_process_metrics_frequency=FREQUENCY

INT

Imposta la frequenza di raccolta in secondi delle metriche di monitoraggio dei processi che cambiano lentamente.

-v o -version

Stampa la versione dell'agente.

-workload_evaluation_metrics_frequency=FREQUENCY

INT

Imposta la frequenza con cui l'agente raccoglie le metriche di valutazione del Gestore carichi di lavoro.

-workload_evaluation_db_metrics_frequency=FREQUENCY

INT

Imposta la frequenza con cui l'agente raccoglie le metriche del database SAP HANA per la valutazione di Workload Manager.