DocumentaciónAide

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

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.

  1. 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.jar
  1. Dé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.jar
  1. Si 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é :

  1. Instrumenter l'appelant : l'API Java, Node ou Python qui utilise DB2 par JDBC ou ODBC ou qui appelle des programmes avec JTOpen.

  2. Instrumenter le serveur passerelle Linux qui publie le site web ou l'API devant l'IBM i (voir la section suivante).

  3. 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_POST vers l'URL d'ingestion.

  4. 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.

Voir aussi

Rechercher dans Argunis Monitoring

Saisissez au moins 2 caractères pour rechercher dans Argunis Monitoring.

↑↓ naviguer · Enter ouvrir · Esc fermer