Created:  | Updated: 

z/IRIS creates traces from SMF type 123 version 2 records. Below is a list of all z/OS Connect related tags created and used by z/IRIS for mainframe-related APM traces, as well as the IBM SMF record values that z/IRIS uses to populate the tag values.

Tag Naming Scheme

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.

zos.connect.**

IBM's z/OS Connect.

host.**

Host tags as defined in OpenTelemetry's semantic conventions for resources.

http.**

HTTP attributes as defined in OpenTelemetry's semantic conventions for traces.

Span Semantics

z/OS Connect span

Child of REST API call

Represents REST API calls that are processed by a z/OS Connect server. In addition to the duration and return code, this span also contains information about the server (Resource Tags) and the request (Span Tags).

Resource Tags

Name

IBM SMF source

duration

zos.connect.response.exit_time - zos.connect.response.entry_time

host.arch

z/Architecture

constant value

host.name

smf123_server_system

os.type

z/OS

constant value

otel.library.name

com.mainstorconcept.ziris.irontap

constant value

service.name

zosconnect

constant value

span.name

zos.connect.service.name

zos.connect.server.config_dir

smf123_server_config_dir

zos.connect.server.token

smf123_server_stoken

zos.connect.server.version

smf123_server_version

zos.job.id

smf123_server_jobid

zos.job.name

smf123_server_jobname

zos.sysplex.name

smf123_server_sysplex

Span Tags

Name

IBM SMF source

error.message

An error description will be added here if 400 ≤ http.status_code ≤ 502

http.client_ip

smf123s1_client_ip_addr

http.method

smf123s1_req_method

http.response_content_length

smf123s1_resp_payload_len

http.request_content_length

smf123s1_req_payload_len

http.status_code

smf123s1_http_resp_code

http.target

smf123s1_req_target_uri

zos.connect.api.name

smf123s1_api_name

zos.connect.api.version

smf123s1_api_version

zos.connect.request.id

smf123s1_req_id

zos.connect.request.timed_out

smf123s1_req_timed_out

zos.connect.request.user_name

smf123s1_user_name

zos.connect.service.name

smf123s1_service_name

zos.connect.service.version

smf123s1_service_version

zos.user.name

smf123s1_user_name

System-Of-Record (SOR) span

Represents REST API calls processed by the SOR backend system configured for the z/OS Connect server. It contains metadata about the SOR.

SOR service name mapping

service.name

Condition

db2

When smf123s1_sor_identifier starts with “Db2“ and zos.connect.service_provider.name equals “restclient-1.0”

rest

When zos.connect.service_provider.name equals “restclient-1.0”

wola

When zos.connect.service_provider.name equals "wola-1.0"

cics

When zos.connect.service_provider.name equals “cics-1.0“

ims

When zos.connect.service_provider.name equals “ims-1.0“

mq

When zos.connect.service_provider.name equals with “mq-1.0“

Span Tags

Name

IBM SMF source

duration

zos.connect.sor.response.received_time - zos.connect.sor.request.sent_time

service.name

db2 | rest | wola | cics | ims | mq

See SOR service.name mapping

span.name

zos.connect.sor.reference

zos.connect.service_provider.name

smf123s1_sp_name

zos.connect.sor.identifier

smf123s1_sor_identifier

zos.connect.sor.reference

smf123s1_sor_reference

zos.connect.sor.resource

smf123s1_sor_resource


Db2 SOR Span Tags

Name

IBM SMF source

zos.db2.location.name

zos.db2.location.host

zos.db2.location.port

smf123s1_sor_identifier

db.system

db2

constant value

CICS SOR Span Tags

Name

IBM SMF source

zos.cis.applid

smf123s1_sor_identifier

IMS SOR Span Tags

Name

IBM SMF source

zos.ims.datastore

smf123s1_sor_identifier

WOLA SOR Span Tags

Name

IBM SMF source

zos.wola.register

smf123s1_sor_identifier

MQ SOR Span Tags

Tag

IBM SMF source

zos.mq.queue.manager

smf123s1_sor_identifier