Troubleshooting ziris-instrumentation-extension
Created , Updated
Refer to the following steps to resolve tracing issues related to the OpenTelemetry Instrumentation Extension feature with OpenTelemetry.
Step 1: Check Components
Step 1.a: OpenTelemetry components
Follow the Troubleshooting OpenTelemetry integration article to verify that the relevant OpenTelemetry components are available and implemented correctly.
Step 1.b: ziris-instrumentation-extension
Refer to the ziris-instrumentation-extension versioning to verify that the OpenTelemetry Agent is compatible with the ziris-instrumentation-extension module implemented.
Step 2: Activation
Refer to Activate ziris-instrumentation-extension to verify that the z/IRIS Instrumentation Extension module has been activated correctly.
Step 3: Configuration
Refer to Configure ziris-instrumentation-extensionto verify that the z/IRIS Instrumentation Extension has been configured correctly.
If -Dmainstorconcept.ziris.jdbc.field
has been configured, it must be set to one of the provided values. Incorrect values will result in the following warning message will be logged and the z/IRIS instrumentation will be disabled.
[otel.javaagent 2021-07-14 20:10:38:457 +0200] [main] WARN com.mainstorconcept.ziris.instrumentation.jdbc.helper.ZirisConfig - JDBC field 'ApplicationHostName' is not supported, z/IRIS instrumentation will be disabled.
Step 4: Logging
Verify that the instrumentation works correctly using logging: