Questa pagina è stata tradotta dall'API Cloud Translation.

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

Questo documento mostra i comandi che puoi utilizzare per modificare la configurazione dell'agente 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 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 tutti i comandi di configurazione richiesti, devi riavviare manualmente l'agente affinché le modifiche vengano applicate. Per istruzioni, vedi Riavviare l'agente.

Comandi di 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 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 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 la scoperta 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 le informazioni del sistema SAP rilevate a Cloud Logging e a Workload Manager se l'API Workload Manager è 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 dell'agente host SAP:

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

Per la raccolta delle metriche relative allo stato dell'agente

Per attivare la raccolta delle metriche relative allo stato 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

Per modificare la frequenza con cui l'agente raccoglie l'utilizzo della CPU e della 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 stato operativo 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 monitoraggio dei processi:

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, con 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 eventuali metriche di monitoraggio dei processi che hai interrotto con l'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 delle metriche di monitoraggio dei processi che vuoi che l'agente riprenda a raccogliere. Utilizza una virgola per separare i nomi delle metriche.

Per la raccolta delle metriche di valutazione di Workload Manager

Per consentire all'agente di raccogliere le metriche di valutazione del Gestore workload:
```
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 le metriche del database SAP HANA 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 campionamento in cui l'agente deve raccogliere le metriche di monitoraggio di SAP HANA:
```
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 del timeout per una query eseguita nell'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 specificato dell'agente.
`-enable`	Attiva la funzionalità o il parametro specificato 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 le metriche di monitoraggio dei processi che l'agente deve smettere di raccogliere. 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 in lenta evoluzione. 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 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 esegue query sull'istanza SAP HANA e raccoglie le metriche di monitoraggio di 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 delle metriche di monitoraggio dei processi invariabili, in secondi.
`-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 di Workload Manager.
`-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.