Skip to end of metadata
Go to start of metadata


 Click here to expand...

Content



Created  

Updated 


Summary

IBM's z/OS Connect provides RESTful API(REST API) access to z/OS applications and data. Additionally, z/OS  applications can access any RESTful endpoint within z/OS as well as externally hosted RESTful APIs. 

This article describes the metrics and schemas created from IBM's z/OS Connect SMF records type 123 version 1 and 2. z/IRIS metrics should be stored in a data sink (e.g. InfluxDB ) that is connected to visualization and analysis software (e.g. Grafana).




Measurement:
zosconnect_basic

This measurement is sourced from SMF 123.1 version 1 records


Name

Metrics type

SMF Source

timestampfieldTIME_ZC_ENTRY
systemtagSERVER_SYSTEM

sysplex

tag

SERVER_SYSPLEX

subsystem_id

field

SERVER_JOBID

subsystem

tag

SERVER_JOBNAME

elapsed_time

field

TIME_ZC_EXIT - TIME_ZC_ENTRY

req_target_uri

field

REQ_TARGET_URI

req_size

field

REQ_PAYLOAD_LEN

api_service_name

field

API_SERVICE_NAME

req_method

tag

REQ_METHOD

resp_size

field

RESP_PAYLOAD_LEN

user_name

field

USER_NAME

req_id

field

REQ_ID

user_name_mapped

field

USER_NAME_MAPPED


Measurement: zosconnect_advanced

This measurement is sourced from SMF 123.1 version 2 records


NAME

METRIC TYPE

SOURCE

timestamp

field

SMF123S1_TIME_ZC_ENTRY

system

tag

SMF123_SERVER_SYSTEM

sysplex

tag

SMF123_SERVER_SYSPLEX

subsystem_id

field

SMF123_SERVER_JOBID

subsystem

tag

SMF123_SERVER_JOBNAME

version

tag

SMF123_SERVER_VERSION

elapsed_time

field

SMF123S1_TIME_ZC_EXIT - SMF123S1_TIME_ZC_ENTRY

req_target_uri

field

SMF123S1_REQ_TARGET_URI

req_size

field

SMF123S1_REQ_PAYLOAD_LEN

req_method

tag

SMF123S1_REQ_METHOD

resp_size

field

SMF123S1_RESP_PAYLOAD_LEN

user_name

field

SMF123S1_USER_NAME

req_id

field

SMF123S1_REQ_ID

user_name_mapped

field

SMF123S1_USER_NAME_MAPPED

req_type

tag

SMF123S1_REQ_TYPE

http_resp_code

tag

SMF123S1_HTTP_RESP_CODE

req_timed_out

tag

SMF123S1_REQ_TIMED_OUT

client_ip_addr

field

SMF123S1_CLIENT_IP_ADDR

api_name

field

SMF123S1_API_NAME

api_version

field

SMF123S1_API_VERSION

service_name

field

SMF123S1_SERVICE_NAME

service_version

field

SMF123S1_SERVICE_VERSION

sor_elapsed_time

field

SMF123S1_TIME_SOR_RECV - SMF123S1_TIME_SOR_SENT

zcon_elapsed_time

field

elapsed_time - sor_elapsed_time

latency

field

SMF123S1_TIME_SOR_RECV - SMF123S1_TIME_ZC_ENTRY

service_provider

tag

SMF123S1_SP_NAME

sor_reference

tag

SMF123S1_SOR_REFERENCE

sor_identifier

tag

SMF123S1_SOR_IDENTIFIER

sor_resource

field

SMF123S1_SOR_RESOURCE



Visualization in Grafana

zosconnect dashboard from z/IRIS z/OS Connect Metrics 

click to enlarge image