Created: | Updated:

Below is a table describing the Datadog trace semantics that are utilized when z/IRIS streams IBM MQ for z/OS spans using the Datadog API.

To find out more about integrating z/IRIS with Datadog using the Datadog API, refer to Traces integration using Datadog API.

>> MQ for z/OS Observability

MQ for z/OS tags via Datadog’s trace API

The table below shows how z/IRIS configures Datadog-specific tags for MQ for z/OS traces streamed using Datadog’s trace API.

Datadog Tag

z/IRIS Telemetry tag

Description

service

service.name

Identifies IBM MQ as the mainframe service.

The service name is always ibmmq for MQ for z/OS spans.

operation_name

messaging.destination

or

messaging.ibmmq.qmgr

This value is used to name the Datadog span and identifies the queue manager or MQ object (queue or topic).

resource_name

messaging.destination

or

messaging.ibmmq.qmgr

This value is used to name the Datadog span and identifies the queue manager or MQ object (queue or topic).

host

host.name

Identifies the host system.

Values set in the host tag have no effect in the Datadog back-end. Users should integrate z/IRIS traces using OpenTelemetry to be able to list mainframe LPARs by host.name .

>> Complete list of MQ span tags

service:ibmmq

MQ spans are logically grouped by the service name "ibmmq". The spans describe units of work and processes executed on MQ systems running on z/OS (i.e. mainframe).

Click to enlarge image

Example of filtering traces using service in Datadog

operation_name

For MQ spans, the operation_name identifies the operation that was executed by a request

Query example

Description

operation_name:mover

Will provide all spans ibmmq spans where the messages were moved to topics or queues by processes. Typically, initiation, remote and alias queues result in a mover operation

operation_name:cics_attach*

Will provide spans where the cics subsystem performed an operation

Click to enlarge image

Trace explorer view of operation_name for IBM MQ spans

resource_name

For MQ spans, the resource name identifies the queue manager or the topics/queues utilized by MQ processes and requests.

For example:

Query example

Description

resource_name:QMG1

Will provide all spans that were processed by a queue manager named QMG1

resource_name:QMG1.QUEUE.NAME

Will provide all traces where messaging destination name is equal to QMG1.QUEUE.NAME

Click to enlarge image

IBM MQ related objects are listed as resources within the Service Dashboard in Datadog