Instrumenter sur IBM i et les systèmes hérités
Comment amener dans l'APM les applications Java d'IBM i et ce qui est possible avec RPG, COBOL et CL, ainsi que le guide pour les systèmes qui ne peuvent pas être modifiés.
Sur cette page
L'APM reçoit aussi des données d'IBM i (AS/400) et de systèmes anciens. Les guides se trouvent dans Paramètres → APM → Clé API et SDK, section SDK par langage et autres façons d'envoyer, onglet Systèmes historiques et IBM i.
Avant de commencer
Un jeton serveur et l'URL d'ingestion. Voir Créer un jeton d'ingestion.
Si l'IBM i ne sort pas sur Internet, un OpenTelemetry Collector dans le réseau qui sert de passerelle. Voir Instrumenter dans les clouds et conteneurs.
IBM i · Java
Les applications Java sur IBM i (IBM Technology for Java ou OpenJ9, Java 8 ou supérieur) utilisent le même agent officiel. Les requêtes vers DB2 for i par JDBC (JTOpen/jt400) apparaissent comme dépendances de base de données.
Copiez l'agent dans l'IFS, par exemple avec scp ou depuis QSH :
mkdir -p /QOpenSys/opt/otel
curl -L -o /QOpenSys/opt/otel/opentelemetry-javaagent.jar \
https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/latest/download/opentelemetry-javaagent.jarDémarrez la JVM avec l'agent (dans QSH ou dans le travail qui la lance). Les paramètres sont les mêmes que d'habitude, sous forme de propriétés Java :
java -javaagent:/QOpenSys/opt/otel/opentelemetry-javaagent.jar \
-Dotel.service.name=mi-servicio \
-Dotel.exporter.otlp.endpoint=https://URL_DE_INGESTA \
-Dotel.exporter.otlp.protocol=http/protobuf \
-Dotel.exporter.otlp.headers=Authorization=Bearer%20jtk_TU_TOKEN_DE_SERVIDOR \
-Dotel.resource.attributes=deployment.environment.name=produccion,host.name=AS400PRD \
-jar app.jarSi l'IBM i ne sort pas sur Internet, pointez vers le Collector de votre réseau, par exemple
-Dotel.exporter.otlp.endpoint=http://collector.interno:4318.
IBM i · RPG, COBOL et CL
RPG, COBOL et CL n'ont pas de runtime qu'OpenTelemetry puisse instrumenter automatiquement. Le guide propose, du plus détaillé au moins détaillé :
Instrumenter l'appelant : l'API Java, Node ou Python qui utilise DB2 par JDBC ou ODBC ou qui appelle des programmes avec JTOpen.
Instrumenter le serveur passerelle Linux qui publie le site web ou l'API devant l'IBM i (voir la section suivante).
Envoyer des spans à la main depuis RPG ou COBOL avec du SQL intégré, en utilisant les fonctions HTTP de QSYS2 (IBM i 7.4 TR5 ou 7.3 TR11 et ultérieurs). Le guide comporte l'exemple complet avec
QSYS2.HTTP_POSTvers l'URL d'ingestion.Envoyer les journaux de l'IBM i (syslog, QHST ou spool exporté) avec un Collector sur un serveur passerelle. Le guide comporte la configuration du Collector.
Systèmes qui ne peuvent pas être modifiés
L'onglet Sans toucher au code inclut un guide pour OBI (OpenTelemetry eBPF Instrumentation), un outil du projet OpenTelemetry qui s'installe à part, dans un conteneur, sur un serveur Linux (noyau 5.8 ou supérieur avec BTF, ou RHEL 8). Il observe les requêtes HTTP, gRPC et SQL de n'importe quel processus, y compris des binaires tiers, et envoie des traces à ARGUNIS avec votre jeton.
OBI a besoin de privilèges noyau : ne l'utilisez qu'avec autorisation et dans un conteneur séparé. Il s'agit encore d'une version 0.x : fixez une version précise en production. ARGUNIS n'a pas encore d'agent propre qui instrumente sans toucher au code ; ce guide utilise l'outil d'OpenTelemetry.
Ce qui se passe ensuite
Chaque programme ou service apparaît dans APM → Services avec le nom que vous lui avez donné. Si vous avez utilisé host.name, ARGUNIS l'associe à ce serveur de l'inventaire s'il existe.