Configurar a coleta de métricas de integridade do agente

Neste guia, mostramos como configurar o agente do Google Cloudpara SAP a fim de coletar as métricas de integridade do processo daemon do agente na instância do Compute Engine ou no servidor da Solução Bare Metal.

Para informações sobre esse recurso, consulte Coleta de métricas de integridade do agente.

Antes de começar

Funções exigidas

Para garantir que a conta de serviço tenha as permissões necessárias para permitir que o Agente do Google Cloudpara SAP colete as métricas de integridade do agente, peça ao administrador para conceder à conta de serviço os seguintes papéis do IAM no projeto:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esses papéis predefinidos contêm as permissões necessárias para permitir que o agente do Google Cloudpara SAP colete as métricas de integridade do agente. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para permitir que o Agente do Google Cloudpara SAP colete as métricas de integridade do agente:

  • Para coletar as métricas de integridade do agente da instância do host do Compute Engine e gravá-las no Cloud Monitoring: monitoring.timeSeries.create

O administrador também pode conceder essas permissões à conta de serviço com papéis personalizados ou outros papéis predefinidos.

Ativar a coleta de métricas de integridade do agente

Para permitir que o Agente do Google Cloudpara SAP colete as métricas de integridade do processo daemon no host, siga estas etapas:

  1. Estabeleça uma conexão SSH com a instância do host do Compute Engine ou o servidor da Solução Bare Metal.

  2. Ative a coleta das métricas de integridade do agente:

    Executar comando

    1. Para ativar a coleta de métricas de integridade do agente, execute o seguinte comando:

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

    2. Se quiser, modifique a frequência com que o agente coleta o uso da CPU e memória do processo daemon e os envia ao Cloud Monitoring. A frequência padrão é de 60 segundos.

      Para modificar essa frequência, execute o seguinte comando:

      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.

    3. Se quiser, modifique a frequência com que o agente verifica a integridade operacional e envia essas informações ao Cloud Monitoring. A frequência padrão é de 60 segundos.

      Para modificar essa frequência, execute o seguinte comando. A frequência não pode ser inferior a cinco segundos.

      sudo /usr/bin/google_cloud_sap_agent configure -feature=agent_metrics -agent_health_frequency=FREQUENCY

    Editar arquivo de configuração

    Como alternativa à execução do comando do agente, é possível modificar manualmente a configuração do agente conforme a seguir:

    1. Abra o arquivo de configuração do Backint:

      /etc/google-cloud-sap-agent/configuration.json
    2. Na seção collection_configuration, inclua isto:

      "collect_agent_metrics": true
    3. Se quiser, modifique a frequência com que o agente coleta o uso da CPU e memória do processo daemon e os envia ao Cloud Monitoring. A frequência padrão é de 60 segundos.

      Para modificar essa frequência, faça a seguinte inclusão na seção collection_configuration.

      "agent_metrics_frequency": FREQUENCY

      Substitua FREQUENCY pelo valor necessário em segundos. A frequência não pode ser inferior a cinco segundos.

    4. Se quiser, modifique a frequência com que o agente verifica a integridade operacional e envia essas informações ao Cloud Monitoring. A frequência padrão é de 60 segundos.

      Para modificar essa frequência, faça a seguinte inclusão na seção collection_configuration. A frequência não pode ser inferior a cinco segundos.

      "agent_health_frequency": FREQUENCY
    5. Salve o arquivo de configuração.

    6. Reinicie o agente para que as novas configurações entrem em vigor.

      sudo systemctl restart google-cloud-sap-agent

Exemplos de arquivos de configuração

Instância do Compute Engine

O exemplo a seguir é um arquivo de configuração completo do Agente para SAP doGoogle Cloudem execução em uma instância dodo Compute Engine, em que a coleta das métricas de integridade do agente está ativada:

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": false,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "collect_process_metrics": false,
    "collect_agent_metrics": true,
    "agent_metrics_frequency": 60,
    "agent_health_frequency": 60
  },
  "discovery_configuration": {
    "enable_discovery": true,
    "enable_workload_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Servidor da Solução Bare Metal

O exemplo a seguir é um arquivo de configuração completo do Agente para SAP doGoogle Cloudem execução em uma instância doservidor da Solução Bare Metal, em que a coleta das métricas de integridade do agente está ativada:

{
  "provide_sap_host_agent_metrics": true,
  "bare_metal": true,
  "log_level": "INFO",
  "log_to_cloud": true,
  "collection_configuration": {
    "collect_workload_validation_metrics": true,
    "collect_process_metrics": false,
    "collect_agent_metrics": true,
    "agent_metrics_frequency": 60,
    "agent_health_frequency": 60
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1",
    "region": "us-central1",
    "image": "rhel-8"
  },
"discovery_configuration": { "enable_discovery": true, "enable_workload_discovery": true }, "hana_monitoring_configuration": { "enabled": false } }

Parâmetros de configuração

Na tabela a seguir, explicamos os parâmetros de configuração do Agente doGoogle Cloudpara SAP específicos da coleta das métricas de integridade do agente:

Parâmetros
collection_configuration.collect_agent_metrics

Boolean

Opcional. Especifique true para permitir que o agente colete as seguintes informações e as envie ao Cloud Monitoring:

  • Uso da CPU e memória pelo processo daemon do agente no host.
  • A integridade operacional do processo daemon do agente no host.

O valor padrão é false.

collection_configuration.agent_metrics_frequency

Int

Opcional. Especifique a frequência com que o agente coleta o uso da CPU e memória do processo daemon no host e os envia ao Cloud Monitoring. Essas informações são capturadas pelas métricas sap/agent/cpu/utilization e sap/agent/memory/utilization. O valor padrão é de 60 segundos. A frequência não pode ser inferior a cinco segundos.

collection_configuration.agent_health_frequency

Int

Opcional. Especifique a frequência com que o agente verifica a integridade operacional e envia essas informações para o Cloud Monitoring. Essas informações são capturadas pela métrica sap/agent/health. O valor padrão é de 60 segundos. A frequência não pode ser inferior a cinco segundos.