Perhaps the most convenient way to start capturing telemetry from Java (or, generally speaking, JVM) is to incorporate OpenTelemetry Instrumentation for Java. It automatically detects when one of the popular libraries is being used in the service and injects the instrumentation without writing any code. It’s also possible to mix automatic instrumentation with manual instrumentation if needed. This method works for all Java 8+ JVMs.
If the OTLP Java exporter fails due to missing system libraries, we recommend using the Zipkin exporter.
The Java agent and configuration needs to be provided for each of the monitored service instances. The address of the OpenTelemetry Collector (or Collector/Agent) needs to be prepared first (
COLLECTOR_HOSTNAME) and the desired name of the service (
SERVICE_NAME) and application (
Instruction below applies to OpenTelemetry Java Auto Instrumentation in version 1.16.0.
Step 1: Download and distribute the agent JAR
The agent should be downloaded and distributed to each of the service hosts or containers, as the JVM will need access to it.
Step 2: Update the JVM configuration (valid for version 1.16.0)
Either of the following options could be used as the template, with the following changes:
The path to the javaagent JAR file needs to replaced with the location of the file downloaded and distributed in step 1.
COLLECTOR_HOSTNAMEmust be provided with the location of the OpenTelemetry Collector/Agent (recommended for production) or Sumo Logic HTTP Traces source. Refer to the following setup instructions if you don't have yet collector installed:
SERVICE_NAMEneeds to be replaced with the name used for the identification of the service.
APPLICATION_NAMEneeds to be replaced with the name used for the identification of the application.
Option 1: Leveraging environment variables (recommended)
The following environment variables need to be made accessible by JVM:
Option 2: Cchanging the java command line
The command line of the service needs to be appended with the following attributes:
java -javaagent:path/to/opentelemetry-javaagent.jar \
To confirm the instrumentation was installed, after starting the service, the following log lines are to be expected in the console:
[otel.javaagent 2022-08-19 09:58:00:822 +0000] [main] INFO io.opentelemetry.javaagent.tooling.VersionLogger - opentelemetry-javaagent - version: 1.16.0
When errors are present in the console, describing that some system libraries are missing or that connection cannot be established, a Zipkin exporter can be used instead of OTLP, for example: