Created:  | Updated: 

z/IRIS creates traces from SMF type 123 version 2 records. Below is a list of all z/OS Connect related attributes/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 attribute/tag 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.

zos.connect.**

IBM's z/OS Connect.

host.**

Host attributes as defined in OpenTelemetry's resource semantic conventions.

http.**

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

Trace 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 duration and return code, this span also contains information about the server (resource attributes) and the request (tag attributes).

Attributes list

Resource attributes

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

Tag attributes

Name

IBM SMF source

error.message

An error description will be added here if the http.status_code >= 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 includes 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 = “restclient-1.0”

rest

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

wola

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

cics

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

ims

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

mq

When zos.connect.service_provider.name equals with “ims-10.0“

Tag attributes

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 tags

Name

IBM SMF source

zos.db2.location.name

smf123s1_sor_identifier

Substring of this value

zos.db2.location.host

smf123s1_sor_identifier

Substring of this value

zos.db2.location.port

smf123s1_sor_identifier

Substring of this value

db.system

db2

constant value

CICS SOR tags

Name

IBM SMF source

zos.cis.applid

smf123s1_sor_identifier

IMS SOR tags

Name

IBM SMF source

zos.ims.datastore

smf123s1_sor_identifier

WOLA SOR tags

Name

IBM SMF source

zos.wola.register

smf123s1_sor_identifier

MQ SOR tag

Tag

IBM SMF source

zos.mq.queue.manager

smf123s1_sor_identifier