DocumentaciónAjuda

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

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.

  1. 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.jar
  1. Inicie 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.jar
  1. Se 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:

  1. Instrumentar quem os chama: a API Java, Node ou Python que usa o DB2 por JDBC ou ODBC ou que chama programas com JTOpen.

  2. Instrumentar o servidor ponte Linux que publica a web ou a API na frente do IBM i (veja a seção seguinte).

  3. 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_POST para a URL de ingestão.

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

Relacionado

Pesquisar em Argunis Monitoring

Digite pelo menos 2 letras para pesquisar em Argunis Monitoring.

↑↓ navegar · Enter abrir · Esc fechar