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 ».
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:
Ajouter la bibliothèque JCo d' SAP
Pour ajouter la bibliothèque JCo SAP à un système Linux, procédez comme suit:
Recherchez l'agent Instana installé dans le
/opt/instana/agentrépertoire.Dans le répertoire d'installation de l'agent Instana, créez le
system/com/sap/sapjco3/<Major>.<Minor>.<patch>répertoire
où 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 :
Vérifiez que vous avez configuré une structure de répertoires, telle que
/opt/instana/agent/system/com/sap/sapjco3/3.1.13.Téléchargez et extrayez leSAP Forfait JCo , et suivez les instructions mentionnées dans le
Readme.txtdé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.
Une fois le
.zipfichier téléchargé et décompressé, copiez lesapjco3.jarfichier 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.zipfichier 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, lesapjco3.jaret un seul fichier de bibliothèque spécifique au système d'exploitation dans ce répertoire.Dans le répertoire '
/opt/instana/agent/system/com/sap/sapjco3/3.1.13/, renommez le fichier 'sapjco3.jaren 'sapjco3-3.1.13.jar.Remarque : le répertoire indiqué ne doit contenir qu 'un seul fichier.jar. Dans cet exemple, le fichier.jar estsapjco3-3.1.13.jar.Placez le fichier de bibliothèque "
OS-specificdans le répertoire "/opt/instana/agent/system/com/sap/sapjco3/3.1.13/L'extension du fichier est ".dllou ".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.jarVous ne devez pas renommer les fichiers avec l'extension
.dllou.so.- Modifiez le
libpathparamètre dans votreconfiguration.yamlfichier 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.
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
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:
- Dans la barre latérale de l'interface utilisateur d' Instana, sélectionnez « Infrastructure ».
- Dans l'onglet Carte , cliquez sur une tour spécifique à SAP.
- 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:
- 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.
- 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:.

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 .