Created:  | Updated: 

z/IRIS extends OpenTelemetry observability to support mainframe systems and applications. Additionally, z/IRIS enriches mainframe traces with attributes to facilitate searching, filtering and analysis of traces in APM tools.

service.name

OpenTelemetry defines service.name as a logical name of the service, and requires that this attribute be set for all traces. More information about this and other attributes and labels is available on CNCF’s OpenTelemetry website here.

z/IRIS sets service.name according to the type of subsystem, application or unit of work that the trace represents.

service.name values

Description

db2

Traces created from Db2 z/OS SMF records types 100-102, that provide performance and error information about calls processed by an IBM Db2 z/OS server.

>> Db2 Deadlock

>> Db2 Accounting

zosconnect

Traces created from z/OS Connect record type 123 that provide performance and error information about REST API calls processed by an IBM z/OS Connect server.

>> z/OS Connect

JES2

Traces created from SMF record type 30 where SMF30WID=JES2 that provide performance and error information about z/OS batch jobs.

>> z/OS Work

OMVS

Traces created from SMF record type 30 where SMF30WID=OMVS that provide performance and error information about OMVS processes that were spawned on z/OS systems.

>> z/OS Work

TSO

Traces created from SMF record type 30 where SMF30WID=TSO that provide TSO user activity from z/OS systems.

>> z/OS Work

STC

Traces created from SMF record type 30 where SMF30WID=STC that provides Started task performance and error information from z/OS systems.

>> z/OS Work

Common attributes

Each OpenTelemetry trace created by z/IRIS contains the following attributes/tags.

z/IRIS / OpenTelemetry attributes

IBM SMF source

zos.subsystem.name

SMFxSSI

host.name

SMFxSID