Created:  | Updated: 


z/IRIS creates spans (traces) that comply with OpenTelemetry's OTLP specification. Below is a list of all z/OS Work related attributes created and used by z/IRIS for mainframe-related spans, as well as the IBM SMF record values that z/IRIS uses to populate the attribute values.


Attribute context

Attribute Prefix

Mainframe system context

zos.**

IBM z/OS operating system-wide identifiers. For example, zos.sysplex.name identifies the z/OS LPAR cluster that processed the requests and can be found in all mainframe related spans to identify any request processed by the same zos.sysplex.name.

service.**

host.**

os.**

Service, host and operating system attributes as defined in OpenTelemetry's resource semantic conventions.

enduser.**

General attributes as defined in OpenTelemetry's trace semantic conventions.

Attributes list

z/IRIS / OpenTelemetry attributes

IBM SMF source

Resource attributes

zos.sysplex.name

SMF30SYP

zos.subsystem.name

SMF30PNM

OpenTelemetry resource attributes

service.name

SMF30WID

service.instance.id

SMF30JNM

host.name

SMF30SYN

host.arch

-

os.type

-

Custom attributes

zos.job.class

SMF30CL8

zos.user.id

SMF30UIF

zos.user.name

SMF30USR

zos.racf.group.id

SMF30GRP

ziris.job.identifier

Aggregated String of SMF30SYP, SMF30SYN, SMF30JNM, SMF30JBN, SMF30RET, SMF30RED

zos.jes.job.correlator

SMF30COR

OpenTelemetry attributes

enduser.id

SMF30RUD

Additional custom attributes for subtype 4

zos.job.step.cpu.units

SMF30CSU

zos.job.step.program_name

SMF30PGM

zos.job.step.ended

-

zos.job.step.name

SMF30STM

zos.job.step.number

SMF30STN

zos.job.step.cpu.time_ms

Sum of SMF30CPT, SMF30CPS, SMF30ICU, SMF30ISB, SMF30IIP, SMF30RCT, SMF30HPT

zos.job.step.ziip.time_ms

Sum of SMF30_TIME_ON_ZIIP, SMF30_TIME_ON_IFA

zos.tape.mounts

Sum of SMF30PTM, SMF30TPR

zos.job.step.return_code

SMF30SCC as formatted String

Additional custom attributes for subtype 5

zos.job.cpu.units

SMF30CSU

zos.job.ended

-

zos.job.cpu.time_ms

Sum of SMF30CPT, SMF30CPS, SMF30ICU, SMF30ISB, SMF30IIP, SMF30RCT, SMF30HPT

zos.job.ziip.time_ms

Sum of SMF30_TIME_ON_ZIIP, SMF30_TIME_ON_IFA

zos.tape.mounts

Sum of SMF30PTM, SMF30TPR

zos.job.return_code

SMF30SCC as formatted String