OpenTelemetry traces and attributes
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 |
---|---|
| 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. |
| 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. |
| Traces created from SMF record type 30 where SMF30WID=JES2 that provide performance and error information about z/OS batch jobs. |
| 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. |
| Traces created from SMF record type 30 where SMF30WID=TSO that provide TSO user activity from z/OS systems. |
| Traces created from SMF record type 30 where SMF30WID=STC that provides Started task performance and error information from z/OS systems. |
Common attributes
Each OpenTelemetry trace created by z/IRIS contains the following attributes/tags.
z/IRIS / OpenTelemetry attributes | IBM SMF source | Constant value |
---|---|---|
zos.subsystem.name | SMFxSSI | |
host.name | SMFxSID | |
host.arch | “z/Architecture” | |
os.type | “z/OS” |