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 descoberta do sistema SAP

  • Para permitir que o agente colete os nomes e as versões dos produtos SAP usados pelo sistema SAP:

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

    Para impedir que o agente colete os nomes e as versões dos produtos SAP usados pelo sistema SAP:

    sudo /usr/bin/google_cloud_sap_agent configure -feature=workload_discovery -disable
  • Para permitir que o agente envie as informações do sistema SAP descobertos para o Cloud Logging e o gerenciador de cargas de trabalho se a API Workload Manager estiver ativada no seu projeto do Google Cloud:

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

    Para impedir que o agente envie as informações descobertas para o Cloud Logging e o Workload Manager:

    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_evaluation -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_evaluation -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_evaluation -workload_evaluation_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_evaluation -workload_evaluation_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_evaluation
  • 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_evaluation_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_evaluation_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.