Guia de instalação e operação do agente de monitoramento para SAP HANA V2.0

Neste guia, fornecemos instruções para instalar, operar e solucionar problemas da versão 2.0 do agente de monitoramento do Google Cloud para SAP HANA.

Para ter uma visão geral do agente de monitoramento do SAP HANA e as opções dele, consulte o Guia de planejamento do agente de monitoramento para SAP HANA V2.0.

Pré-requisitos

O agente de monitoramento do SAP HANA requer drivers de conexão SAP e uma versão específica do Java Runtime Environment (JRE).

Se o servidor em que você estiver instalando o agente tiver acesso à Internet, o agente fará o download dos arquivos automaticamente durante a instalação.

Caso o servidor não tenha acesso à Internet, você mesmo poderá fazer upload dos arquivos para o servidor por conta própria.

Se você mesmo precisar fazer o upload deles, antes de instalar o agente, faça upload dos arquivos a seguir para o diretório /tmp/gcpsapdeps:

• https://github.com/SAP/SapMachine/releases/download/sapmachine-17.0.1/sapmachine-jre-17.0.1_linux-x64_bin.tar.gz

• https://repo1.maven.org/maven2/com/sap/cloud/db/jdbc/ngdbc/2.11.14/ngdbc-2.11.14.jar

Veja o que é necessário para seguir este guia:

• uma Conta do Google.
• um projeto do Google Cloud.
• uma conta de faturamento do Google Cloud.
• Uma ou mais instâncias implantadas do SAP HANA. Para obter informações sobre como implantar o SAP HANA no Google Cloud, consulte o Guia de implantação do SAP HANA.

Como definir os papéis necessários do IAM

No mínimo, a conta de serviço usada pelo agente de monitoramento para SAP HANA precisa incluir o papel Monitoring Metric Writer. Se isso não for feito, você precisará conceder o papel Monitoring Metric Writer à conta de serviço.

Além disso, se você estiver usando o Secret Manager para armazenar a senha do usuário do banco de dados do sistema SAP HANA, a conta de serviço precisará incluir o papel Secret Manager Secret Accessor e as instâncias de VM precisarão incluir o escopo de acesso cloud-platform.

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

1. No console do Google Cloud, acesse a página IAM do IAM & Admin.

   Acessar IAM

2. Selecione seu projeto do Google Cloud.

3. Identifique a conta de serviço a que você quer adicionar os papéis do IAM.

   • 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 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 principal na conta de serviço que você quer editar.

4. Clique em Adicionar outro papel e verifique se os seguintes papéis estão atribuídos à sua conta de serviço:

   • Monitoramento > Gravador da métrica de monitoramento
   • Secret Manager > Acessador de secrets do Secret Manager

5. Clique em Adicionar ou Salvar para atribuir os papéis à sua conta de serviço.

Para informações sobre como definir escopos de acesso para uma instância de VM, consulte Como alterar a conta de serviço e os escopos de acesso para uma instância.

Para obter mais informações sobre os papéis e escopos do IAM necessários para acessar o Secret Manager, consulte Controle de acesso do Secret Manager.

Como instalar o agente de monitoramento para SAP HANA

Adicionar o repositório do Google Cloud RPM à lista de repositórios do SO

É necessário adicionar o URL do repositório RPM do Google Cloud para o agente à lista de repositórios de pacotes do sistema operacional. A maneira como você adiciona um repositório é diferente se está usando um sistema operacional Red Hat ou SUSE.

Como adicionar um repositório ao RHEL

Para adicionar o repositório RPM do Google Cloud ao RHEL, selecione a versão e siga o procedimento:

Como adicionar um repositório ao SLES

Para adicionar o repositório RPM do Google Cloud ao SLES, selecione sua versão e siga o procedimento:

Como instalar o agente

Para instalar o agente de monitoramento do SAP HANA, use o gerenciador de pacotes do SO.

Para instalar o agente, selecione seu sistema operacional e siga o procedimento:

1. Estabeleça uma conexão SSH com sua VM do host.

2. Use o comando a seguir:

   RHEL

   sudo yum install google-saphanamonitoring-agent

   SLES

   sudo zypper --no-gpg-checks install google-saphanamonitoring-agent

O agente é instalado no diretório /usr/sap/google-saphanamonitoring-agent.

Como configurar o agente

Para configurar o agente, modifique o arquivo de configuração do agente: /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml.

Valores de propriedade do servidor que são detectados automaticamente

Por padrão, a seção cloud_properties no arquivo configuration.yaml é comentada, conforme mostrado no exemplo a seguir, e o agente de monitoramento do SAP HANA usa o ID do projeto, o ID da instância e a zona da instância de VM em que o agente está sendo executado.

  # cloud_properties:
     # project_id: MONITORED_INSTANCE_PROJECT_ID
     # instance_id: MONITORED_VM_ID
     # zone: MONITORED_VM_ZONE

Se o agente estiver em execução na mesma VM que o SAP HANA, será possível deixar a seção cloud_properties com uma marca de comentário.

Se o agente estiver em execução em uma VM diferente do SAP HANA, será necessário remover o caractere de comentário # de cada linha na seção cloud_properties e atualizar as propriedades project_id, instance_id e zone com o ID do projeto, ID da instância e zona da VM do host do SAP HANA.

Se o SAP HANA estiver em execução em um servidor da Solução Bare Metal, remova o caractere de comentário # das linhas cloud_properties e project_id e especifique o ID do projeto que você está usando com a Solução Bare Metal. Deixe as propriedades instance_id e zone com uma marca de comentário.

Valores de propriedade do SAP HANA que são detectados automaticamente

Por padrão, a propriedade sid no arquivo configuration.yaml é comentada e o agente recupera o ID do sistema (SID, na sigla em inglês) do SAP HANA a partir da tabela M_DATABASE do SAP HANA. Se você precisar especificar um SID diferente, remova o caractere de comentário da linha sid e especifique o SID necessário.

Procedimento de configuração

Nas etapas a seguir, você especifica as propriedades de configuração mais usadas. Para obter descrições de todas as propriedades de configuração, consulte Descrições da propriedade de configuração.

1. Abra o arquivo de configuração para edição usando seu editor de texto preferido. Por exemplo:

   sudo vi /usr/sap/google-saphanamonitoring-agent/conf/configuration.yaml

2. Opcionalmente, em gcloud_auth, remova o caractere de comentário # e especifique o caminho para um arquivo JSON que contém a chave de uma conta de serviço do IAM para o agente. Por exemplo:

   gcloud_auth:
   # If defined this service account will be used for API calls or else the default VM credentials
   # will be used.
   service_account_json: /usr/sap/google-saphanamonitoring-agent/auth/example-project-id-abcdef123456.json

3. Especifique uma ou mais instâncias do SAP HANA para serem monitoradas pelo agente.

   Para especificar mais de um banco de dados SAP HANA, crie um novo conjunto de propriedades copiando todas as propriedades hana_instances aplicáveis de - name a trust_store_secret_name. É necessário copiar as propriedades de SSL, certificado, keystore e trustore somente se a instância adicional do SAP HANA as usar. Cole o conjunto extra de propriedades da instância imediatamente após o primeiro conjunto e antes de queries.

   Para definir uma instância do SAP HANA:

   1. Especifique o nome do host em que a instância do SAP HANA está sendo executada. Esse valor aparece nos registros e no Monitoring. Por exemplo:

      - name: example-hana-vm

   2. Especifique o endereço IP do host em que a instância do SAP HANA está sendo executada.

      • Se a instância do SAP HANA estiver sendo executada em uma VM de host diferente do agente, especifique o endereço IP interno da VM do host. Por exemplo:

        host: 10.1.0.100

      • Se a instância do SAP HANA estiver em execução em um host que não esteja no mesmo projeto do Google Cloud que o agente, especifique o endereço IP público da VM do host.

      • Se o agente estiver em execução no mesmo host que o SAP HANA, será possível aceitar o valor padrão, que é o endereço IP do loopback de localhost, 127.0.0.1.

   3. Especifique a porta na qual a instância do SAP HANA aceita consultas. Para o primeiro ou apenas um banco de dados de locatário, a porta é 3nn15, em que nn é o número da instância do SAP HANA.

      port: 30015

   4. Especifique a conta de usuário do SAP HANA que o agente usará para consultar o SAP HANA. Por padrão, a conta de usuário SYSTEM é especificada:

      user: SYSTEM

   5. Especifique a senha da conta de usuário do SAP HANA que o agente deve usar para consultar o SAP HANA. Por exemplo:

      password: TempPa55word

   6. Se o sistema SAP HANA usar Transport Layer Secure (TLS)/Secure Sockets Layer (SSL), ative o suporte a SSL:

      enable_ssl: true

   7. Para validar certificados quando o SAP HANA usa TLS/SSL, ative a verificação de certificados e especifique o nome do certificado, o keystore e as propriedades do trustore, conforme necessário.

      validate_certificate: true

      Para uma descrição do nome do certificado, do keystore e das propriedades do trustore, consulte Descrições das propriedades de configuração.

4. Salve e feche o arquivo configuration.yaml.

Descrições da propriedade de configuração

A tabela a seguir mostra todas as propriedades que podem ser usadas para definir instâncias, conexões, suporte TLS/SSL e compatibilidade de validação de certificado do SAP HANA.

Exceto para sample_interval e query_timeout, que definem padrões globais para consultas, todas as outras propriedades usadas para definir ou ativar consultas individuais são documentadas no Guia de planejamento do agente de monitoramento para SAP HANA.

Ative o agente

Depois que o agente de monitoramento para SAP HANA estiver configurado, mas antes de iniciá-lo, ative o agente como um serviço do sistema para que o serviço seja reiniciado sempre que a instância de VM for reinicializada.

Para ativar o agente

1. Estabeleça uma conexão SSH com sua VM do host.

2. Use o comando a seguir:

   sudo systemctl enable google-saphanamonitoring-agent

   Você verá uma saída semelhante ao exemplo a seguir:

   Created symlink /etc/systemd/system/multi-user.target.wants/google-saphanamonitoring-agent.service → /usr/sap/google-saphanamonitoring-agent/service/google-saphanamonitoring-agent.service.
   Created symlink /etc/systemd/system/google-saphanamonitoring-agent.service → /usr/sap/google-saphanamonitoring-agent/service/google-saphanamonitoring-agent.service.
   

Iniciar o agente

Para iniciar o agente:

1. Estabeleça uma conexão SSH com sua VM do host.

2. Use o comando a seguir:

   sudo systemctl start google-saphanamonitoring-agent

3. Verifique o status do agente:

   sudo systemctl status google-saphanamonitoring-agent

Se a inicialização for bem-sucedida, após alguns segundos o agente começará a consultar o SAP HANA e enviar as métricas ao Monitoring.

Para mais informações sobre como visualizar suas métricas no Monitoring, consulte Instalar o painel personalizado para visualizar as métricas.

Como verificar os registros

Para verificar os registros, emita:

tail -n 100 -f /var/log/google-saphanamonitoring-agent.log

Quando o agente é iniciado, ele registra os eventos de startup nos registros. A inicialização, a programação de consultas e o envio das métricas para o Monitoring são gravados nos registros.

O exemplo a seguir mostra os registros de startup e as entradas de registro da primeira consulta bem-sucedida para o SAP HANA.

2021-04-26T20:42:53.392UTC [INFO] ******  Starting Google SAP HANA Custom Metrics Agent ******
2021-04-26T20:42:53.413UTC [INFO] Controller initializing...
2021-04-26T20:42:53.414UTC [INFO] Configuring dependencies...
2021-04-26T20:42:53.677UTC [INFO] Configuration of dependencies complete.
2021-04-26T20:42:53.678UTC [INFO] Configuration loading...
2021-04-26T20:42:53.704UTC [INFO] Loading system level metric definitions...
2021-04-26T20:42:53.767UTC [INFO] Loading conf/configuration.yaml...
2021-04-26T20:42:53.836UTC [INFO] Default Cloud Properties: projectId=example-project-id, instanceId=8254335046206112691, zone=us-central1-f
2021-04-26T20:42:53.843UTC [INFO] No "cloud_properties" field found in the config file, so using default cloud properties.
2021-04-26T20:42:53.850UTC [INFO] Configuration loaded and validated.
2021-04-26T20:42:53.865UTC [INFO] Configuration load complete.
2021-04-26T20:42:53.865UTC [INFO] Controller initialization complete
2021-04-26T20:42:53.865UTC [INFO] Starting sampling of HANA metrics...
2021-04-26T20:42:53.875UTC [INFO] Creating connection pool of size 10 for SAP HANA instance "example-hana-vm"
2021-04-26T20:42:54.289UTC [INFO] The SAP HANA agent has completed initial setup. Metrics will start being sent to Cloud Monitoring in 30 seconds.
2021-04-26T20:43:24.278UTC [INFO] Writing time series data to Cloud Monitoring
2021-04-26T20:43:24.281UTC [INFO] Writing time series data to Cloud Monitoring
2021-04-26T20:43:24.292UTC [INFO] Writing time series data to Cloud Monitoring
2021-04-26T20:43:24.292UTC [INFO] Writing time series data to Cloud Monitoring
2021-04-26T20:43:24.294UTC [INFO] Writing time series data to Cloud Monitoring
2021-04-26T20:43:24.295UTC [INFO] Writing time series data to Cloud Monitoring
2021-04-26T20:43:24.295UTC [INFO] Scheduling another execution for query "replication_query" and instance "example-hana-vm" in 300 seconds

Como interromper o agente

Se você adicionar uma consulta personalizada ou alterar a configuração do agente, será necessário interrompê-lo e iniciá-lo antes que a nova consulta ou outras alterações de configuração entrem em vigor.

1. Interrompa o agente:

   sudo systemctl stop google-saphanamonitoring-agent

2. Reinicie o agente:

   sudo systemctl start google-saphanamonitoring-agent

Instale o painel personalizado para visualizar suas métricas

Para instalar o painel personalizado do SAP HANA pelo repositório do GitHub no Monitoring, faça o seguinte:

1. Abra o Cloud Shell:

   Acessar o Cloud Shell

2. No Cloud Shell, clone ou faça o download do repositório:

   git clone https://github.com/GoogleCloudPlatform/monitoring-dashboard-samples.git

3. No Cloud Shell, instale o painel performance.json do SAP HANA:

   gcloud monitoring dashboards create \
   --config-from-file=monitoring-dashboard-samples/dashboards/sap-hana/performance.json

O painel "Desempenho do SAP HANA" é adicionado aos painéis disponíveis no projeto do Google Cloud. Para ver o painel, siga as instruções em Como visualizar o painel instalado.

Veja mais informações em:

• Métricas do SAP HANA no Cloud Monitoring
• Como gerenciar painéis pela API
• Painéis instaláveis

Como visualizar o painel instalado

O arquivo performance.json no repositório cria um novo painel personalizado com o título "Desempenho do SAP HANA".

1. No console do Google Cloud, selecione Monitoramento ou clique no botão a seguir:

   Acessar o Monitoring

2. No painel de navegação do Monitoring, clique em Painéis.

3. Clique em Desempenho do SAP HANA na lista. Se você tiver muitos painéis, filtre por painéis personalizados ou pelo nome do novo painel. Para mais informações sobre como filtrar essa lista, consulte Como visualizar painéis personalizados.

A captura de tela a seguir mostra parte do painel personalizado do SAP HANA no Monitoring.

Como atualizar o agente de monitoramento para SAP HANA

Para garantir que você tenha a versão mais recente do agente de monitoramento para o SAP HANA, verifique se há atualizações periodicamente. As atualizações são anunciadas na Página de notas da versão do SAP no Google Cloud.

Verificando atualizações

Selecione seu sistema operacional:

Como instalar uma atualização

Selecione seu sistema operacional:

Solução de problemas

Nas seções a seguir, você verá etapas a serem seguidas se encontrar problemas na instalação, consultas ou no envio de métricas para o Monitoring.

Falha na instalação

Confirme se você está usando um sistema operacional compatível com o agente de monitoramento para SAP HANA. Para obter mais informações, consulte Sistemas operacionais compatíveis.

Verifique se há mensagens de erro no shell que você usou para instalar o agente.

Confirme se o repositório do Google Cloud RPM para o agente foi adicionado à lista de repositórios do sistema operacional, conforme descrito em Adicionar o repositório RPM do Google Cloud à lista de repositórios do SO.

Consultas padrão estão falhando

Na VM do host, verifique as mensagens de erro no arquivo de registros, /var/log/google-saphanamonitoring-agent.log.

Na VM do host, confirme se a porta correta está especificada na propriedade port de cada definição de instância do SAP HANA no arquivo configuration.yaml. Para informações do SAP sobre quais portas usar para consultas do SAP HANA SQL, consulte Portas TCP/IP de todos os produtos do SAP.

Verifique se o usuário do banco de dados do SAP HANA tem acesso às seguintes visualizações do sistema do SAP HANA:

• M_CONNECTIONS
• M_CS_ALL_COLUMNS
• M_CS_TABLES
• M_HOST_RESOURCE_UTILIZATION
• M_RS_TABLES
• M_SERVICE_COMPONENT_MEMORY
• M_SERVICE_MEMORY
• M_SERVICE_REPLICATION
• M_WORKLOAD
• Visualização STATISTICS_CURRENT_ALERTS do esquema _SYS_STATISTICS

As métricas não estão sendo enviadas ao Monitoring

Na VM do host, verifique as mensagens de erro no arquivo de registros, /var/log/google-saphanamonitoring-agent.log.

Se o agente não estiver usando a conta de serviço de uma VM de host, confirme se o caminho para a chave da conta de serviço JSON está especificado corretamente na propriedade service_account_json no arquivo configuration.yaml.

Na Página inicial de IAM e administrador, verifique se a conta de serviço que o agente está usando tem o papel Monitoring Metric Writer (roles/monitoring.metricWriter). Para obter mais informações, consulte Como definir os papéis necessários do IAM.

Como receber suporte para o agente de monitoramento do SAP HANA

Se você precisar de ajuda para resolver um problema com o agente de monitoramento do SAP HANA, reúna as informações de diagnóstico necessárias e entre em contato com o Cloud Customer Care. Para mais informações, consulte o Agente de monitoramento para informações de diagnóstico do SAP NetWeaver.

Suporte

Em caso de problemas com a infraestrutura ou os serviços do Google Cloud, entre em contato com o Customer Care. É possível ver os dados de contato na página Visão geral do suporte no Console do Google Cloud. Se o Customer Care determinar que há um problema nos seus sistemas SAP, você será encaminhado ao Suporte da SAP.

Para problemas relacionados a produtos SAP, registre sua solicitação de suporte no site da SAP. A SAP avalia o tíquete de suporte e, se ele parecer ser um problema de infraestrutura do Google Cloud, a SAP transfere esse tíquete para o componente adequado do Google Cloud em seu sistema: BC-OP-LNX-GOOGLE ou BC-OP-NT-GOOGLE.

Requisitos de suporte

Antes de receber suporte para sistemas SAP e a infraestrutura e os serviços do Google Cloud que eles usam, você precisa atender aos requisitos mínimos do plano de suporte.

Saiba mais sobre os requisitos mínimos de suporte para SAP no Google Cloud em:

• Como receber suporte para o SAP no Google Cloud
• Nota SAP 2456406 - SAP no Google Cloud Platform: pré-requisitos de suporte (é necessário ter uma conta de usuário SAP)

A seguir

• Saiba mais sobre o Cloud Monitoring.