DocumentaciónAyuda

Instrumentar en IBM i y sistemas legados

Cómo llevar al APM las aplicaciones Java de IBM i y lo posible con RPG, COBOL y CL, más la guía para sistemas que no se pueden modificar.

En esta página

El APM también recibe datos de IBM i (AS/400) y de sistemas antiguos. Las guías están en Configuración → APM → API key y SDK, sección SDK por lenguaje y otras formas de enviar, pestaña Legados e IBM i.

Antes de empezar

IBM i · Java

Las aplicaciones Java en IBM i (IBM Technology for Java u OpenJ9, Java 8 o superior) usan el mismo agente oficial. Las consultas a DB2 for i por JDBC (JTOpen/jt400) aparecen como dependencias de base de datos.

  1. Copia el agente al IFS, por ejemplo con scp o desde 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. Arranca la JVM con el agente (en QSH o en el trabajo que la inicia). Los parámetros son los mismos de siempre, como propiedades de 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 IBM i no sale a internet, apunta al Collector de tu red, por ejemplo -Dotel.exporter.otlp.endpoint=http://collector.interno:4318.

IBM i · RPG, COBOL y CL

RPG, COBOL y CL no tienen un runtime que OpenTelemetry pueda instrumentar solo. La guía propone, de más a menos detalle:

  1. Instrumentar a quien los llama: la API Java, Node o Python que usa DB2 por JDBC u ODBC o que llama programas con JTOpen.

  2. Instrumentar el servidor puente Linux que publica la web o la API frente a IBM i (ver la sección siguiente).

  3. Enviar spans a mano desde RPG o COBOL con SQL embebido, usando las funciones HTTP de QSYS2 (IBM i 7.4 TR5 o 7.3 TR11 en adelante). La guía trae el ejemplo completo con QSYS2.HTTP_POST hacia la URL de ingesta.

  4. Enviar los logs de IBM i (syslog, QHST o spool exportado) con un Collector en un servidor puente. La guía trae la configuración del Collector.

Sistemas que no se pueden modificar

La pestaña Sin tocar código incluye una guía para OBI (OpenTelemetry eBPF Instrumentation), una herramienta del proyecto OpenTelemetry que se instala aparte, en un contenedor, en un servidor Linux (kernel 5.8 o superior con BTF, o RHEL 8). Observa las peticiones HTTP, gRPC y SQL de cualquier proceso, incluidos binarios de terceros, y envía trazas a ARGUNIS con tu token.

OBI necesita privilegios de kernel: úsalo solo con autorización y en un contenedor aparte. Todavía es una versión 0.x, así que fija una versión concreta en producción. ARGUNIS aún no tiene un agente propio que instrumente sin tocar código; esta guía usa la herramienta de OpenTelemetry.

Qué pasa después

Cada programa o servicio aparece en APM → Servicios con el nombre que le diste. Si usaste host.name, ARGUNIS lo vincula con ese servidor del inventario cuando existe.

Relacionado

Buscar en Argunis Monitoring

Escribe al menos 2 letras para buscar en Argunis Monitoring.

↑↓ moverse · Enter abrir · Esc cerrar