Instrumentar em IBM i e sistemas legados
Como levar ao APM as aplicações Java do IBM i e o que é possível com RPG, COBOL e CL, além do guia para sistemas que não podem ser modificados.
Nesta página
O APM também recebe dados do IBM i (AS/400) e de sistemas antigos. Os guias estão em Configurações → APM → Chave de API e SDK, seção SDK por linguagem e outras formas de enviar, aba Legados e IBM i.
Antes de começar
Um token de servidor e a URL de ingestão. Veja Criar um token de ingestão.
Se o IBM i não sair para a internet, um OpenTelemetry Collector na rede que sirva de ponte. Veja Instrumentar em nuvens e contêineres.
IBM i · Java
As aplicações Java no IBM i (IBM Technology for Java ou OpenJ9, Java 8 ou superior) usam o mesmo agente oficial. As consultas ao DB2 for i por JDBC (JTOpen/jt400) aparecem como dependências de banco de dados.
Copie o agente para o IFS, por exemplo com scp ou pelo 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.jarInicie a JVM com o agente (no QSH ou no job que a inicia). Os parâmetros são os mesmos de sempre, como propriedades do 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.jarSe o IBM i não sair para a internet, aponte para o Collector da sua rede, por exemplo
-Dotel.exporter.otlp.endpoint=http://collector.interno:4318.
IBM i · RPG, COBOL e CL
RPG, COBOL e CL não têm um runtime que o OpenTelemetry possa instrumentar sozinho. O guia propõe, do maior para o menor nível de detalhe:
Instrumentar quem os chama: a API Java, Node ou Python que usa o DB2 por JDBC ou ODBC ou que chama programas com JTOpen.
Instrumentar o servidor ponte Linux que publica a web ou a API na frente do IBM i (veja a seção seguinte).
Enviar spans manualmente a partir do RPG ou do COBOL com SQL embutido, usando as funções HTTP do QSYS2 (IBM i 7.4 TR5 ou 7.3 TR11 em diante). O guia traz o exemplo completo com
QSYS2.HTTP_POSTpara a URL de ingestão.Enviar os logs do IBM i (syslog, QHST ou spool exportado) com um Collector em um servidor ponte. O guia traz a configuração do Collector.
Sistemas que não podem ser modificados
A aba Sem mexer no código inclui um guia para o OBI (OpenTelemetry eBPF Instrumentation), uma ferramenta do projeto OpenTelemetry que é instalada à parte, em um contêiner, em um servidor Linux (kernel 5.8 ou superior com BTF, ou RHEL 8). Ele observa as requisições HTTP, gRPC e SQL de qualquer processo, incluindo binários de terceiros, e envia traces ao ARGUNIS com o seu token.
O OBI precisa de privilégios de kernel: use-o só com autorização e em um contêiner à parte. Ele ainda é uma versão 0.x, então fixe uma versão específica em produção. O ARGUNIS ainda não tem um agente próprio que instrumente sem mexer no código; este guia usa a ferramenta do OpenTelemetry.
O que acontece depois
Cada programa ou serviço aparece em APM → Serviços com o nome que você deu. Se você usou host.name, o ARGUNIS o vincula a esse servidor do inventário quando ele existe.