Skip to main content
Skip table of contents

z/OS Connect Spans

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.

Refer to Tag Semantics for more information about the naming conventions and mainframe context.


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

Refer to Common resource tags for attributes available in all z/IRIS spans

Name

IBM SMF source

duration

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

service.name

zosconnect

constant value

service.version

zos.connect.api.version

only set if zos.connect.api.version is present

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

net.host.name

Extract from the host HTTP request header using z/OS Connect Audit interceptors: z/OS Connect - How to extract values for net.host.name and net.host.port

SMF123S2_REQ_HDR1 , SMF123S2_REQ_HDR2 , SMF123S2_REQ_HDR3 or SMF123S2_REQ_HDR4

If no host information is contained in the above fields, the default value of localhost is applied.

net.host.port

Extracted from the host HTTP request header using z/OS Connect Audit interceptors: z/OS Connect - How to extract values for net.host.name and net.host.port

SMF123S2_REQ_HDR1 , SMF123S2_REQ_HDR2 , SMF123S2_REQ_HDR3 or SMF123S2_REQ_HDR4

If no host information is contained in the above fields, the default value of 80 is applied.

http.client_ip

smf123s1_client_ip_addr

http.method

smf123s1_req_method

http.scheme

http | https

Currently defaults to http due to limitations in z/OS Connect trace data.

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

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

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.