Configurar a coleta de métricas de integridade do agente

Neste guia, mostramos como configurar o agente do Google Cloud para SAP para coletar as métricas de integridade do processo daemon do agente na instância de VM 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

Valide a instalação do agente do Google Cloud para SAP. Para instruções, consulte o guia de instalação para seu cenário.
Ao instalar o agente em um servidor da Solução Bare Metal, verifique se você concluiu os pré-requisitos e configurou uma conta de serviço. Para instruções, consulte Configurar o agente do Google Cloud para SAP no Linux.

Defina papéis do IAM

Para permitir que o Agente do Google Cloud para SAP colete as métricas de integridade, verifique se a conta de serviço que está sendo usada pela instância de VM do Compute Engine ou pelo servidor da Solução Bare Metal inclui os seguintes papéis:

Para adicionar esses papéis necessários à sua conta de serviço, siga estas etapas:

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

Acessar IAM
Selecione seu projeto do Google Cloud.
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.
Selecione o papel necessário na lista de papéis disponíveis:
- Compute Engine > Visualizador do Compute
- Monitoramento > Gravador da métrica de monitoramento
Clique em Salvar para aplicar os papéis à conta de serviço.

Ativar a coleta de métricas de integridade do agente

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

Estabeleça uma conexão SSH com a instância de VM do host ou o servidor da Solução Bare Metal.
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 de VM do Compute Engine

O exemplo a seguir é um arquivo de configuração completo do Agente do Google Cloud para SAP em execução emuma instância de VM do Compute Engine, em que a coleta de métricas 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": "vm-instance-1",
    "image": "rhel-8"
  },
  "discovery_configuration": {
    "enable_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 do Google Cloud para SAP em execução emum 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
  },
  "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 SAP específicas da coleta das métricas de integridade do agente:

Parâmetros

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.

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