O agente do Google Cloud para SAP é necessário para o suporte de sistemas SAP em execução em um servidor da Solução Bare Metal.
Se você usar as seguintes imagens de SO do RHEL ou do SLES "for SAP" fornecidas pelo Google Cloud, o agente do Google Cloud para SAP será empacotado com as imagens do SO:
- RHEL: todas as imagens "for SAP"
- SLES: SLES 15 SP4 para SAP e versões posteriores
Para informações sobre os sistemas operacionais disponíveis para executar o SAP em servidores da Solução Bare Metal, consulte:
- Para o SAP HANA, consulte Sistemas operacionais certificados.
- Para o SAP NetWeaver, consulte Sistemas operacionais certificados.
Para instalar e configurar a versão 3.2 (mais recente) do agente do Google Cloud para SAP em uma instância de VM do Compute Engine, consulte Instalar o agente do Google Cloud para SAP em uma instância de VM do Compute Engine.
Visão geral da instalação
Instale o agente do Google Cloud para SAP usando comandos padrão de gerenciamento de pacotes do sistema operacional: no RHEL, o comando yum
. No SLES, o comando zypper
. O comando de gerenciamento de pacotes conclui as seguintes tarefas:
- Faz o download da versão mais recente do agente do Google Cloud para SAP.
- Cria o agente como um serviço
systemd
do Linux, chamadogoogle-cloud-sap-agent
. - Ativa e inicia o serviço
google-cloud-sap-agent
.
Instalar o agente
Para instalar o agente do Google Cloud para SAP em um servidor da Solução Bare Metal, siga estas etapas:
Estabeleça uma conexão SSH com o servidor da Solução Bare Metal.
No seu terminal, instale o agente executando o comando específico para seu sistema operacional:
- (Recomendado) Para instalar a versão 3.2 (mais recente) do agente:
RHEL
sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM [google-cloud-sap-agent] name=Google Cloud Agent for SAP baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-\\$basearch enabled=1 gpgcheck=1 repo_gpgcheck=1 gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg EOM sudo yum install google-cloud-sap-agent
SLES
sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-\\$basearch google-cloud-sap-agent sudo zypper install google-cloud-sap-agent
SLES 12
sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-\\$basearch google-cloud-sap-agent sudo zypper install google-cloud-sap-agent
Para instalar uma versão específica do agente:
RHEL
sudo tee /etc/yum.repos.d/google-cloud-sap-agent.repo << EOM [google-cloud-sap-agent] name=Google Cloud Agent for SAP baseurl=https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-el$(cat /etc/redhat-release | cut -d . -f 1 | tr -d -c 0-9)-\\$basearch enabled=1 gpgcheck=1 repo_gpgcheck=1 gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg EOM sudo yum install google-cloud-sap-agent-VERSION_NUMBER.x86_64
SLES
sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-\\$basearch google-cloud-sap-agent sudo zypper install google-cloud-sap-agent-VERSION_NUMBER.x86_64
SLES 12
sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles12-\\$basearch google-cloud-sap-agent 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 instalar a versão 3.2 (mais recente) do agente:
Abra o seguinte arquivo de configuração:
/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.
Modifique ou adicione os seguintes parâmetros ao arquivo de configuração:
- Na primeira seção:
- Defina
bare_metal
comotrue
.
- Defina
- Adicione a seção
cloud_properties
e especifique os seguintes parâmetros:project_id
: especifique seu projeto do Google Cloudinstance_name
: especifique o nome do servidor da Solução Bare Metal.region
: especifique a região do servidor da Solução Bare Metal
- Na primeira seção:
Salve o arquivo de configuração.
Reinicie o agente:
sudo systemctl restart google-cloud-sap-agent
Depois de instalar o agente do Google Cloud para SAP e o agente de host da SAP, valide a instalação do agente do Google Cloud para SAP, conforme descrito em Validar a instalação do agente.
Validar a instalação do agente
Estabeleça uma conexão SSH com o servidor da Solução Bare Metal.
Execute este comando:
systemctl status google-cloud-sap-agent
Se o agente estiver funcionando corretamente, a saída conterá
active (running)
. Exemplo:google-cloud-sap-agent.service - Google Cloud Agent for SAP Loaded: loaded (/usr/lib/systemd/system/google-cloud-sap-agent.service; enabled; vendor preset: disabled) Active: active (running) since Fri 2022-12-02 07:21:42 UTC; 4 days ago Main PID: 1337673 (google-cloud-sa) Tasks: 9 (limit: 100427) Memory: 22.4 M (max: 1.0G limit: 1.0G) CGroup: /system.slice/google-cloud-sap-agent.service └─1337673 /usr/bin/google-cloud-sap-agent
Se o agente não estiver em execução, reinicie-o.
Verificar se o SAP Host Agent está recebendo métricas
Para verificar se as métricas de infraestrutura são coletadas pelo agente do Google Cloud para SAP e enviadas corretamente ao agente de host da SAP, siga estas etapas:
- No sistema SAP, insira a transação
ST06
. No painel de visão geral, verifique a disponibilidade e o conteúdo dos seguintes campos para a configuração completa da infraestrutura de monitoramento da SAP e do Google:
- Provedor de nuvem:
Google Cloud Platform
- Acesso ao monitoramento avançado:
TRUE
- Detalhes do monitoramento avançado:
ACTIVE
- Provedor de nuvem:
Configurar o agente do Google Cloud para SAP no Linux
Depois de instalar o agente do Google Cloud para SAP, é possível ativar outros recursos do agente executando as configurações a seguir. Por padrão, a coleção de métricas do agente de host do SAP e de métricas de avaliação do gerenciador de cargas de trabalho está ativada.
Pré-requisitos
Para permitir que o agente acesse os recursos do Google Cloud em um ambiente da Solução Bare Metal, é necessário atender aos seguintes pré-requisitos:
- Crie uma conta de serviço do IAM para que o agente acesse os recursos do Google Cloud e, em seguida, conceda os papéis do IAM necessários à conta de serviço. Consulte Configurar uma conta de serviço para mais informações.
- No servidor da Solução Bare Metal, instale a gcloud CLI. Consulte Instalar a CLI gcloud para mais detalhes.
- Para acessar o Google Cloud, autorize a CLI gcloud. Consulte Autorizar a CLI gcloud para mais detalhes.
- Estabeleça uma conexão com as APIs do Google Cloud. Consulte os detalhes em Como configurar o acesso privado do Google para hosts locais.
Configurar uma conta de serviço
Para permitir que o agente acesse os recursos do Google Cloud em um ambiente da Solução Bare Metal, configure uma conta de serviço do IAM.
No mínimo, a conta de serviço que o agente usa precisa incluir o papel Gravador de insights do gerenciador de cargas de trabalho (roles/workloadmanager.insightWriter
).
Para criar uma conta de serviço, siga estas etapas:
-
Create a service account:
-
In the Google Cloud console, go to the Create service account page.
Go to Create service account - Select your project.
-
In the Service account name field, enter a name. The Google Cloud console fills in the Service account ID field based on this name.
In the Service account description field, enter a description. For example,
Service account for quickstart
. - Click Create and continue.
-
Grant the Workload Manager > Workload Manager Insights Writer role to the service account.
To grant the role, find the Select a role list, then select Workload Manager > Workload Manager Insights Writer.
- Click Continue.
-
Click Done to finish creating the service account.
Do not close your browser window. You will use it in the next step.
-
-
Create a service account key:
- In the Google Cloud console, click the email address for the service account that you created.
- Click Keys.
- Click Add key, and then click Create new key.
- Click Create. A JSON key file is downloaded to your computer.
- Click Close.
Depois de criar a conta de serviço, faça upload do arquivo de chave JSON em um local seguro no servidor da Solução Bare Metal que possa ser acessado pelo agente.
Ativar recursos
Depois de configurar uma conta de serviço para sua Solução Bare Metal e conceder a ela os papéis necessários, é possível ativar outros recursos do agente do Google Cloud para SAP executando as seguintes configurações:
- Configurar a coleta de métricas do monitoramento de processos
- Configurar a coleta de métricas de avaliação do gerenciador de cargas de trabalho
- Configure a coleta de métricas de monitoramento do SAP HANA.
- Configure o backup e a recuperação baseados em Backint para SAP HANA.
Arquivo de configuração padrão
O snippet a seguir é um exemplo da configuração padrão da versão 3.2 (mais recente) do agente do Google Cloud para SAP:
{ "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 }, "discovery_configuration": { "enable_discovery": true }, "hana_monitoring_configuration": { "enabled": false } }
Para ver arquivos de configuração de exemplo específicos do recurso, consulte o guia de configuração dele.
Parâmetros de configuração
Na tabela a seguir, descrevemos os parâmetros de configuração do Agente para SAP do Google Cloud em execução em um servidor da Solução Bare Metal, incluindo os parâmetros relacionados à coleta de métricas. Para informações sobre os parâmetros de configuração relacionados ao recurso Backint do agente, consulte Parâmetros de configuração (em inglês).
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
|
Especifique o nome do servidor da Solução Bare Metal em que você instalou o agente. |
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_process_metrics |
Para ativar a coleta de métricas de monitoramento de processo, especifique |
collection_configuration.process_metrics_frequency |
A partir da versão 2.6, esse parâmetro determina a frequência de coleta das métricas do monitoramento de processos com rápida mudança, em segundos. As métricas do monitoramento de processos com rápida mudança são: O valor padrão desse parâmetro é Todas as outras métricas do monitoramento de processos (com mudanças lentas) são coletadas a uma
frequência padrão de 30 segundos. Para mudar a frequência de coleta das
métricas do monitoramento de processos com mudanças lentas, use o parâmetro
|
collection_configuration.slow_process_metrics_frequency |
Especifique a frequência de coleta das métricas do monitoramento de processos com mudanças lentas, em segundos. O valor padrão desse parâmetro é |
collection_configuration.process_metrics_to_skip |
Especifique as
métricas do monitoramento de processos
que você não quer que o agente colete. Esse parâmetro aceita um valor separado por vírgulas dos nomes das métricas do monitoramento de processos. Por exemplo, |
collection_configuration.hana_metrics_config.hana_db_user |
Especifique a conta de usuário do banco de dados que o agente usa para consultar
o SAP HANA. O padrão é |
collection_configuration.hana_metrics_config.hana_db_password |
Especifique a senha de texto simples para a conta de usuário do banco de dados que o agente usa para consultar o SAP HANA. |
collection_configuration.hana_metrics_config.hana_db_password_secret_name |
Para fornecer com segurança a senha da conta de usuário do banco de dados que o agente usa para consultar o SAP HANA, especifique o nome do secret que contém as credenciais de segurança para a conta de usuário do banco de dados. As métricas relacionadas ao SAP HANA serão coletadas apenas se |
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. |
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 é |
hana_monitoring_configuration.enabled |
Opcional. Para permitir que o agente do Google Cloud para SAP colete as métricas de monitoramento
do SAP HANA, especifique hana_monitoring_configuration.enabled: true .
|
hana_monitoring_configuration.sample_interval_sec |
Opcional. Especifique o intervalo de amostra, em segundos, que determina a frequência com que o agente do Google Cloud para SAP consulta as instâncias do SAP HANA para coletar as métricas de monitoramento do SAP HANA. O valor padrão é de 300 segundos. Para cada consulta definida no arquivo de configuração do agente do Google Cloud para SAP, é possível substituir o intervalo de amostra global especificando o intervalo necessário para o parâmetro |
hana_monitoring_configuration.query_timeout_sec |
Opcional. Especifique o tempo limite de cada consulta feita às instâncias do SAP HANA. O valor padrão é de 300 segundos. |
hana_monitoring_configuration.execution_threads |
Opcional. Especifique o número de linhas de execução usadas para enviar consultas às instâncias do SAP HANA. Cada consulta é executada na própria linha de execução. O valor padrão é 10. |
hana_monitoring_configuration.hana_instances.name |
Especifique o identificador de nome da instância do SAP HANA. |
hana_monitoring_configuration.hana_instances.sid |
Especifique o SID da instância do SAP HANA. Essa string é adicionada como uma etiqueta a todas as métricas resultantes da consulta às instâncias do SAP HANA. |
hana_monitoring_configuration.hana_instances.host |
Especifique o identificador da máquina local ou remota que hospeda a instância do SAP HANA. Confira a seguir os valores compatíveis:
|
hana_monitoring_configuration.hana_instances.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 é
|
hana_monitoring_configuration.hana_instances.user |
Especifique a conta de usuário usada para consultar a instância do SAP HANA. |
hana_monitoring_configuration.hana_instances.password |
Opcional. Especifique a senha, como texto simples, que autentica a conta de usuário para consultar a instância do SAP HANA. Para ativar a autenticação, especifique uma das seguintes opções:
Se você usar os dois parâmetros, o parâmetro |
hana_monitoring_configuration.hana_instances.secret_name |
Opcional. Especifique o nome do secret no Secret Manager que armazena a senha da conta de usuário. |
hana_monitoring_configuration.hana_instances.enable_ssl |
Opcional. Especifique se o SSL está ativado na instância do
SAP HANA. O valor padrão é |
hana_monitoring_configuration.hana_instances.host_name_in_certificate |
Se você especificar |
hana_monitoring_configuration.hana_instances.tls_root_ca_file |
Se você especificar |
hana_monitoring_configuration.queries.enabled |
Opcional. Para ativar uma consulta SQL para todas as instâncias do SAP HANA, especifique o valor |
hana_monitoring_configuration.queries.name |
Se você definiu consultas personalizadas no arquivo de configuração, especifique um nome exclusivo para cada consulta personalizada. O nome da consulta precisa ser exclusivo porque ele é usado para criar o URL padrão da métrica no Monitoring. |
hana_monitoring_configuration.queries.sql |
Especifique a instrução SQL que o agente emite para as instâncias do SAP HANA. A instrução SQL precisa estar em conformidade com a sintaxe SQL definida pela SAP em Referência do SQL do SAP HANA e referência de visualizações do sistema. |
hana_monitoring_configuration.queries.sample_interval_sec |
Opcional. Especifique o intervalo de amostra da consulta SQL. Isso substitui o intervalo global da amostra. O valor precisa ser de cinco segundos ou mais. |
hana_monitoring_configuration.queries.columns.name |
Especifique um nome exclusivo que identifique cada coluna. O nome da coluna precisa ser exclusivo porque ele é usado para criar o URL padrão da métrica no Monitoring. |
hana_monitoring_configuration.queries.columns.metric_type |
Para gerenciar pelo Monitoring, especifique um dos seguintes
tipos de métrica: As métricas do tipo |
hana_monitoring_configuration.queries.columns.value_type |
Para gerenciar pelo Monitoring, especifique um tipo de dados compatível com o tipo de métrica. Os tipos de dados compatíveis são: |
hana_monitoring_configuration.queries.columns.name_override |
Opcional. Para processamento pelo Monitoring, especifique o caminho que você quer mostrar no URL da métrica no lugar dos nomes da consulta e da coluna. Exemplo:
|
Solução de problemas
Para informações sobre como diagnosticar e resolver problemas que você pode encontrar ao instalar e configurar o agente do Google Cloud para SAP, consulte o guia de solução de problemas do agente do Google Cloud para SAP.
Receba ajuda
Se você precisar de ajuda para resolver problemas com o agente do Google Cloud para SAP, colete todas as informações de diagnóstico disponíveis e entre em contato com o Cloud Customer Care. Para mais informações sobre como entrar em contato com o atendimento ao cliente, consulte Como receber suporte para o SAP no Google Cloud.