Troubleshooting OpenTelemetry integration

Created 13 Jul 2021, Updated 23 Jul 2021

Verify that the relevant components are available and meet the minimum requirements.

Open a command prompt and execute the command:

java -version

BASH

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)

CODE

Open a command prompt and execute the command:

java -jar path/to/opentelemetry-javaagent-all.jar

BASH

Expected result is an OpenTelemetry Agent version of ≥1.3.0. Example output:

1.3.1

CODE

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

TEXT

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

CODE

If the z/IRIS IronTap version is unknown, then the most recent version can be downloaded instead of doing the following described steps.

IronTap container instructions ...

Open a command prompt and execute the command:

docker inspect irontap | grep -Po 'Image.*irontap:\K\d.\d.\d'

BASH

Expected result is an IronTap version of ≥ 1.6.2. Example output:

1.6.2

TEXT

IronTap server instructions

Assess IronTap logs by executing the following command:

cat path/to/irontap/logs/irontapInfo.log | grep -Po 'irontap-core-\K\d.\d.\d' | sort -u

BASH

Expected result is an IronTap version of ≥ 1.6.2. Example output:

1.6.2

CODE