OpenTelemetry Agent - Java Jetty App Server Installation
Installation Wizard
To help with the installation process, vFunction offers an Installation Wizard. This Wizard provides additional information about the Prerequisites as well as steps for deploying the OpenTelemetry Agent to your environment.
Please contact support@vfunction.com or your vFunction Contact(s) for the password to start using this Wizard.
Installation Steps
- Download the Open Telemetry Java Agent
- Move the Opentelemetry-javaagent.jar to a place on the filesystem where the Java application runs
- Add the Java Agent JVM parameters to the Application
- Restart the Application
JVM Parameters To Be Added to JBoss
- On the Jetty Application Server, open
JETTY_HOME/bin/jetty.sh
- Find the section of the file for setting the Java VM options
/Java VM options
- Add the lines below to this file
- 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
VFUN_OPTS="-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"
JAVA_OPTIONS="$JAVA_OPTIONS $VFUN_OPTS"