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 per SAP di Google Cloud. 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. Inoltre, ogni comando di configurazione riavvia l'agente per assicurare che la modifica abbia effetto.

Limite di riavvio dell'agente

Puoi riavviare l'agente per SAP di Google Cloud fino a 3 volte in 60 secondi. Durante questo periodo di tempo, mentre puoi continuare a configurare l'agente eseguendo i comandi di configurazione, tutte le operazioni di riavvio automatico che superano questo limite avranno esito negativo 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 abbiano effetto. Per le istruzioni, consulta Riavviare l'agente.

Comandi della guida

Per stampare una guida riepilogativa per il comando google_cloud_sap_agent configure dell'agente e 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 sezione Argomenti supportati.

Per 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 sul tuo 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 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 di 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 l'utilizzo di CPU e memoria del processo del 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 l'integrità operativa e invia le informazioni a Cloud Monitoring:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_health_frequency=FREQUENCY
```

Per la raccolta di metriche di monitoraggio dei processi

Per consentire all'agente di raccogliere le metriche di Process Monitoring:

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 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 in lenta:
```
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 delle metriche di monitoraggio dei processi in cui l'agente è stato interrotto:
```
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 vuoi che l'agente riprenda a raccogliere. Usa 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_validation -enable
```
Per interrompere la raccolta delle metriche di valutazione del Gestore carichi di lavoro:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_validation -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_validation -workload_validation_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, ai fini della valutazione del Gestore carichi di lavoro:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_validation -workload_validation_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 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 interrompere 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 sull'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

Nella tabella seguente sono descritti gli argomenti che puoi utilizzare con il comando google_cloud_sap_agent configure:

Argomento	Descrizione
`-add`	Questo argomento fa sì 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`	Abilita 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_validation` `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 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 Process Monitoring in rapida evoluzione. Il valore predefinito è di `5` secondi.
`-slow_process_metrics_frequency`=`FREQUENCY`	`INT` Imposta la frequenza con cui l'agente raccoglie le metriche di Process Monitoring a variazione lenta. Il valore predefinito è di `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 interrotto 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, in secondi, delle metriche di processo di monitoraggio lenta.
`-v` o `-version`	Stampa la versione dell'agente.
`-workload_validation_metrics_frequency`=`FREQUENCY`	`INT` Imposta la frequenza con cui l'agente raccoglie le metriche di valutazione del Gestore carichi di lavoro.
`-workload_validation_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.