Created
Updated
Summary
z/IRIS creates spans (traces) that complies with OpenTelemetry's OTLP specification. Below is a list of all attributes created and used by z/IRIS for mainframe-related spans, as well as the IBM SMF record that z/IRIS uses to populate the attribute values.
z/IRIS generated standard and custom attributes for mainframe traces
Attribute context
| Attribute Prefix | Mainframe system context |
|---|---|
| zos.** | IBM z/OS operating system wide identifiers. For example, zos.system.name identifies the z/OS LPAR where this request was processed and can be found in all mainframe related spans to identify any request processed by the same zos.system.name. |
| zos.connect.** | IBM's z/OS Connect. |
| 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.system.name | smf123_server_system |
| zos.connect.server.token | smf123_server_stoken |
| zos.connect.server.version | smf123_server_version |
Span 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 | 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 |