Configure ziris-instrumentation-extension

Created 16 Jul 2021, Updated 30 Aug 2021

Refer to OpenTelemetry Java Instrumentation Extension for more information about z/IRIS instrumentation with OpenTelemetry.

ziris-instrumentation-extension properties

The following Java system properties customize the ziris-instrumentation-extension:

Property

Default

DESCRIPTION

Values

mainstorconcept.ziris.jdbc.field

ClientHostName

The JDBC client information property that can be used to store the call.traceId and call.spanId values

ApplicationName

Db2 for z/OS special register CURRENT CLIENT_APPLNAME

ClientHostName

Db2 for z/OS special register CURRENT CLIENT_WRKSTNNAME

Example:

Assuming that the command to start your Java application look like this:

CODE

java -javaagent:path/to/opentelemetry-javaagent-all.jar \
     -Dotel.javaagent.extensions=path/to/ziris-instrumentation-extension.jar \
     -jar myApplication.jar

The following example would configure the ziris-instrumentation-extension to store OpenTelemetry trace and span IDs in the ApplicationName JDBC client property for each JDBC call:

CODE

java -javaagent:path/to/opentelemetry-javaagent-all.jar \
     -Dotel.javaagent.extensions=path/to/ziris-instrumentation-extension.jar \
     -Dmainstorconcept.ziris.jdbc.field="ApplicationName" \
     -jar myApplication.jar