Monitoramento SAP com o sensor Java NetWeaver

Você pode monitorar as aplicações Java em execução nos endereços SAP, Java e NetWeaver utilizando o sensor Instana, Java e NetWeaver para identificar gargalos e otimizar seu desempenho. Após instalar o agente de host do Instana, o sensor Java NetWeaver é instalado automaticamente. Você pode visualizar as métricas relacionadas a ele na interface do usuário do Instana após configurar o sensor Java NetWeaver.

Informações suportadas

Para garantir que o sensor SAP Java NetWeaver seja compatível com a sua configuração atual, consulte as seções a seguir:

S.O. suportado

Instana suporta os seguintes sistemas operacionais para monitoramento local e remoto do sensor SAP Java NetWeaver :

  • Monitoramento local : O agente Instana é instalado no mesmo host que o sistema SAP Java NetWeaver :

    • AIX
    • Linux ( x86 e IBM PowerPC 64 bits LE)
    • Windows
  • Monitoramento remoto : O agente Instana é instalado em um host diferente e se conecta remotamente ao servidor SAP Java NetWeaver :

    • AIX
    • Linux ( x86 e IBM PowerPC 64 bits LE)
    • Windows
    • IBM i ( OS/400 PASE)
    • Apple macOS (64 bits - Intel e Apple silicon )
Observação: para monitoramento remoto, a lista de sistemas operacionais acima corresponde ao host onde o agente Instana está instalado.

Versões suportadas

O sensor Netweaver SAP Java é compatível com o Netweaver SAP Java 7.5.

Configurando o sensor SAP Java NetWeaver

Instana suporta o monitoramento local e remoto do sensor SAP Java NetWeaver.

Observação: adicione todas as configurações de monitoramento local sob a local tag.

Para conectar o sensor diretamente a instâncias d SAP, Java e NetWeaver, adicione as configurações locais ou remotas conforme mostrado nos exemplos a seguir. Substitua os valores de exemplo pelos valores específicos do seu ambiente. O intervalo padrão de pesquisa para métricas é definido como 60 segundos.

Certifique-se de que a formatação de espaços antes de cada linha seja mantida conforme mostrado nos exemplos a seguir, pois ela segue a sintaxe de formatação do YAML.

Configuração local

Os parâmetros de configuração para monitoramento local são mostrados no exemplo a seguir:

# SAP Java Netweaver
com.instana.plugin.sap.java.netweaver:
 enabled: true
 local: # local monitoring configuration
  - jmxport: '12345'
    user: 'User1'
    password: 'password'
    sysnr: '01'
    poll_rate: 60 # seconds
 

No arquivo configuration.yaml , insira os valores apropriados para, passworduser , e sysnr ( jmxport ID da instância). O intervalo padrão de pesquisa para métricas é definido como 60 segundos.

O host parâmetro é opcional para monitoramento local. Por padrão, o sistema usa localhost ou o endereço IP de loopback. Se você quiser que SAP Java NetWeaver utilizem um nome de host ou endereço IP específico, é possível incluir o host parâmetro na configuração.

O exemplo a seguir mostra onde o host parâmetro é adicionado à configuração:
# SAP Java Netweaver
com.instana.plugin.sap.java.netweaver:
 enabled: true
 local: # local monitoring configuration
  - host: 'host-1.com' # Optional, only required if you want to use a specific host name or IP address
    jmxport: '12345'
    user: 'User1'
    password: 'password'
    sysnr: '01'
    poll_rate: 60 # seconds

Configuração Remota

Os parâmetros de configuração para monitoramento remoto são mostrados no exemplo a seguir:

# SAP Java Netweaver 
com.instana.plugin.sap.java.netweaver # remote monitoring configuration 
  enabled: true
  remote : #multiple configurations supported
    - host: 'remote.host-1.com'
      jmxport: '23456'
      user: 'User1'
      password: 'password'
      sysnr: '72'
      poll_rate: 60 # seconds
    - host: 'remote.host-2.com'
      jmxport: '23456'
      user: 'User1'
      password: 'password'
      sysnr: '72'
      poll_rate: 60 # seconds
 

No configuration.yaml arquivo, insira os valores apropriados para, jmxport , passworduser , e sysnrhost (ID da instância). O intervalo padrão de pesquisa para métricas é definido como 60 segundos.

Parâmetros de configuração

A tabela a seguir lista os parâmetros de configuração do sensor Netweaver do SAP Java :

Parâmetros Descrição
host O endereço IP ou nome de host completo da instância SAP Java NetWeaver da qual o sensor obtém as métricas.
jmxport A porta utilizada para comunicação remota com um agente JMX.
sysnr O ID da instância do SAP Java NetWeaver, por exemplo, 01.
user O nome de usuário configurado na instância do SAP Java. O usuário SAP deve ter autorização para obter métricas. Para obter mais informações, consul te Verificação da autorização do usuário para extrair métricas.
password A senha necessária para o usuário fazer login no sistema SAP Java NetWeaver.

Verificando a autorização do usuário para obter métricas

Para habilitar o monitoramento remoto de um sistema SAP NetWeaver, configure o Java Management Extensions ( JMX ) do sistema SAP NetWeaver seguindo estas etapas:

  1. Faça login no sistema SAP NetWeaver através de um navegador como administrador.
  2. Go Vá para o Administrador do SAP NetWeaver > Configuração > Infraestrutura > Propriedades do sistema do Java > Parâmetros de VM do sistema.
  3. Adicione os seguintes parâmetros:
    com.sun.management.jmxremote.port = 23456 
    com.sun.management.jmxremote.rmi.port = 23456 
    com.sun.management.jmxremote.ssl  = false 
    com.sun.management.jmxremote.authenticate = false 
     
    NetWeaver função
  4. Se a autenticação for aplicada, certifique-se de que o seguinte parâmetro esteja definido como true:

    com.sun.management.jmxremote.authenticate = true
Observação: A autorização do usuário é realizada no sistema SAP Java NetWeaver. Você deve fornecer a autorização de usuário para o mesmo usuário e ID de instância especificados no configuration.yaml para este sensor Java NetWeaver.

Para acessar os MBeans JMX, o usuário deve ter as permissões apropriadas. É possível atribuir ao usuário qualquer uma das funções padrão disponíveis em SAP Java NetWeaver (como Everyone, Guest, ou NWA_READONLY) ou uma função personalizada que tenha sido criada. Certifique-se de que a JmxManageAll ação esteja atribuída à função em uso, pois todas as métricas necessárias são capturadas por meio do JMX

As etapas a seguir utilizam a Guest função para ilustração, mas as etapas são semelhantes para qualquer uma das outras funções atribuídas:

  1. Go vá para Administrador do SAP NetWeaver > Configuração > Segurança > Gerenciamento de identidades.

  2. Pesquise pelo critério Função e selecione a função Convidado.

  3. Na guia Ações atribuídas, adicione jmx.

    NetWeaver função

Como alternativa, atribua as permissões necessárias JMX ao usuário pretendido, em vez de modificar a função Convidado.

Configurando o suporte a SSL

<agent_install_dir>/etc/instana/configuration.yamlPara que o agente do Instana se conecte com segurança ao seu SAP Java NetWeaver usando o protocolo Secure Sockets Layer ( SSL ), adicione a seguinte configuração ao arquivo de configuração do agente:

<agent_install_dir>/etc/instana/configuration.yamlPara que o agente do Instana se conecte com segurança ao seu SAP Java NetWeaver usando o protocolo Secure Sockets Layer ( SSL ), adicione a seguinte configuração ao arquivo de configuração do agente:

Monitoramento Local

Para o monitoramento local, adicione a seguinte configuração:

# SAP Java Netweaver
com.instana.plugin.sap.java.netweaver:
 enabled: true
 local: # local monitoring configuration
  - jmxport: '12345'
    host: 'host-1.com'
    user: 'User1'
    password: 'password'
    sysnr: '01'
    poll_rate: 60 # seconds
    ssl_enabled: true

Monitoramento remoto

Para o monitoramento remoto, adicione a seguinte configuração:

# SAP Java Netweaver 
com.instana.plugin.sap.java.netweaver # remote monitoring configuration 
  enabled: true
  remote : #multiple configurations supported
    - host: 'remote.host-1.com'
      jmxport: '23456'
      user: 'User1'
      password: 'password'
      sysnr: '72'
      poll_rate: 60 # seconds
      ssl_enabled: true

Quando ssl_enabled estiver definido como true, você precisará importar seu certificado confiável para o arquivo cacerts (/jvm/lib/security/cacerts) do seu JRE usando o comando keytool:

keytool -import -alias ALIAS_NAME -keystore "/path/to/jre/cacerts" -file YOUR_CERTIFICATE_NAME.crt
Observação: Você pode usar a host propriedade para especificar o nome do host utilizado no certificado. Isso garante que o nome do host utilizado pelo agente do Instana corresponda ao nome do host especificado no certificado. Essa configuração é relevante em ambientes de monitoramento locais, nos quais o agente do Instana utiliza o endereço de loopback ( 127.0.0.1 ), enquanto o certificado utiliza um nome de host totalmente qualificado.

Visualizando as métricas

Após instalar o agente do host e configurar o sensor NetWeaver do Java, você poderá visualizar as métricas e os alertas do SAP na interface do usuário do Instana.

Visão da infraestrutura

Para visualizar as métricas na exibição da infraestrutura, execute as seguintes etapas:

  1. Na barra lateral da interface do usuário do Instana, selecione Infraestrutura.
  2. Na guia "Mapa ", clique em uma torre específica em SAP Java NetWeaver.
  3. Clique em Abrir Painel.

Você pode acessar o painel SAP Java NetWeaver com todas as métricas coletadas.

Visão da plataforma

Para visualizar as métricas na visualização da plataforma, execute as seguintes etapas:

  1. No menu de navegação da interface do usuário do Instana, selecione Plataforma > SAP. Você pode visualizar os sistemas, instâncias e bancos de dados do SAP em guias separadas.
  2. Para visualizar a instância do SAP conectada ao sensor Java NetWeaver, clique na guia “Instances ”. O nome do sensor é normalmente listado como JavaNetWeaverInstance@HostName_SID_InstanceID.
  3. Clique na instância SAP Java NetWeaver para visualizar o painel SAP Java NetWeaver com todas as métricas coletadas.

Métricas Coletadas

A tabela a seguir apresenta as métricas coletadas pelo Java NetWeaver e a frequência com que são coletadas:

Métrica coletada Frequência de coleta
Tarefas da aplicação 60 Segundos
Tópicos da aplicação 60 Segundos
Pool de threads do aplicativo 60 Segundos
Taxa de acertos do cache 60 Segundos
Uso de Cache 60 Segundos
Carregamento de Classe 60 Segundos
Tempo de compilação 60 Segundos
CPU 60 Segundos
Uso de disco 120 segundos
Coleção GC 60 Segundos
Erros GC 60 Segundos
Problemas de GC 60 Segundos
Relatórios GC 60 Segundos
Memória heap e memória não heap 60 Segundos
Solicitações HTTP 60 Segundos
Respostas do HTTP 60 Segundos
Conjunto de conexões JDBC 60 Segundos
Solicitações JDBC com tempo limite atingido 60 Segundos
Encadeamentos da JVM 60 Segundos
JVM Carga da CPU 60 Segundos
JVM Média de carga do sistema 60 Segundos
Validade da licença 60 Segundos
Mensagens de log 60 Segundos
Usuários com sessão iniciada 60 Segundos
Memória 60 Segundos
Uso da CPU do Processo 60 Segundos
RFC 60 Segundos
Sessões 60 Segundos
Espaço de Troca 60 Segundos
Média de Carregamento do Sistema 60 Segundos
Problemas no sistema 60 Segundos
Buffer de tabela 60 Segundos
Contagem de encadeamentos 60 Segundos
Uso do conjunto de encadeamentos 60 Segundos
Tempo de encadeamento 60 Segundos
Transações 60 Segundos
Utilização da tarefa em espera 60 Segundos
Sessões do contêiner da web 60 Segundos
Solicitações de contêiner de web 60 Segundos
Rendimento do contêiner da web 60 Segundos
Sessões da web 60 Segundos
Webservice 60 Segundos
Tempo de atividade 60 Segundos

O sensor Java NetWeaver gera eventos integrados para diversos cenários. Para obter mais informações, consulte Referência de eventos integrados.

Configurando a coleta de métricas personalizadas

Você pode coletar métricas personalizadas específicas para o seu ambiente, além das métricas padrão, configurando o sensor Java NetWeaver.

Por exemplo, você está monitorando remotamente um sistema SAP Java NetWeaver. Para coletar métricas relacionadas ao Serviço de Mensagens d Java (JMS), especifique as informações relacionadas ao JMS na seção personalizada, conforme mostrado no exemplo a seguir:

com.instana.plugin.sap.java.netweaver:
  enabled: true
  remote:
    - host: 'remote.host-1.com'
      jmxport: '23456'
      user: 'User1'
      password: 'password'
      sysnr: '72'
      poll_rate: 60 
  custom:
     jmxBeans:
       - name: JMS_CONNECTION_COUNT
         object: "com.sap.default:name=\"/Services/JMS/default/SessionContainer/Connections count\",j2eeType=SAP_MonitorPerNode,*"
         attribute: "Value"
       - name: JMS_CONSUMER_COUNT
         object: "com.sap.default:name=\"/Services/JMS/default/SessionContainer/Consumers count\",j2eeType=SAP_MonitorPerNode,*"
         attribute: "Value"
       - name: JMS_PRODUCER_COUNT
         object: "com.sap.default:name=\"/Services/JMS/default/SessionContainer/Producers count\",j2eeType=SAP_MonitorPerNode,*"
         attribute: "Value"