Neste guia, mostramos como configurar o 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
- 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.
Verifique se a API Workload Manager está ativada no seu projeto do Google Cloud.
Definir 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:
- Leitor do Compute (
roles/compute.viewer
) - Gravador de insights do gerenciador de cargas de trabalho (
roles/workloadmanager.insightWriter
) - Acessador de secrets do Secret Manager (
roles/secretmanager.secretAccessor
), se você usa o Secret Manager para armazenar senhas do banco de dados do SAP HANA.
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.
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 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.
Selecione o papel necessário na lista de papéis disponíveis:
- Leitor do Compute
- Gerenciador de cargas de trabalho > Gravador de insights do gerenciador de cargas de trabalho
- Secret Manager > Acessador de secrets do Secret Manager
Clique em Adicionar ou Salvar para aplicar os papéis à conta de serviço.
Verificar a versão do agente
O Google Cloud recomenda que você instale a versão mais recente do agente do Google Cloud para SAP para uma avaliação precisa das suas cargas de trabalho SAP, porque versões periódicas do agente para SAP podem adicionar ou alterar as métricas usadas para a avaliação.
Para garantir que você tenha a versão mais recente do agente do Google Cloud para SAP, é preciso verificar as atualizações periodicamente e atualizar o agente.
Instalar uma atualização
Selecione seu sistema operacional e siga estas etapas:
RHEL
- Estabeleça uma conexão SSH com sua instância.
- Atualize a instância do agente:
- (Recomendado) Para atualizar para a versão 3.5 (mais recente)
do agente:
sudo yum --nogpgcheck update google-cloud-sap-agent
- Para atualizar para uma versão específica do agente:
sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64
Substitua
VERSION_NUMBER
pelo número da versão do agente que você quer instalar, como3.1-606637668
. Para informações sobre as versões do agente que podem ser instaladas, consulte Listar todas as versões disponíveis do agente.
- (Recomendado) Para atualizar para a versão 3.5 (mais recente)
do agente:
SLES
- Estabeleça uma conexão SSH com sua instância.
- Atualize a instância do agente:
- (Recomendado) Para atualizar para a versão 3.5 (mais recente)
do agente:
sudo zypper --no-gpg-checks update google-cloud-sap-agent
- Para atualizar para uma versão específica do agente:
sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64
Substitua
VERSION_NUMBER
pelo número da versão do agente que você quer instalar, como3.1-606637668
. Para informações sobre as versões do agente que podem ser instaladas, consulte Listar todas as versões disponíveis do agente.
- (Recomendado) Para atualizar para a versão 3.5 (mais recente)
do agente:
Ativar a coleta de métricas de avaliação do gerenciador de cargas de trabalho
A partir da versão 3.2, as novas instalações do agente do Google Cloud para SAP são ativadas por padrão para coletar as métricas de avaliação do gerenciador de cargas de trabalho. Se você estiver atualizando de uma versão anterior para a 3.2, também poderá ativar explicitamente o recurso. Para isso, siga as etapas abaixo:
Estabeleça uma conexão SSH com a instância de VM do Compute Engine ou o servidor da Solução Bare Metal.
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 ativar a coleta das métricas "Insights do SAP HANA" e "Práticas recomendadas de segurança do SAP HANA":
Abra o arquivo de configuração do agente:
/etc/google-cloud-sap-agent/configuration.json
Como alternativa, também é possível realizar essa configuração executando comandos. Para mais informações, consulte Comandos de configuração do agente do Google Cloud para SAP.
Adicione a seção
workload_validation_db_metrics_config
apóscollect_workload_validation_metrics
e especifique os parâmetros abaixo:hana_db_user
: especifique a conta de usuário do banco de dados do SAP HANA que é usada para consultar a instância do SAP HANA.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.sid
: especifique o SID da 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árioComo alternativa ao secret, use o parâmetro de configuração
hdbuserstore_key
.hdbuserstore_key
: especifique a chavehdbuserstore
que autentica o usuário especificado parahana_db_user
.Se você especificar
hdbuserstore_key
, a especificação dos parâmetroshostname
eport
será ignorada.
Para informações sobre esses parâmetros, consulte Parâmetros de configuração.
Como opção, na seção
cloud_properties
, é possível atualizar os valores de parâmetros definidos automaticamente. Para fazer isso, adicione a seçãocloud_properties
ao arquivo de configuração e especifique os parâmetros necessários e respectivos valores.Salve o arquivo de configuração.
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 no uma instância de VM do Compute Engine, em que a coleta de avaliação do Workload Manager de processos 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", "hdbuserstore_key": "user_store_key",
"hana_db_password_secret_name": "instance-id-hana-db-password-secret", "hostname": "localhost", "port": "30015" }, "collect_process_metrics": false }, "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 do Google Cloud para SAP, em execução no servidor da Solução Bare Metal, em que a coleta de avaliação do Workload Manager de processos 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", "hdbuserstore_key": "user_store_key",
"hana_db_password_secret_name": "instance-id-hana-db-password-secret", "hostname": "localhost", "port": "30015" }, "collect_process_metrics": false }, "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 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 |
Para ativar a coleta de métricas exigidas pelo
agente de host SAP, especifique |
bare_metal |
Quando o agente for instalado em um servidor da Solução Bare Metal, especifique
|
log_level |
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:
O padrão é |
log_to_cloud |
Para redirecionar os registros do agente para o
Cloud Logging, especifique
|
cloud_properties.project_id |
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. |
cloud_properties.instance_name
|
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. |
cloud_properties.region |
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. |
cloud_properties.zone |
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 |
Especifique o nome da imagem do SO da instância. |
cloud_properties.numeric_project_id |
Especifique o ID numérico do projeto do Google Cloud em que o sistema SAP
está sendo executado. |
discovery_configuration.enable_workload_discovery |
Para permitir que o agente colete os nomes e as versões dos produtos SAP em execução no host, especifique Para mais informações, consulte a base de código do agente no
repositório |
discovery_configuration.enable_discovery |
Para enviar ao Cloud Logging as informações coletadas pelo agente sobre os produtos SAP em execução no host, especifique Se você especificar o valor |
collection_configuration.collect_workload_validation_metrics |
Para ativar a coleta de métricas de avaliação do gerenciador de cargas de trabalho, especifique |
collection_configuration.workload_validation_metrics_frequency |
A frequência de coleta das métricas de avaliação do gerenciador de cargas de trabalho em segundos. O valor padrão é de Se você precisar modificar a frequência de coleta das
métricas do gerenciador de cargas de trabalho, adicione o parâmetro
|
collection_configuration.workload_validation_collection_definition.fetch_latest_config |
Opcional. O valor padrão é |
collection_configuration.workload_validation_db_metrics_config.hana_db_user |
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 |
Especifique o nome do secret no Secret Manager que armazena a senha da conta de usuário. Como alternativa, é possível especificar o parâmetro de configuração |
collection_configuration.workload_validation_db_metrics_config.hdbuserstore_key
|
Para se conectar com segurança a um sistema SAP HANA, especifique um
Proteger a chave do repositório de usuários ( Para usar uma chave
Esse parâmetro de configuração é compatível com a versão 3.3 do agente. Se você especificar |
collection_configuration.workload_validation_db_metrics_config.sid |
Especifique o SID da instância do SAP HANA. |
collection_configuration.workload_validation_db_metrics_config.hostname |
Especifique o identificador da máquina local ou remota que hospeda a instância do SAP HANA. Confira a seguir os valores compatíveis:
|
collection_configuration.workload_validation_db_metrics_config.port |
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 é
|
collection_configuration.workload_validation_db_metrics_frequency |
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 é |
Acessar as métricas coletadas
Para visualizar as métricas de avaliação do gerenciador de cargas de trabalho que o agente coleta, faça o seguinte:
Consulte o arquivo de registros do agente:
Defina o nível de registro do agente como
DEBUG
:sudo /usr/bin/google_cloud_sap_agent configure -loglevel=debug
Consulte os registros do agente após a reinicialização para alterar o nível de registro arquivo:
/var/log/google-cloud-sap-agent.log
No arquivo de registro, procure entradas que contenham o seguinte:
workload.googleapis.com/sap/validation/
Este é um exemplo que mostra o gerenciador de cargas de trabalho métricas de avaliação no arquivo de registros do agente:
{"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
"metric":"workload.googleapis.com/sap/validation/system","value":1} {"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
"key":"instance_name","value":"n1-hana-sles15"} {"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
"key":"os","value":"sles-15-SP4"} ... {"level":"debug","timestamp":"2024-05-31T20:13:39.439Z",..."context":"WorkloadManagerMetrics",
"metric":"workload.googleapis.com/sap/validation/corosync","value":0} ...
Se a instância do agente estiver configurada para enviar registros ao Cloud Logging: é possível visualizar os registros do agente no Cloud Logging.
Crie e execute uma avaliação para sua carga de trabalho SAP no Gerenciador de cargas de trabalho. Para mais informações, consulte Crie e execute uma avaliação.
Para informações sobre as práticas recomendadas compatíveis com o Gerenciador de cargas de trabalho para avaliar cargas de trabalho do SAP em execução no Google Cloud, consulte Práticas recomendadas do Gerenciador de cargas de trabalho para SAP.