Created:  | Updated: 


z/IRIS creates spans (traces) that comply with OpenTelemetry's OTLP specification. Below is a list of all z/OS Connect related attributes created and used by z/IRIS for mainframe-related spans, as well as the IBM SMF record values that z/IRIS uses to populate the attribute 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.

Attributes list

z/IRIS / OpenTelemetry attributes

IBM SMF source

Resource attributes

zos.job.id

smf123_server_jobid

zos.job.name

smf123_server_jobname

zos.sysplex.name

smf123_server_sysplex

zos.connect.server.config_dir

smf123_server_config_dir

zos.connect.server.token

smf123_server_stoken

zos.connect.server.version

smf123_server_version

OpenTelemetry resource attributes

host.name

smf123_server_system

Custom attributes

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.connect.service_provider.name

smf123s1_sp_name

zos.connect.sor.identifier

smf123s1_sor_identifier

zos.connect.sor.reference

smf123s1_sor_reference

zos.connect.sor.request.received_time

smf123s1_time_sor_recv

zos.connect.sor.request.sent_time

smf123s1_time_sor_sent

zos.connect.sor.resource

smf123s1_sor_resource

zos.user.name

smf123s1_user_name_mapped

OpenTelemetry attributes

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.client_ip

smf123s1_client_ip_addr