Guia do usuário do agente de monitoramento para SAP HANA V1.0 | Google Cloud
Soluções de compartilhamento de arquivos para SAP
Listas de verificação de implantação para executar o SAP no Google Cloud
Visão geral das listas de verificação da implantação
Todos os cenários do SAP no Google Cloud
SAP HANA no Google Cloud
SAP no Google Cloud com outros bancos de dados
SAP NetWeaver no Google Cloud
Configuração do cluster de alta disponibilidade no SLES
Solução Bare Metal para SAP NetWeaver
Guia de implantação do SAP NetWeaver na Solução Bare Metal
Connector para SAP LaMa
Guia de planejamento do Connector para SAP Landscape Management
Guia de instalação do Connector para SAP Landscape Management
Guias do SAP Hybris
Arquitetura: implantação do SAP Hybris
Como executar o SAP Hybris usando o SAP HANA
Implantação de HA automatizada com o VIP do balanceador de carga
Implantação automatizada de HA com o VIP do IP do alias
Redução da implantação com o failover automático do host do SAP HANA
Migrar um VIP para ILB em um cluster de alta disponibilidade do RHEL
Migrar um VIP para ILB em um cluster de alta disponibilidade no SLES
Solução Bare Metal para SAP HANA
Guia de planejamento do SAP HANA na Solução Bare Metal
Guia de implantação do SAP HANA na Solução Bare Metal
Agente de Backint para o SAP HANA
Agente de monitoramento para o SAP HANA
Como se planejar para o agente de monitoramento V2.0
Como instalar e operar o agente de monitoramento V2.0
V1.0: guia do usuário do agente de monitoramento
Integração de dados para SAP
Todos os guias de integração de dados para SAP
Integrações do Cloud Data Fusion com o SAP
SAP Data Services para o BigQuery
Servidor de replicação do LT do SAP para o BigQuery com SAP Data Services
Informatica IICS para o BigQuery
Guia do usuário do agente de monitoramento para SAP HANA V1.0
O Google Cloud fornece um agente de monitoramento personalizado que coleta métricas personalizadas do SAP HANA e as envia para o Cloud Monitoring, uma solução de monitoramento integrada ao Google Cloud. Com o Cloud Monitoring, é possível criar painéis para visualizar suas métricas do SAP HANA e configurar alertas com base em limites de métricas. Saiba mais na documentação do Cloud Monitoring.
Para uma descrição das métricas que a versão 1 do agente de monitoramento coleta do SAP HANA, consulte Métricas e consultas padrão no V1.0.
Observação: a versão 1.0 do agente de monitoramento do SAP HANA está obsoleta. Para novas instalações, use o agente de monitoramento do Google Cloud para SAP HANA V2.0. Para mais informações, consulte o guia de planejamento do agente de monitoramento para SAP HANA V2.0.
Neste guia, presume-se que você tenha implantado o SAP HANA no Google Cloud usando o método descrito no Guia de implantação do SAP HANA.
Como definir os papéis necessários do IAM
Por padrão, o agente de monitoramento usa a conta de serviço padrão da instância de máquina virtual (VM) do Compute Engine. Essa conta de serviço permite que binários em execução na instância de VM gravem métricas no Monitoring.
Se você optar por usar uma conta de serviço diferente, será necessário adicionar manualmente o papel do IAM que fornece essas permissões à sua conta de serviço.
Para adicionar o papel de IAM necessário à sua conta de serviço:
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 principal e insira o endereço de e-mail da conta de serviço, .
Se estiver na lista de membros, a conta de serviço já terá papéis. Clique na lista suspensa do papel atual da conta de serviço que você quer editar.
Selecione Monitoring > Monitoring Metric Writer na lista de papéis disponíveis.
Clique em Adicionar ou Salvar para aplicar os papéis à conta de serviço.
Como escolher um local de implantação
O agente de monitoramento pode ser executado diretamente em um ou mais nós em sua instalação do SAP HANA ou indiretamente como um serviço em outra instância de VM. Escolha seu local de implantação com base no seu caso de uso.
Como fazer o download e instalar o agente
Para fazer o download e instalar o agente, siga estas etapas:
Estabeleça uma conexão SSH com sua instância de VM do SAP HANA.
Faça o download e execute o script de instalação:
sudo curl https://storage.googleapis.com/gcm-ext/gcm_install.sh | bash -x
Quando você executa o comando anterior, o script de instalação realiza as seguintes operações:
Cria os seguintes diretórios:
/usr/local/lib/gcm, que conterá o agente binário.
/etc/gcm.d, que conterá as consultas que você quer que o agente execute.
/var/spool/gcm, que contém as métricas coletadas recentemente pelo agente. Por fim, o agente envia essas métricas ao Cloud Monitoring. Depois que as métricas são enviadas, elas são excluídas de /var/spool/gcm.
Faz o download da versão mais recente do agente e a salva em /usr/local/lib/gcm/.
Cria um link simbólico para o binário em /usr/local/bin/gcm.
Cria um modelo de configuração básico, /etc/default/gcm.
Cria um arquivo de configuração do daemon, /etc/systemd/system/gcm.service.
Recarrega as definições de serviço systemd.
Ativa o agente de monitoramento como um daemon.
Observação: a versão gcm-ext (versão 1) do agente de monitoramento do SAP HANA está obsoleta e não está mais sendo atualizada. Migre para a versão 2.0 seguindo as instruções em Como atualizar da versão 1 para a versão 2 ou posterior.
Como verificar se há uma nova versão do agente
Verifique a versão do seu agente:
gcm --version
Verifique se uma atualização está disponível:
curl https://storage.googleapis.com/gcm-ext/LATEST
Como fazer o download e atualizar o agente
Para atualizar o agente quando uma nova versão estiver disponível, siga estas etapas:
Interrompa o processo do agente:
sudo systemctl stop gcm
Atualize o agente com o comando a seguir. As opções -C e -U pulam a criação do arquivo de configuração padrão e da definição de serviço systemd do Linux para o agente:
sudo curl https://storage.googleapis.com/gcm-ext/gcm_install.sh | bash -s -- -C -U
Inicie o agente:
sudo systemctl start gcm
Depois de executar o script de instalação, configure as instâncias de VM que o agente monitorará e, opcionalmente, as consultas que o agente executará em seu banco de dados.
Como definir o arquivo de configuração
Quando você executou o script de instalação, ele criou um arquivo de modelo de configuração no seguinte local:
/etc/default/gcm
Usando o arquivo de configuração, é possível configurar o agente para consultar o SAP HANA em uma ou mais instâncias de VM. Para cada instância de VM que você quer monitorar:
Adicione uma definição de instância de VM no arquivo de configuração em instances. Para cada instância, defina o nome, o host, a porta, o usuário e a senha.
Para permitir que o agente colete métricas da instância da VM, adicione o nome da instância da VM em enabled_instances.
Defina os atributos na configuração usando o seguinte formato:
timestamps_in_output: no
debug_messages: yes
skip_default_queries: yes
queries_directory: /etc/gcm.d
spool_directory: /var/spool/gcm
enabled_instances:
- [INSTANCE_NAME]
- [INSTANCE_NAME_2]
project_id: [PROJECT_ID]
- name: [INSTANCE_NAME]
host: [INSTANCE_IP]
user: [DB_USERNAME]
password: [YOUR_PASSWORD]
type: [INSTANCE_TYPE]
- name: [INSTANCE_NAME_2]
host: [INSTANCE_IP_2]
Os atributos a seguir são obrigatórios no arquivo de configuração:
[PROJECT_ID]: o ID do projeto do Google Cloud que contém as instâncias de VM que serão monitoradas. Especifique apenas um ID de projeto.
[INSTANCE_NAME]: o nome da instância de VM do Compute Engine que você quer monitorar.
[INSTANCE_IP]: o IP interno ou externo da instância de VM do Compute Engine que você quer monitorar. Recomendamos o uso de IPs internos, se possível, porque eles exigem menos configuração do que os IPs externos e são, por padrão, particulares e seguros.
[DB_USERNAME]: o usuário do banco de dados do SAP HANA que você quer usar.
[PORT_NUMBER]: o número da porta do seu banco de dados SAP HANA. Normalmente, o número da porta é 39015 para o SAP HANA Express ou 30015 para o SAP HANA Platform Edition.
[YOUR_PASSWORD]: a senha do usuário do banco de dados.
[INSTANCE_TYPE]: insira sap_hana para este campo.
Também é possível configurar o agente usando as sinalizações a seguir. Esses parâmetros precisam ser definidos antes do item config:
timestamps_in_output (booleano). Se você estiver executando o agente como um daemon em systemd, defina como no, porque systemd fornece carimbos de data e hora. O valor padrão é no.
debug_messages (booleano): se estiver definido, mostre as mensagens de depuração. O valor padrão é yes.
skip_default_queries (booleano): ignora o conjunto padrão de consultas. Não afeta as consultas definidas pelo usuário. O valor padrão é no.
queries_directory (string): o diretório em que é necessário procurar consultas definidas pelo usuário. O valor padrão é /etc/gcm.d.
spool_directory (string): o diretório em que é necessário coletar métricas em spool. O valor padrão é /var/spool/gcm.
Como definir consultas personalizadas
Por padrão, o agente reúne um conjunto padrão de métricas do banco de dados do SAP HANA. Para ver as descrições dessas métricas, bem como as consultas que as geram, consulte Métricas e consultas padrão na V1.0.
É possível adicionar outras consultas criando um ou mais arquivos YAML personalizados no seguinte diretório:
/etc/gcm.d
Veja a seguir um arquivo de consulta de exemplo:
- root: by_component
type: sap_hana
Amount of memory (in MiB) used by service components
HOST AS "host",
COMPONENT AS "component",
SUM(USED_MEMORY_SIZE)/1024/1024 AS "mem_used_mb"
FROM M_SERVICE_COMPONENT_MEMORY
GROUP BY HOST, COMPONENT;
description: Amount of memory (in MiB) used by the service component
value_type: DOUBLE
name: mem_used_mb
Cada arquivo YAML compreende um ou mais itens que representam os resultados de uma determinada consulta SQL nas métricas do seu banco de dados SAP HANA. Cada item tem os seguintes atributos:
root: um namespace descritivo para um determinado grupo de métricas.
query: a consulta SQL.
columns: o tipo de dados, o tipo de valor e o nome da coluna de cada campo na consulta.
type: descreve como os dados são informados ao Monitoring. Defina type como LABEL, que indica que o tipo é um cabeçalho de coluna, ou como GAUGE,, um dos tipos de métrica definidos no enum MetricKind da API do Monitoring. Atualmente, GAUGE é o único tipo de métrica compatível com o agente.
value_type: o tipo de valor da métrica. O valor desse parâmetro pode ser qualquer um dos tipos de valor definidos no enum ValueType da API do Monitoring.
name: o nome da coluna.
Veja uma lista completa das visualizações do sistema que o SAP HANA disponibiliza para consulta em SQL SAP HANA e referência de visualizações do sistema.
Os resultados da consulta são limitados a 1.000 registros. Use funções SQL agregadas, como SUM, AVG, COUNT, MIN e MAX, para limitar o número de registros retornados.
Como realizar operações básicas
Nesta seção, descrevemos como realizar operações básicas com o agente de monitoramento SAP HANA. Para ter uma lista completa de opções configuráveis, execute gcm --help.
Como gerenciar o daemon do agente de monitoramento
Quando você executou o script de instalação, o instalador criou um arquivo de unidade systemd para o agente, permitindo que você gerencie o agente usando os comandos padrão systemctl. Os comandos a seguir iniciam, interrompem e pesquisam o status do agente, respectivamente:
sudo systemctl status gcm
Para ler os registros gerados por systemctl, consulte o conteúdo do diário systemd usando o seguinte comando:
sudo journalctl -u gcm
Para ver as últimas linhas que foram registradas, é possível adicionar a sinalização -f, que funciona como um pipe para tail -f:
sudo journalctl -u gcm -f
Como suprimir consultas padrão
Por padrão, o agente executa suas consultas padrão, além das consultas personalizadas que você definiu. É possível desativar esse conjunto padrão de consultas definindo a sinalização skip_default_queries como yes em seu arquivo de configuração ou definindo a sinalização --no-defaults ao executar a ferramenta manualmente. Saiba mais em Como definir o arquivo de configuração.
Como coletar e enviar métricas manualmente
Para verificar se o agente funciona conforme esperado, é possível executar comandos manualmente para realizar suas consultas, coletar as métricas resultantes e enviá-las ao Cloud Monitoring. Para realizar suas consultas e coletar as métricas resultantes exatamente uma vez, execute o seguinte comando:
sudo gcm gather
Esse comando também envia as métricas coletadas para o Cloud Monitoring.
Como visualizar suas métricas no Cloud Monitoring
Observação: as etapas a seguir pressupõem que você esteja usando as consultas padrão.
Para exibir as métricas coletadas pelo Cloud Monitoring nos seus próprios gráficos e painéis:
Selecione Dashboards > Create Dashboard.
No menu Resource Type, selecione Custom Metrics.
No menu Metric, selecione by_component/mem_used_mb. Não altere os valores padrão dos outros campos. Você verá os dados do gráfico na seção "Preview" do painel.
Agora você tem um painel simples que exibe métricas em tempo real de instâncias da VM do SAP HANA.
Consultas padrão estão falhando
Verifique se o usuário do banco de dados do SAP HANA tem acesso às seguintes visualizações do sistema do SAP HANA:
M_EXPENSIVE_STATEMENTS
As métricas não estão sendo enviadas ao Cloud Monitoring
Verifique se sua conta de serviço do Google Cloud tem permissão para gravar métricas no Cloud Monitoring. Saiba mais em Como configurar os papéis do IAM obrigatórios.
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, transfere o tíquete para o componente do Google Cloud, BC-OP-LNX-GOOGLE ou BC-OP-NT-GOOGLE.
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:
Nota SAP 2456406 (é necessária uma conta de usuário SAP)
Métricas e consultas padrão na V1.0
Nesta seção, descrevemos as métricas que a versão 1.0 do agente de monitoramento para SAP HANA coleta por padrão e as consultas que o agente usa para coletar as métricas.
Utilização total da memória por serviços
instance/mem_used_mb Quantidade de memória do pool de memória (em MiB) atualmente em uso por todos os serviços
instance/resident_mem_used_mb Quantidade de memória (em MiB) usada no total por todos os serviços
O agente de monitoramento do Google para SAP HANA usa a consulta a seguir para coletar as métricas acima do SAP HANA:
SUM(TOTAL_MEMORY_USED_SIZE)/1024/1024 AS "mem_used_mb",
SUM(PHYSICAL_MEMORY_SIZE)/1024/1024 AS "resident_mem_used_mb"
Quantidade total de memória usada por todas as tabelas de colunas
Métrica no Cloud Monitoring
instance/table_mem_used_mb Quantidade de memória (em MiB) usada no total (soma do tamanho da memória nas partes principal, delta e histórico) por todas as tabelas de colunas
O agente de monitoramento do Google para SAP HANA usa a consulta a seguir para coletar a métrica acima do SAP HANA:
SUM(MEMORY_SIZE_IN_TOTAL)/1024/1024 AS "table_mem_used_mb"
Utilização de recursos por host
by_server/mem_available_percent Quantidade de memória disponível para processos (em MiB)
by_server/mem_total_mb Quantidade total de memória (em MiB) no servidor
by_server/mem_available_mb Memória física livre (em MiB) no host
by_server/mem_used_mb Memória física usada (em MiB) no host
by_server/swap_avail_mb Memória de swap livre (no MiB) no host
by_server/swap_used_mb Memória de swap usada (no MiB) no host
by_server/instance_mem_used_mb Quantidade do pool de memória (em MiB) usado por processos de instância
by_server/peak_instance_mem_used_mb Valor máximo do pool de memória (em MiB) que foi usado por processos de instância
by_server/instance_mem_pool_size_mb Tamanho do pool de memória (em MiB) para todos os processos da instância
by_server/instance_code_size_mb Tamanho do código (em MiB), incluindo bibliotecas compartilhadas de processos de instância
by_server/instance_shared_size_mb Tamanho da memória compartilhada dos processos da instância
by_server/cpu_user_time_msec Tempo de CPU gasto (em ms) no modo de usuário
by_server/cpu_sys_time_msec Tempo de CPU gasto (em ms) no modo kernel
by_server/cpu_wait_io_time_msec Tempo de CPU gasto (em ms) em espera de E/S
by_server/cpu_idle_time_msec Tempo ocioso da CPU (em ms)
FREE_PHYSICAL_MEMORY/(FREE_PHYSICAL_MEMORY + USED_PHYSICAL_MEMORY)*100 AS "mem_available_percent",
(FREE_PHYSICAL_MEMORY + USED_PHYSICAL_MEMORY)/1024/1024 AS "mem_total_mb",
FREE_PHYSICAL_MEMORY/1024/1024 AS "mem_available_mb",
USED_PHYSICAL_MEMORY/1024/1024 AS "mem_used_mb",
FREE_SWAP_SPACE/1024/1024 AS "swap_avail_mb",
USED_SWAP_SPACE/1024/1024 AS "swap_used_mb",
INSTANCE_TOTAL_MEMORY_USED_SIZE/1024/1024 AS "instance_mem_used_mb",
INSTANCE_TOTAL_MEMORY_PEAK_USED_SIZE/1024/1024 AS "peak_instance_mem_used_mb",
INSTANCE_TOTAL_MEMORY_ALLOCATED_SIZE/1024/1024 AS "instance_mem_pool_size_mb",
INSTANCE_CODE_SIZE/1024/1024 AS "instance_code_size_mb",
INSTANCE_SHARED_MEMORY_ALLOCATED_SIZE/1024/1024 AS "instance_shared_size_mb",
TOTAL_CPU_USER_TIME AS "cpu_user_time_msec",
TOTAL_CPU_SYSTEM_TIME AS "cpu_sys_time_msec",
TOTAL_CPU_WIO_TIME AS "cpu_wait_io_time_msec",
TOTAL_CPU_IDLE_TIME AS "cpu_idle_time_msec"
FROM M_HOST_RESOURCE_UTILIZATION;
Quantidade de memória usada pelos componentes de serviço
by_component/mem_used_mb Quantidade de memória do pool de memória (em MiB) atualmente em uso
Utilização de memória por serviços
by_service/mem_used_mb Tamanho da memória virtual (em MiB)
by_service/virtual_mem_used_mb Tamanho da memória física (em MiB)
by_service/resident_mem_used_mb Tamanho do código (em MiB), incluindo bibliotecas compartilhadas
by_service/code_size_mb Tamanho da pilha (em MiB)
by_service/stack_size_mb Parte do heap do pool de memória (no MiB)
by_service/heap_mem_allocated_mb Quantidade de memória de heap do conjunto em uso (em MiB)
by_service/shared_mem_allocated_mb Parte da memória compartilhada do pool de memória (em MiB)
by_service/shared_mem_used Quantidade de memória compartilhada do conjunto em uso (em MiB)
by_service/compactors_allocated_mb Parte do pool de memória (em MiB) que pode ser potencialmente liberado na falta de memória
by_service/compactors_freeable_mb Memória que pode realmente ser liberada (em MiB) na falta de memória
by_service/max_mem_pool_size_mb Tamanho máximo do pool de memória configurado (em MiB)
by_service/effective_max_mem_pool_size_mb Tamanho máximo efetivo do conjunto de memórias (em MiB)
PORT AS "port",
SERVICE_NAME AS "service",
TOTAL_MEMORY_USED_SIZE/1024/1024 AS "mem_used_mb",
LOGICAL_MEMORY_SIZE/1024/1024 AS "virtual_mem_used_mb",
PHYSICAL_MEMORY_SIZE/1024/1024 AS "resident_mem_used_mb",
CODE_SIZE/1024/1024 AS "code_size_mb",
STACK_SIZE/1024/1024 AS "stack_size_mb",
HEAP_MEMORY_ALLOCATED_SIZE/1024/1024 AS "heap_mem_allocated_mb",
HEAP_MEMORY_USED_SIZE/1024/1024 AS "heap_mem_used_mb",
SHARED_MEMORY_ALLOCATED_SIZE/1024/1024 AS "shared_mem_allocated_mb",
SHARED_MEMORY_USED_SIZE/1024/1024 AS "shared_mem_used",
COMPACTORS_ALLOCATED_SIZE/1024/1024 AS "compactors_allocated_mb",
COMPACTORS_FREEABLE_SIZE/1024/1024 AS "compactors_freeable_mb",
ALLOCATION_LIMIT/1024/1024 AS "max_mem_pool_size_mb",
EFFECTIVE_ALLOCATION_LIMIT/1024/1024 AS "effective_max_mem_pool_size_mb"
Dados do ambiente de execução para tabelas de colunas por esquema
by_schema/mem_total_mb Memória total usada (em MiB) pelas partes principal, delta e histórico
by_schema/mem_main_mb Consumo de memória atual (em MiB) no principal
by_schema/mem_delta_mb Consumo de memória atual (em MiB) no delta
by_schema/mem_hist_main_mb Consumo de memória atual (em MiB) no histórico principal
by_schema/mem_hist_detla_mb Consumo de memória atual (em MiB) no histórico-delta
by_schema/est_max_mem_total_mb Consumo máximo de memória estimado (em MiB)
by_schema/records Contagem de registros
by_schema/records_main Número de registros na parte principal das tabelas no esquema
by_schema/records_delta Número de registros na parte delta das tabelas no esquema
by_schema/records_hist_main Número de registros na parte principal do histórico das tabelas no esquema
by_schema/records_hist_delta Número de registros na parte histórico-delta das tabelas no esquema
by_schema/last_compressed_record_count Número de entradas no principal durante a última execução de compactação otimizada