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

Definir permissões do IAM

Para permitir que o Agente do Google Cloudpara SAP colete as métricas de integridade, verifique se a conta de serviço usada pela instância do Compute Engine ou pelo servidor da Solução Bare Metal inclui as permissões do IAM necessárias.

Para adicionar essas permissões à sua conta de serviço, siga estas etapas:

  1. No console do Google Cloud , acesse a página IAM.

    Acessar IAM

  2. Selecione seu Google Cloud projeto.

  3. Identifique a conta de serviço em que você quer incluir um papel.

    • Se a conta de serviço ainda não estiver na lista de principais, ela não terá nenhum papel atribuído a ela. Clique em Conceder acesso e insira o endereço de e-mail da conta de serviço.
    • Se a conta de serviço estiver na lista de principais, a conta de serviço já terá papéis. Clique no botão Editar da conta de serviço que você quer editar.

  4. Selecione o papel necessário na lista de papéis disponíveis:

    • Monitoramento > Gravador da métrica de monitoramento

  5. Clique em Salvar para aplicar os papéis à conta de serviço.

Para um nível granular de acesso, defina as seguintes permissões do IAM para sua própria função personalizada:

  • Coleta de métricas:
    • monitoring.timeSeries.create

Para mais informações sobre como criar um papel personalizado, consulte Criar e gerenciar papéis personalizados.

Ativar a coleta de métricas de integridade do agente

Para permitir que o Agente do Google Cloudcolete as métricas de integridade do processo daemon no seu 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 Google Cloud's Agente para SAP em execução em um instância do 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
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "instance-1",
    "image": "rhel-8"
  },
  "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 Google Cloud's Agente para SAP em execução em um servidor 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 do Google Cloud para SAPque são 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.