O agente do Google Cloud para SAP é necessário para a compatibilidade da SAP com sistemas SAP em execução no Google Cloud, incluindo SAP NetWeaver, SAP HANA, SAP ASE, SAP MaxDB e outros.
Quando você instala o agente do Google Cloud para SAP em uma instância de VM do Compute Engine, para as métricas do agente de host da SAP, o agente combina dados de monitoramento do Cloud Monitoring com as APIs do Compute Engine e fornece esses dados para o agente de host da SAP.
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 compatíveis com o agente do Google Cloud para SAP, consulte Sistemas operacionais compatíveis.
Para instalar e configurar a versão 3.2 (mais recente) do agente do Google Cloud para SAP em um servidor da Solução Bare Metal, consulte Instalar o agente do Google Cloud para SAP em um Servidor da Solução Bare Metal.
Visão geral da instalação
No Linux, você instala 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
.
No Windows, instale o agente do Google Cloud para SAP usando o comando de gerenciamento de pacotes GooGet, googet
. 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 um serviço do Windows chamado
google-cloud-sap-agent
e uma tarefa programada que é executada a cada minuto para verificar se o serviço ainda está em execução e, se necessário, reiniciá-lo.
Pré-requisitos do agente
Antes de instalar o agente do Google Cloud para SAP, os pré-requisitos a seguir precisam ser atendidos.
Definir os papéis do IAM necessários
No mínimo, a
conta de serviço
que o agente do Google Cloud para SAP usa precisa incluir os papéis de
Leitor do Compute (roles/compute.viewer
),
Leitor do Monitoring (roles/monitoring.viewer
),
e Gravador de insights do gerenciador de carga de trabalho (roles/workloadmanager.insightWriter
).
Para adicionar um papel necessário à 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:
- Compute Engine > Visualizador do Compute
- Monitoramento > Leitor do Monitoring
- Gerenciador de cargas de trabalho > Gravador de insights do gerenciador de cargas de trabalho
Clique em Adicionar ou Salvar para aplicar os papéis à conta de serviço.
Ativar o acesso às APIs do Google Cloud
O Compute Engine recomenda configurar as instâncias de VM para permitir todos os escopos de acesso a todas as APIs do Cloud, assim como recomenda usar apenas as permissões do IAM da conta de serviço da instância para controlar o acesso aos recursos do Google Cloud. Para mais informações, consulte Criar uma VM que usa uma conta de serviço gerenciada pelo usuário.
Se você limitar o acesso às APIs do Cloud, o agente do Google Cloud para SAP exigirá os seguintes escopos de acesso mínimos da API do Cloud na instância da VM do host:
- Cloud Platform: ativado
- Compute Engine: somente leitura
- API Stackdriver Monitoring: somente leitura
Se você estiver executando aplicativos SAP em uma instância de VM que não tenha um endereço IP externo, ative o Acesso privado do Google na sub-rede da VM para que o agente do Google Cloud para SAP possa acessar as APIs e os serviços do Google. Para ativar o Acesso privado do Google em uma sub-rede, consulte Como configurar o acesso privado do Google.
Instalar o agente
Para instalar o agente do Google Cloud para SAP na instância de VM, selecione o sistema operacional e conclua as etapas a seguir.
Linux
Para instalar o agente em uma instância de VM, siga estas etapas:
- Estabeleça uma conexão SSH com a instância de VM do host.
- No 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)-x86_64 enabled=1 gpgcheck=1 repo_gpgcheck=0 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
SLES15
sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 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-x86_64 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)-x86_64 enabled=1 gpgcheck=1 repo_gpgcheck=0 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
SLES15
sudo zypper addrepo --refresh https://packages.cloud.google.com/yum/repos/google-cloud-sap-agent-sles15-x86_64 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-x86_64 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:
Windows
Para instalar o agente em uma instância de VM, siga estas etapas:
- Use o RDP para se conectar à instância de VM.
- Como administrador, execute o seguinte comando no PowerShell:
googet addrepo google-cloud-sap-agent https://packages.cloud.google.com/yuck/repos/google-cloud-sap-agent-windows googet install google-cloud-sap-agent
Depois de instalar o agente do Google Cloud para SAP e o agente de host do 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
Para verificar se o agente está em execução, selecione seu sistema operacional e siga as etapas:
Linux
Estabeleça uma conexão SSH com a instância da VM do host.
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
Para garantir que você está usando a versão mais recente do agente do Google Cloud para SAP nas imagens GiB, execute os comandos a seguir.
sudo zypper remove google-cloud-sap-agent sudo zypper addrepo -p 98 --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
Windows
Use o RDP para se conectar à instância de VM.
Como administrador, execute o seguinte comando no PowerShell:
Se o agente estiver em execução, o status mostrará$(Get-Service -Name 'google-cloud-sap-agent' -ErrorAction Ignore).Status
Running
.
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.
Os recursos a seguir só são compatíveis com Linux. Elas não são compatíveis com o Windows.
- 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.
- Fazer backup e recuperação do SAP HANA usando snapshots de disco.
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": false, "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 uma VM do Compute Engine, 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 da sua instância de VM do Compute Engine. O agente detecta isso automaticamente durante a instalação. |
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.