Troubleshooting OpenTelemetry integration
Created , Updated
Verify that the relevant components are available and meet the minimum requirements.
Confirm that the Java SDK ≥ 8
Open a command prompt and execute the command:
java -version
Expected result is a Java version of ≥1.8. Example output:
java version "1.8.0_181"
Java(TM) SE Runtime Environment (build 1.8.0_181-b13)
Java HotSpot(TM) 64-Bit Server VM (build 25.181-b13, mixed mode)
Check the OpenTelemetry Java Agent version ≥ 1.3.0
Open a command prompt and execute the command:
java -jar path/to/opentelemetry-javaagent-all.jar
Expected result is an OpenTelemetry Agent version of ≥1.3.0. Example output:
1.3.1
(Optional) Check OpenTelemetry (Contrib) Collector (≥ 0.29.0)
Open a command prompt and execute the command:
Old OpenTelemetry (Contrib) Collector versions may not support this command. In this case an update is recommended.
otelcol --version # OpenTelemetry Collector
otelcontribcol --version # OpenTelemetry Contrib Collector
Expected result is an OpenTelemetry Contrib Collector version of ≥0.29.0. Example output:
otelcol version v0.29.0 # OpenTelemetry Collector
otelcontribcol version v0.29.0 # OpenTelemetry Contrib Collector
Check z/IRIS IronTap (≥ 1.6.2)
If the z/IRIS IronTap version is unknown, then the most recent version can be downloaded instead of doing the following described steps.