Comandos de configuração do agente para SAP do Google Cloud

Neste documento, mostramos os comandos que podem ser usados para modificar a configuração do agente para SAP do Google Cloud. Esses comandos são compatíveis a partir da versão 3.2 do agente.

Os comandos de configuração são uma alternativa à edição do arquivo de configuração do agente: /etc/google-cloud-sap-agent/configuration.json. Cada comando de configuração também reinicia o agente para garantir que a alteração entre em vigor.

Limite de reinicialização do agente

É possível reiniciar o agente do Google Cloud para SAP até três vezes em 60 segundos. Durante esse período, embora seja possível continuar configurando o agente executando os comandos de configuração, todas as operações de reinicialização automática além desse limite apresentarão falha com a saída: Could not restart the agent.

Se essa saída aparecer, depois de executar todos os comandos de configuração necessários, será necessário reiniciar manualmente o agente para que as mudanças entrem em vigor. Para instruções, consulte Reiniciar o agente.

Comandos de ajuda

Para imprimir uma ajuda de resumo do comando google_cloud_sap_agent configure do agente e sair:
```
sudo /usr/bin/google_cloud_sap_agent configure -help
```
Para imprimir o status dos recursos da instância do agente:
```
sudo /usr/bin/google_cloud_sap_agent configure -showall
```

Para imprimir a versão da instância do agente:

sudo /usr/bin/google_cloud_sap_agent configure -version

Para mais informações sobre os argumentos aceitos pelo comando google_cloud_sap_agent configure, consulte Argumentos compatíveis.

Para configurações de nível superior

Para configurar o agente para um servidor da Solução Bare Metal:

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

Para configurar o agente para uma instância de VM do Compute Engine:

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

Para definir o nível de geração de registros do agente:
```
sudo /usr/bin/google_cloud_sap_agent configure -loglevel=LOG_LEVEL
```
Substitua LOG_LEVEL por um dos níveis de registro compatíveis: debug, info, warn ou error.

Para permitir que o agente descubra os sistemas SAP em execução no host:

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

Para não permitir que o agente descubra seus sistemas SAP:

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

Para coleta de métricas do agente de host do SAP

Para permitir que o agente colete as métricas do agente de host do SAP, siga estas etapas:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=host_metrics -enable
```
Para interromper a coleta de métricas do agente de host do SAP:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=host_metrics -disable
```

Para a coleta de métricas de integridade do agente

Ativar a coleta das métricas de integridade do agente:

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

Para desativar a coleta de métricas de integridade do agente:

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

Para modificar a frequência com que o agente coleta o uso de CPU e memória do processo daemon e o envia ao Cloud Monitoring:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_metrics_frequency=FREQUENCY
```
Substitua FREQUENCY pelo valor necessário em segundos. A frequência não pode ser inferior a cinco segundos.
Para modificar a frequência com que o agente verifica a integridade operacional e envia essas informações ao Cloud Monitoring:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_health_frequency=FREQUENCY
```

Para a coleta de métricas de monitoramento de processos

Para permitir que o agente colete as métricas de monitoramento de processos, faça o seguinte:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -enable
```
Para interromper a coleta das métricas de monitoramento do processo:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -disable
```
Para modificar a frequência com que o agente precisa coletar as métricas de monitoramento de processos, que estão sempre mudando, siga estas etapas:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_frequency=FREQUENCY
```
Para modificar a frequência com que o agente precisa coletar as métricas de monitoramento de processos, que mudam lentamente:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -slow_process_metrics_frequency=FREQUENCY
```
Substitua FREQUENCY pela frequência, em segundos, em que o agente precisa coletar as métricas.
Para interromper a coleta de qualquer métrica de monitoramento de processos:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_to_skip="LIST_OF_METRICS" -add
```
Para retomar a coleta de qualquer métrica de monitoramento de processos em que o agente parou:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=process_metrics -process_metrics_to_skip="LIST_OF_METRICS" -remove
```
Substitua LIST_OF_METRICS pelos nomes das métricas de monitoramento do processo que você quer que o agente retome a coleta. Use uma vírgula para separar os nomes das métricas.

Para a coleta de métricas de avaliação do gerenciador de cargas de trabalho

Para permitir que o agente colete as métricas de avaliação do gerenciador de cargas de trabalho:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_validation -enable
```
Para interromper a coleta de métricas de avaliação do gerenciador de cargas de trabalho:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_validation -disable
```
Para modificar a frequência com que o agente precisa coletar as métricas de avaliação do gerenciador de cargas de trabalho:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_validation -workload_validation_metrics_frequency=FREQUENCY
```
Substitua FREQUENCY pela frequência, em segundos, em que o agente precisa coletar as métricas de avaliação do gerenciador de cargas de trabalho.
Para modificar a frequência com que o agente precisa coletar as métricas do banco de dados SAP HANA para avaliação do gerenciador de cargas de trabalho:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_validation -workload_validation_db_metrics_frequency=FREQUENCY
```
Substitua FREQUENCY pela frequência, em segundos, em que o agente precisa coletar as métricas do banco de dados do SAP HANA para a avaliação do gerenciador de cargas de trabalho.

Para a coleta de métricas de monitoramento do SAP HANA

Para permitir que o agente colete as métricas de monitoramento do SAP HANA:

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

Para interromper a coleta de métricas de monitoramento do SAP HANA:

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

Para modificar o intervalo de amostra em que o agente precisa coletar as métricas do SAP HANA Monitoring:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -sample_interval_sec=SAMPLE_INTERNAL
```
Substitua SAMPLE_INTERNAL pelo intervalo em segundos. O intervalo precisa ser de cinco segundos ou mais.
Para modificar o valor de tempo limite de uma consulta feita na sua instância do SAP HANA:
```
sudo /usr/bin/google_cloud_sap_agent configure -feature=hana_monitoring -query_timeout_sec=QUERY_TIMEOUT
```
Substitua QUERY_TIMEOUT por um valor, em segundos.

Argumentos aceitos

A tabela a seguir descreve os argumentos que você pode usar com o comando google_cloud_sap_agent configure:

Argumento	Descrição
`-add`	Esse argumento faz com que o agente pare de coletar as métricas de monitoramento de processos especificadas para o argumento `-process_metrics_to_skip`.
`-disable`	Desativa o recurso ou parâmetro especificado do agente.
`-enable`	Ativa o recurso ou parâmetro especificado do agente.
`-f`=`FEATURE_NAME` ou `-feature`=`FEATURE_NAME`	`STRING` Define o recurso do agente que você quer configurar. Confira a seguir os valores compatíveis: `host_metrics` `process_metrics` `agent_metrics` `hana_monitoring` `workload_validation` `sap_discovery`
`-h` ou `-help`	Exibe informações de ajuda sobre o comando.
`-loglevel`=`LOG_LEVEL`	`STRING` Define o nível de geração de registros do agente. Os valores compatíveis são `debug`, `infowarn` e `error`.
`-path`=`PATH`	`STRING` Define o caminho para o arquivo de configuração do agente: `/etc/google-cloud-sap-agent/configuration.json`.
`-process_metrics_to_skip`="`LIST_OF_METRICS`"	`STRING` Especifica as métricas do monitoramento de processos que o agente precisa parar de coletar. Use uma vírgula para separar os nomes das métricas. Use os argumentos `-add` e `-remove` com `-process_metrics_to_skip`.
`-process_metrics_frequency`=`FREQUENCY`	`INT` Define a frequência com que o agente coleta métricas de monitoramento de processos, que são dinâmicas. O valor padrão é de `5` segundos.
`-slow_process_metrics_frequency`=`FREQUENCY`	`INT` Define a frequência com que o agente coleta métricas de monitoramento de processos, que passam por mudanças lentas. O valor padrão é de `30` segundos.
`-query_timeout_sec`=`TIMEOUT`	`INT` Define o tempo limite da consulta, em segundos, para a coleta das métricas de monitoramento do SAP HANA.
`-remove`	Esse argumento faz com que o agente retome a coleta das métricas de monitoramento de processos que você parou usando o argumento `-process_metrics_to_skip`.
`-sample_interval_sec`=`INTERVAL`	`INT` Define a frequência, em segundos, com que o agente consulta a instância do SAP HANA e coleta as métricas de monitoramento do SAP HANA.
`-setting`=`SETTING`	`STRING` Especifica a configuração do agente que você quer definir.
`-showall`	Imprime o status dos recursos da instância do agente.
`-slow_process_metrics_frequency`=`FREQUENCY`	`INT` Especifique a frequência de coleta das métricas do monitoramento de processos com mudanças lentas, em segundos.
`-v` ou `-version`	Imprime a versão do agente.
`-workload_validation_metrics_frequency`=`FREQUENCY`	`INT` Define a frequência com que o agente coleta as métricas de avaliação do gerenciador de cargas de trabalho.
`-workload_validation_db_metrics_frequency`=`FREQUENCY`	`INT` Define a frequência com que o agente coleta as métricas do banco de dados SAP HANA para avaliação do gerenciador de cargas de trabalho.