Created: 25 May 2021 | Updated: 05 Oct 2023
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).
Name
IBM SMF source
duration
zos.connect.response.exit_time - zos.connect.response.entry_time
service.name
zosconnect
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
Name IBM SMF source
error.message
An error description will be added here if 400 ≤ http.status_code ≤ 502
net.host.name
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“
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
Name
IBM SMF source
zos.db2.location.name
zos.db2.location.host
zos.db2.location.port
smf123s1_sor_identifier
db.system
db2
Name
IBM SMF source
zos.cis.applid
smf123s1_sor_identifier
Name
IBM SMF source
zos.ims.datastore
smf123s1_sor_identifier
Name
IBM SMF source
zos.wola.register
smf123s1_sor_identifier
Tag
IBM SMF source
zos.mq.queue.manager
smf123s1_sor_identifier