Components Supporting OpenTelemetry

COBOL Application Server (CAS)

The following COBOL Application Server (CAS) tracer properties are supported:

mfotl.tracer.cas#all 
mfotl.tracer.cas#cics 
mfotl.tracer.cas#comms 
mfotl.tracer.cas#task

CAS OpenTelemetry tracing flags are enabled or disabled using a value of 1 or 0 respectively. If cas#all is set, all CAS tracing flags are enabled by default. Individual flags can be set through their corresponding properties.

For example, to enable all tracing flags except for CICS:

mfotl.tracer.cas#all=1
mfotl.tracer.cas#cics=0

Tracing for specific CAS modules can be disabled by setting the <module name>#all property to 0.

For example, to enable CICS tracing except for tracing from dfhepctc:

mfotl.tracer.cas#cics=1
mfotl.tracer.dfhepctc#all=0
Note: Tracing for specific modules cannot be explicitly enabled. Disabling tracing in some areas will prevent context propagation and lead to fragmented OpenTelemetry traces.
Important: Enabling OpenTelemetry tracing will impact performance and increase shared memory use depending on the workload and configuration used.

COBOL Application Server Resource Attributes

com.microfocus.es.instance.name
com.microfocus.es.pac.name
com.microfocus.es.pac.uuid
Span name Flag Potential attributes Description
<all>

com.microfocus.es.task.number

thread.id

cics_api cics

com.microfocus.es.cics.eibfn

com.microfocus.es.cics.eibresp

com.microfocus.es.cics.eibresp2

com.microfocus.es.cics.eibrcode

com.microfocus.es.cics.eibrsrce

Start and end of processing for a CICS API call.
casgate_make_request comms

com.microfocus.es.hydra.request.command

com.microfocus.es.hydra.request.conv_type

client.address

client.port

network.transport

network.type

network.protocol.name

server.address

server.port

Handling of incoming network requests through casgate.
casgate_send_data comms

client.address

client.port

network.transport

network.type

network.protocol.name

server.address

server.port

Outgoing network data sent through casgate.
handle_request/HTTP comms

http.request.header.content-length

http.request.header.forwarded

http.request.header.host

http.request.header.x-forwarded-for

http.request.header.x-forwarded-host

http.request.header.x-forwarded-proto

http.request.method

http.request.method_original

http.response.status_code

http.route

network.protocol.version

url.path

url.query

user_agent.original

Request handler processing for HTTP requests.

Note: If duplicate request headers are provided, only the last header is recorded.
task_processing task

com.microfocus.es.dca.type

com.microfocus.es.ims.tm.command

com.microfocus.es.program.entry

com.microfocus.es.program.name

com.microfocus.es.transaction.id

com.microfocus.es.terminal.id

com.microfocus.es.terminal.netname

com.microfocus.es.user.group

com.microfocus.es.user.name

CAS task processing for CICS or IMS transactions.

COBOL Application Server Events

Event name Flag Potential attributes Description
es_console_msg

com.microfocus.nls.message.content

com.microfocus.nls.message.id

com.microfocus.nls.message.severity

Enterprise Server console log messages.