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

Questo documento illustra i comandi che puoi utilizzare per modificare configurazione dell'agente 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 assicurarsi 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, puoi continuare a configurare l'agente eseguendo i comandi di configurazione, ma tutte le operazioni di riavvio automatico oltre questo limite non vanno a buon fine con l'output: Could not restart the agent.

Se vedi questo output, dopo aver eseguito tutte le configurazioni devi riavviare manualmente l'agente per applicare le modifiche. Per istruzioni, vedi Riavviare l'agente.

Comandi della guida

  • Per stampare un riepilogo della guida google_cloud_sap_agent configure dell'agente ed esci:

    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 google_cloud_sap_agent configure, vedi 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 log supportati livelli: debug, info, warn o error.

Per il rilevamento del sistema SAP

  • Per consentire all'agente di raccogliere i nomi e le versioni dei prodotti SAP utilizzati dal tuo sistema SAP:

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

    Per impedire all'agente di raccogliere i nomi e le versioni dei prodotti SAP utilizzati dal sistema SAP:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -disable
  • Per consentire all'agente di inviare a Cloud Logging le informazioni sul sistema SAP rilevate: e a Gestore carichi di lavoro, se API Workload Manager sia abilitata nel tuo progetto Google Cloud:

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

    Per impedire all'agente di inviare le informazioni rilevate a Cloud Logging e Workload Manager:

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

Per la raccolta delle metriche dell'agente host SAP

  • 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 relative allo stato 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 disattivare la raccolta delle metriche relative allo stato di salute dell'agente:

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

  • Modificare la frequenza con cui l'agente raccoglie l'utilizzo di CPU e memoria. del suo 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 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 monitoraggio dei processi 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 monitoraggio dei processi con variazioni lente:

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

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

  • Per interrompere la raccolta di qualsiasi metrica di monitoraggio dei processi:

    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 avevi interruzione agente:

    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 del processo Monitoraggio delle metriche che l'agente deve riprendere a raccogliere. Utilizza la virgola per separa 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 del Gestore carichi di lavoro:
    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 di Workload Manager.

  • Per modificare la frequenza con cui l'agente deve raccogliere il database SAP HANA. metriche, per la valutazione del Gestore carichi di lavoro:

    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 di SAP HANA:

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

    Per interrompere la raccolta delle metriche di monitoraggio di 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 l'oggetto SAP HANA. Monitoraggio delle metriche:

    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 parametro fa in modo che l'agente interrompa la raccolta delle 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à dell'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 per il 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 la colonna Process Monitoring che l'agente deve interrompere la raccolta. Utilizza la virgola per separa i nomi delle metriche. Utilizza -add e -remove argomenti con -process_metrics_to_skip.

-process_metrics_frequency=FREQUENCY

INT

Imposta la frequenza con cui l'agente raccoglie in rapida evoluzione Metriche di monitoraggio dei processi. 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 in lenta evoluzione. Il valore predefinito è 30 secondi.

-query_timeout_sec=TIMEOUT

INT

Imposta il timeout della query, in secondi, per la raccolta dei dati SAP Metriche di monitoraggio HANA.

-remove

Questo argomento consente all'agente di riprendere la raccolta delle metriche di monitoraggio dei processi che hai stopped utilizzando l'argomento -process_metrics_to_skip.

-sample_interval_sec=INTERVAL

INT

Imposta la frequenza, in secondi, con cui l'agente interroga i tuoi SAP HANA e raccoglie 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 dell'aggiornamento lento Metriche di monitoraggio dei processi, in secondi.

-v o -version

Stampa la versione dell'agente.

-workload_evaluation_metrics_frequency=FREQUENCY

INT

Imposta la frequenza con cui l'agente raccoglie i dati Metriche di valutazione del Gestore carichi di lavoro.

-workload_evaluation_db_metrics_frequency=FREQUENCY

INT

Imposta la frequenza con cui l'agente raccoglie i dati SAP HANA metriche di database per la valutazione del Gestore carichi di lavoro.