Created:  | Updated: 


Introduction

This how-to article describes how to enable z/IRIS instrumentation for java applications monitored by Instana APM.

Launch your Java application additional system property:

How to launch applications with z/IRIS environment variables
java -Dmainstorconcept.ziris.enable=true
BASH

How to configure your Java application using command line arguments

Step 1: Open a command prompt and navigate to your java class- or jar-file.

java [-options] class [args...] (to execute a class)
NONE

OR

java [-options] -jar jarfile [args...] (to execute a jar)
NONE

Step 2: The following java variables can be set: 

Environment variable name

Values

Default

Description

-Dmainstorconcept.ziris.enable

true

precondition to enable IronTap integration and must be true to enable integration with z/IRIS Irontap

-Dmainstorconcept.ziris.field

  • ApplicationName

  • ClientHostname

ClientHostname

Name of the JDBC client information property that can be used to hold Instana call.traceId call.spanId values

  • ApplicationName
    This value is stored in Db2 special register CURRENT CLIENT_APPLNAME

  • ClientHostname
    This value is stored in Db2 special register CURRENT CLIENT_WRKSTNNAME

-Dmainstorconcept.ziris.delimiter

<character>

|

ascii pipe character

Character to seperate Instana call.traceId from call.spanId (any ASCII characater except a-f, A-F or 0-9).

-Dmainstorconcept.ziris.mode

  • append

  • override

  • 'append' concatenates the existing value in the selected JDBC client information property with the Instana call.traceId data

  • 'override' replaces the existing value in the selected JDBC client information property with the Instana call.traceId data