OpenTelemetry Agent - Java WebSphere App Server Installation



Installation Steps

  1. Download the Open Telemetry Java Agent
  2. Move the Opentelemetry-javaagent.jar to a place on the filesystem where the Java application runs
  3. Add the Java Agent JVM parameters to the Application
  4. Restart the Application

JVM Parameters To Be Added to WebSphere

  1. In the WebSphere Administration Console, click Servers
  2. Expand Server Type, then click WebSphere application servers
  3. Expand Java and Process Management, then click Process Definition
  4. Under the Additional Properties section, click Java Virtual Machine
  5. Scroll down and locate the textbox for Generic JVM arguments
  6. Add the lines below to this textbox
  • Find-and-replace $PATH_TO_OPENTELEMETRY_JAVAAGENT_JAR with the full path to this JAR
  • Find-and-replace $PROTOCOL with http or https based on the VF Server configuration
  • Find-and-replace $VF_SERVER_ADDRESS with the URL for login to your organization’s vFunction Server
  • Find-and-replace $VF_APP_ID with the Application UUID created with the Installation Instructions provided after creating the Distributed Application in the vFunction Server UI
-javaagent:$PATH_TO_OPENTELEMETRY_JAVAAGENT_JAR 
-Dotel.exporter.otlp.protocol=http/protobuf 
-Dotel.exporter.otlp.endpoint=$PROTOCOL://$VF_SERVER_ADDRESS/api/unauth/otlp 
-Dotel.traces.exporter=otlp 
-Dotel.exporter.otlp.traces.headers=X-VF-APP=$VF_APP_ID 
-Dotel.metrics.exporter=none 
-Dotel.logs.exporter=none