Versão 2: configurar a coleta de métricas de avaliação do gerenciador de cargas de trabalho

Neste guia, mostramos como configurar a versão 2 do Agente do Google Cloud para SAP para coletar as métricas de avaliação do gerenciador de cargas de trabalho dos seus sistemas SAP.

Para informações sobre esse recurso, consulte Avaliação do gerenciador de cargas de trabalho usando o agente do Google Cloud para SAP.

Antes de começar

Defina papéis do IAM

Para permitir que o agente do Google Cloud para SAP colete as métricas de avaliação do gerenciador da carga de trabalho, verifique se a conta de serviço 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:

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

    Acessar IAM

  2. Selecione seu projeto do Google Cloud.

  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 Adicionar e digite o endereço de e-mail da conta do 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:

    • Leitor do Compute
    • Monitoramento > Gravador da métrica de monitoramento
    • Secret Manager > Acessador de secrets do Secret Manager
  5. Clique em Adicionar ou Salvar para aplicar os papéis à conta de serviço.

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

Para ativar a coleta de métricas de avaliação do Gerenciador de cargas de trabalho usando o agente do Google Cloud para SAP, siga estas etapas:

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

  2. Abra o arquivo de configuração do agente:

    /etc/google-cloud-sap-agent/configuration.json
  3. Na seção collection_configuration, para o parâmetro collect_workload_validation_metrics, defina o valor true.

  4. Para ativar a coleta de métricas workload.googleapis.com/sap/validation/hanasecurity que ativa as regras de avaliação de segurança no Gerenciador de cargas de trabalho, adicione a seção workload_validation_db_metrics_config após collect_workload_validation_metrics e especifique os parâmetros a seguir:

    • hana_db_user: especifique a conta de usuário usada para consultar a instância do SAP HANA.
    • hana_db_password_secret_name: especifique o nome do secret no Secret Manager que armazena a senha da conta de usuário.
    • hostname: especifique o identificador da máquina local ou remota que hospeda a instância do SAP HANA.
    • port: especifique a porta em que a instância do SAP HANA aceita consultas.

    Para informações sobre esses parâmetros, consulte Parâmetros de configuração.

  5. Como opção, na seção cloud_properties, é possível atualizar os valores de parâmetros definidos automaticamente. Para fazer isso, adicione a seção cloud_properties ao arquivo de configuração e especifique os parâmetros necessários e respectivos valores.

  6. Salve o arquivo de configuração.

  7. 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 versão 2 do agente do Google Cloud para SAP, em execução em uma servidor da Solução Bare Metal, em que a coleta de métricas de avaliação do Gerenciador de carga de trabalho 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,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false,
    "sap_system_discovery": true
  },
  "hana_monitoring_configuration": {
    "enabled": false
  }
}

Servidor da Solução Bare Metal

O exemplo a seguir é um arquivo de configuração completo versão 2 do agente do Google Cloud para SAP, em execução em uma instância de VM do Compute Engine do, em que a coleta de métricas de avaliação do Gerenciador de carga de trabalho 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,
    "workload_validation_db_metrics_frequency": 3600,
    "workload_validation_db_metrics_config": {
      "hana_db_user": "system",
      "sid": "DEH",
      "hana_db_password_secret_name": "instance-id-hana-db-password-secret",
      "hostname": "localhost",
      "port": "30015"
    },
    "collect_process_metrics": false,
    "sap_system_discovery": true
  },
  "cloud_properties": {
    "project_id": "my-project",
    "instance_name": "bms-machine-1",
    "region": "us-central1"
    "image": "rhel-8"
  },
"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 que são específicos da coleta das métricas de avaliação do Gerenciador de cargas de trabalho.

Parâmetros
provide_sap_host_agent_metrics

Boolean

Para ativar a coleta de métricas exigidas pelo agente de host SAP, especifique true. O padrão é true.
Não defina provide_sap_host_agent_metrics como false, a menos que isso seja orientado pelo Cloud Customer Care ou pelo suporte da SAP.

bare_metal

Boolean

Quando o agente for instalado em um servidor da Solução Bare Metal, especifique true. O padrão é false.

log_level

String

Para definir o nível de geração de registros do agente, defina o valor necessário. Os níveis de registro disponíveis são estes:

  • DEBUG
  • INFO
  • WARNING
  • ERROR

O padrão é INFO. Não altere o nível de geração de registros, a menos que isso seja orientado pelo Cloud Customer Care.

log_to_cloud

Boolean

Para redirecionar os registros do agente para o Cloud Logging, especifique true. O padrão é true.

sap_system_discovery

Boolean

Para ativar a descoberta do sistema SAP, especifique true. O padrão é true.

cloud_properties.project_id

String

Se o sistema SAP estiver em execução em um servidor da Solução Bare Metal, especifique o ID do projeto do Google Cloud que você está usando com a Solução Bare Metal.

Por padrão, quando o agente é executado em uma instância de VM, ele detecta o ID do projeto automaticamente.

cloud_properties.instance_name

String

Se o sistema SAP estiver em execução em uma instância de VM do Compute Engine, especifique o nome dessa instância de VM. O agente detecta automaticamente o nome da instância de VM durante a instalação.

Se o sistema SAP estiver em execução em um servidor da Solução Bare Metal, especifique o nome desse servidor. Na versão 2.5 ou anterior do agente, especifique o nome do servidor da Solução Bare Metal para a propriedade instance_id.

cloud_properties.region

String

Se o sistema SAP estiver em execução em um servidor da Solução Bare Metal, especifique a região do servidor da Solução Bare Metal.

Por padrão, quando o agente é executado em uma instância de VM, ele usa a região da instância em que o agente está instalado.

cloud_properties.zone

String

Por padrão, quando o agente é executado em uma instância de VM, ele usa a zona da instância da VM em que o agente está instalado.

cloud_properties.image

String

Especifique o nome da imagem do SO da instância.

Por padrão, quando o agente é executado em uma instância de VM, ele detecta a imagem do SO da instância de VM em que o agente está instalado.

cloud_properties.numeric_project_id

String

Especifique o ID numérico do projeto do Google Cloud em que o sistema SAP está sendo executado.

Por padrão, quando o agente é executado em uma instância de VM, ele detecta o ID numérico do projeto automaticamente.

collection_configuration.collect_workload_validation_metrics

Boolean

Para ativar a coleta de métricas de avaliação do gerenciador de cargas de trabalho, especifique true. A partir da versão 3.2, o valor padrão é true.
Esse parâmetro é aplicável somente a Linux.

collection_configuration.workload_validation_metrics_frequency

Int

A frequência de coleta das métricas de avaliação do gerenciador de cargas de trabalho em segundos. O valor padrão é de 300 segundos.

Se você precisar modificar a frequência de coleta das métricas do gerenciador de cargas de trabalho, adicione o parâmetro workload_validation_metrics_frequency na seção collection_configuration e forneça o valor necessário.

collection_configuration.workload_validation_db_metrics_config.hana_db_user

String

Especifique a conta de usuário usada para consultar a instância do SAP HANA. A conta de usuário precisa ter a permissão de leitura para o banco de dados SAP HANA.

collection_configuration.workload_validation_db_metrics_config.hana_db_password_secret_name

String

Especifique o nome do secret no Secret Manager que armazena a senha da conta de usuário.

collection_configuration.workload_validation_db_metrics_config.sid

String

Especifique o SID da instância do SAP HANA.

collection_configuration.workload_validation_db_metrics_config.hostname

String

Especifique o identificador da máquina local ou remota que hospeda a instância do SAP HANA. Confira a seguir os valores compatíveis:

  • Se o host for uma máquina local, especifique a string localhost ou o endereço IP do loopback do localhost, como 127.0.0.1.
  • Se o host for uma máquina remota, especifique o endereço IP interno ou externo.
collection_configuration.workload_validation_db_metrics_config.port

String

Especifique a porta em que a instância do SAP HANA aceita consultas. Para a primeira ou única instância do banco de dados do locatário, a porta é 3NN15, em que NN é o número da instância do SAP HANA.

collection_configuration.workload_validation_db_metrics_frequency

Int

A frequência de coleta das métricas do banco de dados SAP HANA, em segundos, para avaliação do Gerenciador de cargas de trabalho. O padrão é 3600 segundos.

Embora seja possível atualizar a frequência de coleta das métricas do banco de dados SAP HANA, recomendamos o uso do valor padrão. Se você precisar modificar o valor padrão, adicione o parâmetro workload_validation_db_metrics_frequency na seção collection_configuration e forneça o valor necessário. Não defina uma frequência de coleta maior que 3600 segundos.