Surveillance SAP avec le capteur Java NetWeaver

Vous pouvez surveiller les applications Java exécutées sur SAP, Java et NetWeaver à l'aide du capteur Instana, Java et NetWeaver afin d'identifier les goulots d'étranglement et d'optimiser leurs performances. Une fois l'agent hôte Instana installé, le capteur Java NetWeaver est automatiquement installé. Une fois le capteur « Java » ( NetWeaver ) configuré, vous pouvez consulter les indicateurs associés dans l'interface utilisateur d' Instana.

Informations prises en charge

Pour vous assurer que le capteur SAP Java NetWeaver est compatible avec votre configuration actuelle, consultez les sections suivantes :

Systèmes d'exploitation pris en charge

Instana prend en charge les systèmes d'exploitation suivants pour la surveillance locale et à distance du capteur SAP Java NetWeaver :

  • Surveillance locale : l'agent Instana est installé sur le même hôte que le système SAP Java NetWeaver :

    • AIX
    • Linux ( x86 et IBM PowerPC 64 bits LE)
    • Windows
  • Surveillance à distance : l'agent Instana est installé sur un autre hôte et se connecte à distance au serveur SAP Java NetWeaver :

    • AIX
    • Linux ( x86 et IBM PowerPC 64 bits LE)
    • Windows
    • IBM i ( OS/400 PASE)
    • Apple macOS (64 bits - Intel et Apple silicon )
Remarque : pour la surveillance à distance, la liste des systèmes d'exploitation ci-dessus correspond à l'hôte sur lequel l'agent d' Instana ion est installé.

Versions prises en charge

Le capteur NetWeaver d' SAP Java prend en charge SAP Java NetWeaver 7.5.

Configuration du capteur SAP Java NetWeaver

Instana prend en charge la surveillance locale et à distance du capteur SAP Java NetWeaver.

Remarque : ajoutez toutes les configurations de surveillance locales sous la local balise.

Pour connecter le capteur directement à des instances d' SAP, d' Java ou d' NetWeaver, ajoutez les configurations locales ou distantes comme indiqué dans les exemples suivants. Remplacez les valeurs d'exemple par celles spécifiques à votre environnement. L'intervalle d'interrogation par défaut pour les métriques est défini sur 60 secondes.

Veillez à conserver l'espacement avant chaque ligne, comme indiqué dans les exemples suivants, car il respecte la syntaxe de mise en forme de l' YAML.

Configuration locale

Les paramètres de configuration pour la surveillance locale sont indiqués dans l'exemple suivant :

# 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
 

Dans le configuration.yaml fichier, entrez les valeurs appropriées pour les jmxport , user , password et sysnr (ID d'instance). L'intervalle d'interrogation par défaut pour les métriques est défini sur 60 secondes.

Le host paramètre est facultatif pour la surveillance locale. Par défaut, le système utilise localhost ou l'adresse IP de bouclage. Si vous souhaitez que SAP, Java et NetWeaver utilisent un nom d'hôte ou une adresse IP spécifique, vous pouvez inclure le host paramètre dans la configuration.

L'exemple suivant montre où le host paramètre est ajouté à la configuration :
# 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

Configuration à distance

Les paramètres de configuration pour la surveillance à distance sont indiqués dans l'exemple suivant :

# 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
 

Dans le configuration.yaml fichier, entrez les valeurs appropriées pour host , jmxport , user , et sysnr (ID password d'instance). L'intervalle d'interrogation par défaut pour les métriques est défini sur 60 secondes.

Paramètres de configuration

Le tableau suivant répertorie les paramètres de configuration du capteur NetWeaver d' SAP Java :

Paramètres Description
host L'adresse IP ou le nom d'hôte complet de l'instance SAP Java NetWeaver à partir de laquelle le capteur récupère les métriques.
jmxport Le port utilisé pour la communication à distance avec un agent d' JMX.
sysnr L'ID d'instance de l'instance SAP Java NetWeaver, par exemple 01.
user Le nom d'utilisateur configuré dans l'instance SAP Java. L'utilisateur de l' SAP e doit disposer des autorisations nécessaires pour obtenir des métriques. Pour plus d'informations, consultez la section « Vérification des autorisations des utilisateurs pour l'extraction des métriques ».
password Le mot de passe requis pour que l'utilisateur puisse se connecter au système SAP Java NetWeaver.

Vérification de l'autorisation de l'utilisateur à extraire des métriques

Pour activer la surveillance à distance d'un système SAP NetWeaver, configurez Java Management Extensions ( JMX ) du système SAP NetWeaver en suivant les étapes suivantes :

  1. Connectez-vous au système SAP NetWeaver via un navigateur en tant qu'administrateur.
  2. Go Accédez à « Administrateur d' SAP NetWeaver » > « Configuration » > « Infrastructure » > « Propriétés du système d' Java » > « Paramètres d' VM du système ».
  3. Ajoutez les paramètres suivants :
    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 rôle
  4. Si l'authentification est obligatoire, assurez-vous que le paramètre suivant est défini sur true:

    com.sun.management.jmxremote.authenticate = true
Remarque : l'autorisation des utilisateurs s'effectue sur le système SAP Java NetWeaver. Vous devez fournir l'autorisation d'utilisateur correspondant à l'identifiant d'utilisateur et à l'identifiant d'instance indiqués dans la configuration configuration.yaml de ce capteur Java NetWeaver.

Pour accéder aux MBeans JMX, l'utilisateur doit disposer des autorisations appropriées. L'utilisateur peut se voir attribuer n'importe lequel des rôles par défaut disponibles sur SAP, Java ou NetWeaver (tels que Everyone, Guest, ou NWA_READONLY) ou un rôle personnalisé qui a été créé. Assurez-vous que JmxManageAll l'action est bien attribuée au rôle utilisé, car toutes les métriques nécessaires sont enregistrées via JMX.

Les étapes suivantes utilisent le Guest rôle à titre d'illustration, mais elles sont similaires pour tous les autres rôles attribués :

  1. Go Accédez à SAP NetWeaver > Administrateur > Configuration > Sécurité > Gestion des identités.

  2. Recherchez selon le critère Rôle, puis sélectionnez le rôle Invité.

  3. Dans l'onglet Actions assignées, ajoutez jmx.

    NetWeaver rôle

Vous pouvez également attribuer les autorisations d' JMX nécessaires à l'utilisateur concerné au lieu de modifier le rôle Invité.

Affichage des mesures

Une fois l'agent hôte installé et le capteur NetWeaver d' Java s configuré, vous pouvez consulter les métriques et les alertes d' SAP s dans l'interface utilisateur d' Instana.

Vue de l'infrastructure

Pour afficher les métriques dans la vue Infrastructure, procédez comme suit :

  1. Dans la barre latérale de l'interface utilisateur d' Instana, sélectionnez Infrastructure.
  2. Dans l'onglet « Carte », cliquez sur une tour spécifique à SAP Java NetWeaver.
  3. Cliquez sur Ouvrir le tableau de bord.

Vous pouvez consulter le tableau de bord SAP Java NetWeaver, qui présente toutes les métriques collectées.

Vue de la plateforme

Pour afficher les métriques dans la vue Plateforme, procédez comme suit :

  1. Dans le menu de navigation de l'interface utilisateur d' Instana, sélectionnez Plateforme > SAP. Vous pouvez afficher les systèmes, instances et bases de données d' SAP s dans des onglets distincts.
  2. Pour afficher l'instance d' SAP e connectée au capteur Java NetWeaver, cliquez sur l'onglet Instances. Le nom du capteur est généralement indiqué comme JavaNetWeaverInstance@HostName_SID_InstanceID.
  3. Cliquez sur l'instance SAP Java NetWeaver pour afficher le tableau de bord SAP Java NetWeaver contenant toutes les métriques collectées.

Informations collectées

Le tableau suivant présente les indicateurs collectés par l' Java NetWeaver ainsi que la fréquence de leur collecte :

Données métriques collectées Fréquence de collecte
Tâches de l'application 60 secondes
Fils d'application 60 secondes
Pool de threads d'application 60 secondes
Taux de réussite en cache 60 secondes
Utilisation de la mémoire cache 60 secondes
Chargement des classes 60 secondes
Durée de compilation 60 secondes
UC 60 secondes
Utilisation du disque 120 secondes
Collection GC 60 secondes
Erreurs GC 60 secondes
Problèmes de récupération de place 60 secondes
Rapports GC 60 secondes
Mémoire du tas et mémoire hors tas 60 secondes
Demandes HTTP 60 secondes
réponses HTTP 60 secondes
pool de connexions JDBC 60 secondes
Demandes JDBC expirées 60 secondes
Unités d'exécution de la JVM 60 secondes
JVM Charge CPU 60 secondes
JVM Charge moyenne du système 60 secondes
Validité de la licence 60 secondes
Messages de journal 60 secondes
Utilisateurs connectés 60 secondes
Mémoire 60 secondes
Utilisation de l'UC pour le processus 60 secondes
RFC 60 secondes
Sessions 60 secondes
Espace de permutation 60 secondes
Charge moyenne du système 60 secondes
Problèmes système 60 secondes
Mémoire tampon de table 60 secondes
Nombre d'unités d'exécution 60 secondes
Utilisation du pool d'unités d'exécution 60 secondes
Temps d'unité d'exécution 60 secondes
Transactions 60 secondes
Utilisation des tâches en attente 60 secondes
Sessions de conteneurs Web 60 secondes
Demandes du conteneur Web 60 secondes
Débit des conteneurs Web 60 secondes
Sessions Web 60 secondes
WebService 60 secondes
Temps d'activité 60 secondes

Le capteur « Java » ( NetWeaver ) génère des événements intégrés pour divers scénarios. Pour plus d'informations, consultez la section Référence des événements intégrés.

Configuration de la collecte de métriques personnalisées

Vous pouvez collecter des métriques personnalisées spécifiques à votre environnement, en plus des métriques standard, en configurant le capteur « Java » ( NetWeaver ).

Par exemple, vous surveillez à distance un système SAP Java NetWeaver. Pour collecter des métriques relatives au service de messagerie JMS ( Java ), indiquez les informations relatives au JMS dans la section personnalisée, comme le montre l'exemple suivant :

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"