Surveillance de SAP avec le détecteur ABAP

Pour surveiller l' SAP s à l'aide du capteur ABAP, vous devez installer l'agent hôte Instana. Une fois que vous avez installé l'agent hôte, le détecteur ABAP est automatiquement installé. Une fois le capteur ABAP configuré, vous pouvez consulter les métriques relatives à l' SAP dans l'interface utilisateur d' Instana.

Pour plus d'informations, consultez la section « Installation de l'agent hôte d' Instana ».

Informations complémentaires

Systèmes d'exploitation pris en charge

Instana prend en charge les systèmes d'exploitation suivants, pris en charge par le connecteur SAP Java pour la surveillance locale et à distance :

  • Pour la surveillance locale (l'agent d' Instana s est installé sur le même hôte que le serveur ABAP) :

    • AIX
    • Linux (x86 et IBM PowerPC 64 bits LE)
    • Windows
  • Pour la surveillance à distance (l'agent d' Instana s est installé sur un autre hôte et se connecte à distance au serveur ABAP) :

    • AIX
    • Linux (x86 et IBM PowerPC 64 bits LE)
    • Windows
    • IBM i (Programme d'aide à l'emploi de l'État de OS/400 )
    • Apple macOS (64 bits-Intel et Apple silicon)
    Remarque : pour la surveillance à distance, l' SAP e peut fonctionner sur n'importe quelle plateforme, y compris IBM i, et être surveillé à distance en installant l'agent Instana sur ces plateformes.

Pour plus d'informations sur les systèmes d'exploitation pris en charge par le connecteur SAP Java, consultez la section « Systèmes d'exploitation pris en charge ».

Versions prises en charge

Le détecteur ABAP prend en charge les versions SAP suivantes:

  • SAP R/3 3.1
  • S/4 HANA et versions ultérieures
  • SAP Java Connecteur 3.1.8 ou version ultérieure

Prérequis

Le capteur ABAP utilise la bibliothèque SAP Java Connector (JCo) pour récupérer les métriques des instances ABAP. Avec votre licence « SAP », vous pouvez télécharger gratuitement la bibliothèque JCo à l'adresse SAP, le connecteur Java à l'adresse 3.1 et le SDK à l'adresse. Pour plus d'informations, consultez la section « Ajouter la bibliothèque JCo d' SAP ».

Remarque : la bibliothèque IDoc d' SAP n'est pas requise pour le capteur ABAP. Il vous suffit de télécharger le fichier SDK SAP Java Connector 3.1 correspondant à la plateforme sur laquelle l'agent Instana est déployé. Par exemple, un agent Instana qui s'exécute sur Linux x86 surveille le serveur d'applications ABAP SAP qui s'exécute sur Windows x86. Vous devez télécharger le fichier SDK SAP Java Connector 3.1 pour Linux x86.

Le capteur ABAP ne prend en charge que SAP JCo 3.1.8 ou une version ultérieure.

Configuration du capteur ABAP

Pour collecter des métriques à partir d'instances ABAP, vous devez configurer le détecteur ABAP comme suit:

Remarque : les informations suivantes s'appliquent aussi bien aux agents statiques qu'aux agents dynamiques. À titre d'exemple, nous utilisons un déploiement basé sur l' Linux. Vous devez suivre la même procédure pour les autres systèmes d'exploitation tels qu' Windows, Mac et les autres systèmes pris en charge par Unix.

Ajouter la bibliothèque JCo d' SAP

Pour ajouter la bibliothèque JCo SAP à un système Linux, procédez comme suit:

  1. Recherchez l'agent Instana installé dans le /opt/instana/agent répertoire.

  2. Dans le répertoire d'installation de l'agent Instana, créez le system/com/sap/sapjco3/<Major>.<Minor>.<patch> répertoire

system/com/sap/sapjco3/3.1.13 « Major » vaut 3, « Minor » vaut 1 et « patch » vaut 13.

Mettez à jour ces valeurs en fonction de la version JAR que vous utilisez.

Les étapes suivantes prennent pour exemple le fichier JAR « SAP » (JCo 3.1.13 ); adaptez la version en fonction du fichier JAR que vous utilisez :

  1. Vérifiez que vous avez configuré une structure de répertoires, telle que/opt/instana/agent/system/com/sap/sapjco3/3.1.13 .

  2. Téléchargez et extrayez leSAP Forfait JCo , et suivez les instructions mentionnées dans leReadme.txt déposer.

    L'installation de JCo dépend de la plate-forme utilisée; vous devez donc télécharger la version de JCo adaptée à la plate-forme sur laquelle l'agent d' Instana s est exécuté. Le capteur ABAP est déployé sur le même ordinateur que l'agent d' Instana s et communique avec le système d' SAP s pour récupérer les métriques.

  3. Une fois le .zip fichier téléchargé et décompressé, copiez le sapjco3.jar fichier depuis le dossier décompressé vers le /opt/instana/agent/system/com/sap/sapjco3/3.1.13/ répertoire.

    Remarque : évitez de décompresser le .zip fichier directement dans le /opt/instana/agent/system/com/sap/sapjco3/3.1.13/ répertoire, car celui-ci contient de nombreux fichiers supplémentaires qui ne sont pas nécessaires à la configuration du capteur. Il vous suffit d'avoir deux fichiers, le sapjco3.jar et un seul fichier de bibliothèque spécifique au système d'exploitation dans ce répertoire.
  4. Dans le répertoire '/opt/instana/agent/system/com/sap/sapjco3/3.1.13/, renommez le fichier 'sapjco3.jar en 'sapjco3-3.1.13.jar.

    Remarque : le répertoire indiqué ne doit contenir qu 'un seul fichier.jar. Dans cet exemple, le fichier.jar est sapjco3-3.1.13.jar.
  5. Placez le fichier de bibliothèque " OS-specific dans le répertoire " /opt/instana/agent/system/com/sap/sapjco3/3.1.13/ L'extension du fichier est " .dll ou " .so.

    Une fois que vous avez placé les fichiers dans le répertoire, votre répertoire doit apparaître comme suit. L'exemple suivant illustre un répertoire d'installation Linuxaprès y avoir placé le fichier:

    ls /opt/instana/agent/system/com/sap/sapjco3/3.1.13/
    libsapjco3.so  sapjco3-3.1.13.jar
     

    Vous ne devez pas renommer les fichiers avec l'extension .dll ou .so.

  6. Modifiez le libpath paramètre dans votre configuration.yaml fichier pour qu'il prenne la valeur /opt/instana/agent/system/com/sap/sapjco3/3.1.13/. Pour plus d'informations, consultez la section « Paramètres de configuration ».

Connecter le capteur ABAP aux instances ABAP

Instana peut se connecter à vos instances ABAP d' SAP, soit directement, soit via le serveur de messages d' SAP.

Si votre instance ABAP ou votre serveur de messages d' SAP e n'autorise pas les connexions directes depuis des clients externes et exige à la place une connexion via SAProuter, consultez la section Connexion via SAProuter.

Vous devez configurer le capteur ABAP pour qu'il se connecte à une ou plusieurs instances ABAP, soit directement, soit via le serveur de messageri SAP. Ne mélangez pas les deux configurations.

Connexion directe aux instances ABAP

Instana prend en charge la surveillance locale et à distance du capteur ABAP d' SAP.

Remarque : ajoutez toutes les configurations de surveillance locale sous la balise « local ».

Pour connecter directement le capteur ABAP aux instances ABAP, ajoutez les configurations locales ou distantes comme indiqué dans les exemples suivants. Saisissez les valeurs appropriées pour les paramètres. L'intervalle d'interrogation par défaut de la métrique est défini sur 60 secondes.

Configuration locale

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

# SAP ABAP
com.instana.plugin.sap.abap:
  # local monitoring configuration
  local : #multiple configurations supported
    - sysnr: '72'
      client: '100'
      user: 'User1'
      password: 'password'
      lang: 'en'
      pool_capacity: '10'
      libpath: <INSERT_SAP_JCO_LIBRARY_LOCATION>
      # path to JCo drivers. For static agent configuration details, follow documentation.
      poll_rate: 60 # seconds
 

Configuration à distance

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

# SAP ABAP
com.instana.plugin.sap.abap:
  # remote monitoring configuration
  remote : #multiple configurations supported
    - host: 'remote.host-1.com'
      sysnr: '72'
      client: '100'
      user: 'User1'
      password: 'password'
      lang: 'en'
      pool_capacity: '10'
      libpath: <INSERT_SAP_JCO_LIBRARY_LOCATION>
      # path to JCo drivers. For static agent configuration details, follow documentation.
      poll_rate: 60 # seconds
    - host: 'remote.host-2.com'
      sysnr: '01'
      client: '900'
      user: 'User2'
      password: 'password'
      lang: 'en'
      pool_capacity: '10'
      libpath: <INSERT_SAP_JCO_LIBRARY_LOCATION>
      # path to JCo drivers. For static agent configuration details, follow documentation.
      poll_rate: 60 # seconds
 

Veillez à conserver la mise en forme des espaces avant chaque ligne, comme indiqué dans les exemples précédents, car elle respecte la syntaxe de mise en forme de l' YAML.

Paramètres de configuration

Le tableau suivant répertorie les paramètres de configuration d'un capteur ABAP d' SAP lors d'une connexion directe à des instances ABAP :

Paramètres Description
host Adresse IP ou nom d'hôte qualifié de l'instance SAP à partir de laquelle le détecteur ABAP extrait les métriques.
sysnr ID de l'instance SAP ABAP, par exemple 01.
client ID client de l'instance ABAP SAP , par exemple 200.
user Le nom d'utilisateur configuré dans l'instance d' SAP. 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érifier l'autorisation de l'utilisateur pour extraire des métriques ».
password Mot de passe requis pour la connexion au système SAP pour l'utilisateur.
libpath Dossier dans lequel JCo est configuré sur votre ordinateur et qui contient les fichiers de bibliothèque spécifiques au système d'exploitation. Par exemple, '/opt/instana/agent/system/com/sap/sapjco3/3.1.13/'. Pour les systèmes fonctionnant sous Linux, le répertoire doit contenir un libsapjco3.so fichier. Pour les systèmes fonctionnant sous Windows, le répertoire doit contenir un sapjco3.dll fichier.
lang Langue de connexion de SAP. La valeur par défaut est "en".
pool_capacity Nombre maximal de connexions que les détecteurs ABAP peuvent établir à l'instance SAP .

Connexion à des instances ABAP via le serveur de messages d' SAP

Vous pouvez configurer le capteur ABAP pour qu'il se connecte à vos instances ABAP via le serveur de messages.

Pour vous connecter à des instances ABAP via le serveur de messages d' SAP, utilisez la configuration indiquée dans l'exemple suivant :

# SAP ABAP
com.instana.plugin.sap.abap:
  remote : # Connecting via Message Server
    - host: 'remote.messageserver-host.com'
      port: '3600' # Default port for Message Server
      type: 'message_server'
      client: '100'
      user: 'User1'
      password: 'password'
      group : 'PUBLIC' # Optional, Default is PUBLIC
      lang: 'en'
      pool_capacity: '10'
      libpath: <INSERT_SAP_JCO_LIBRARY_LOCATION>
      # path to JCo drivers. For static agent configuration details, follow documentation.
      poll_rate: 60 # seconds
 

Paramètres de configuration

Le tableau suivant répertorie les paramètres de configuration d'un capteur ABAP d' SAP lors de la connexion à des instances ABAP via le serveur de messages d' SAP :

Paramètres Description
host L'adresse IP ou le nom d'hôte complet du serveur de messages.
port Le port du serveur de messages correspond généralement à la somme de 3600 et de l'identifiant d'instance à deux chiffres. Par exemple, si l'ID d'instance est 01, le port du serveur de messages est 3601. Le port par défaut est 3600.
type Définit sur message_server.
client L'identifiant client du système SAP, par exemple, 200.
user Le nom d'utilisateur configuré dans l'instance d' SAP. 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érifier l'autorisation de l'utilisateur pour extraire des métriques ».
password Mot de passe requis pour la connexion au système SAP pour l'utilisateur.
group (facultatif) Le groupe de connexion. La valeur par défaut est PUBLIC.
libpath Dossier dans lequel JCo est configuré sur votre ordinateur et qui contient les fichiers de bibliothèque spécifiques au système d'exploitation. Par exemple, '/opt/instana/agent/system/com/sap/sapjco3/3.1.13/'. Pour les systèmes fonctionnant sous Linux, le répertoire doit contenir un libsapjco3.so fichier. Pour les systèmes fonctionnant sous Windows, le répertoire doit contenir un sapjco3.dll fichier.
lang Langue de connexion de SAP. La valeur par défaut est "en".
pool_capacity Nombre maximal de connexions que les détecteurs ABAP peuvent établir à l'instance SAP .

Connexion via SAProuter

Si votre instance ABAP d' SAP ou votre serveur de messages n'autorise pas les connexions directes depuis des clients externes et exige à la place une connexion via SAProuter, vous devez ajouter le paramètre supplémentaire suivant dans le configuration.yaml fichier :

sap_router: '/H/saprouter-host'
 

Si le SAProuter fonctionne sur un port différent du port par défaut 3299, vous pouvez indiquer le numéro de port comme suit :

sap_router: '/H/saprouter-host/P/saprouter-port'
 

Vérifier les autorisations de l'utilisateur pour récupérer les métriques

Assurez-vous que l'utilisateur spécifié dans la configuration du capteur ABAP du fichier « YAML » est autorisé à extraire des métriques de l'application JCo « SAP ».

Pour extraire des métriques de SAP JCo, vous devez fournir les paramètres Authorization Object suivants dans le compte utilisateur SAP :

Authorization Object: S_RFC
    RFC_TYPE: Function Module
    RFC_NAME: *
    Activity: Execute

Authorization Object: /SDF/E2E
    Activity: 03

Authorization Object: S_ADMI_FCD
    S_ADMI_FCD: ST0R

Authorization Object: S_RZL_ADM
    Activity: 03

Authorization Object: S_TABU_DIS
    DICBERCLS: &NC&,EDI0,SA,SC,SS,SPWD
    Activity: 03
 
Remarque : l'autorisation des utilisateurs s'effectue sur le système ABAP d' SAP. L'autorisation utilisateur doit être fournie pour le même utilisateur, le même ID d'instance et le même ID client que ceux spécifiés dans la configuration ( configuration.yaml ) de ce capteur ABAP.

Affichage des mesures

Une fois l'agent hôte installé et le capteur ABAP 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, 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.
  3. Cliquez sur Ouvrir le tableau de bord.

Vous pouvez voir le tableau de bord SAP avec toutes les métriques collectées.

Vue de la plateforme

Pour afficher les métriques sur Platform, procédez comme suit:

  1. Dans le menu de navigation de l'interface utilisateur d' Instana, sélectionnez « Platform » > « SAP ». Vous pouvez consulter les listes des systèmes, des instances et des bases de données.
  2. Pour afficher l'instance SAP connectée au détecteur ABAP, cliquez sur l'onglet Instances . Le nom du capteur est indiqué comme suit AbapInstance@HostName_SID_InstanceID:.

Tableaux de bord SAP

Métriques

Le détecteur ABAP collecte les métriques suivantes:

  • UC
  • Mémoire
  • Processus de travail
  • Travaux en arrière-plan
  • Connexions de base de données
  • Latence de la base de données
  • Connexions utilisateur
  • Temps de réponse de la charge de travail
  • Temps d'activité
  • Processus principal
  • File d'attente des demandes
  • Données de disque
  • Système de fichiers
  • Erreurs et vidages
  • Statistiques d'utilisateur
  • Spoule
  • Liste des occurrences de la base de données
  • Clients Web
  • Destinations Web
  • Demande de transport
  • Appels RFC
  • RFC transactionnel
  • RFC en attente
  • Réseau
  • ICM
  • Fiori
  • Connexions de passerelle
  • Journaux des erreurs de passerelle
  • Verrouiller l'entrée
  • Statistiques de passerelle
  • IDoc
  • Erreurs du journal système
  • Erreurs de mise à jour
  • Statistiques du journal système
  • Statistiques de cliché ABAP
  • Entrées de verrou
  • Erreurs de spool
  • Modifications de la configuration du système
  • Modifications de la configuration du client

Fréquence de collecte des données

Le tableau suivant décrit la fréquence de collecte des métriques par le détecteur ABAP:

Métrique collectée Fréquence de collecte
Travaux en arrière-plan 30 secondes
Liste des processus de travail 60 secondes
Statut du processus de travail 60 secondes
État du travail 60 secondes
HTTP Indicateurs 60 secondes
SPOOL 60 secondes
Liste d'utilisateurs 60 secondes
Connexion de base de données 60 secondes
Liste des occurrences de la base de données 60 secondes
Métriques Fiori 60 secondes
Appels RFC 60 secondes
Utilisation de la mémoire 60 secondes
Temps de réponse de dialogue 60 secondes
Statut du serveur 90 secondes
Vidages ABAP 2 minutes
Liste des entrées de verrou 2 minutes
Erreur de Mise à Jour 2 minutes
Demande de transport 2 minutes
Métriques de passerelle 2 minutes
Statistiques de mémoire tampon 3 minutes
Historique des clichés courts 3 minutes
Informations utilisateur 3 minutes
Liste des principaux processus 3 minutes
Journal système 3 minutes
Pagination en entrée et en sortie 3 minutes
Métriques d'unité centrale 3 minutes
Interface LAN 4 minutes
Erreurs de passerelle 4 minutes
File d'attente des demandes 5 minutes
ICM 5 minutes
IDoc entrant 5 minutes
IDoc sortant 5 minutes
Journaux d'erreurs RFC 5 minutes
Clients Web 5 minutes
Destinations Web 5 minutes
Système de fichiers 7 minutes
Données de disque 10 minutes

SAP Le capteur ABAP génère des événements intégrés pour divers scénarios. Pour plus d'informations, voir Référence des événements intégrés .