Configuring Queue manager tracing for end-to-end monitoring

Queue manager tracing integration enables monitoring of message queue operations, including message put or get times, queue depths, and message flow patterns. This task focuses on configuring OpenTelemetry tracing on an already deployed Queue manager.

• Ensure you have a Queue manager instance deployed

• Create a service account token for authentication. For detailed instructions, see Creating a service account for authentication

This method configures a Queue manager to send traces directly to the end-to-end monitoring collector.

1. Create a ConfigMap for the end-to-end monitoring CA certificate. This example uses the OpenShift CA:

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: my-ca-cert
     namespace: your-namespace
   data:
     ca.crt: |
       -----BEGIN CERTIFICATE-----
        <!--Your Certificate Content Here-->
       -----END CERTIFICATE-----

2. Configure the queue manager with the following settings under spec.queueManager:

   spec:
     queueManager:
       availability:
         type: SingleInstance
       env:
         - name: LOG_LEVEL
           value: debug
         - name: SPAN_FORMAT
           value: otel
         - name: MONITOR_LEVEL
           value: normal
         - name: IBMMQ_RFH2_HEADERS_TO_EXPOSE
           value: tId,cmp,messaging.ibmmq.qmgr.host
         - name: OTLP_EXPORTER_GRPC_ENDPOINT
           value: <e2em-collector-endpoint>
         - name: OTEL_RESOURCE_ATTRIBUTES
           value: tId=cloudpak,cmp=IBM MQ
         - name: OTEL_EXPORTER_OTLP_HEADERS
           value: tId=cloudpak,cmp=IBM MQ,messaging.ibmmq.qmgr.host=<name of the qm>
             authorization=Bearer service-account-token;
         - name: OTLP_EXPORTER_SSL_CACERT_PATH
           value: /var/run/secrets/e2em/service-ca.crt
       files:
         - configMap:
             defaultMountPath: /var/run/secrets/e2em
             items:
               - item: service-ca.crt
             name: e2em-ca
     telemetry:
       tracing:
         instana:
           agentHost: e2em-collector.monitoring.svc
           enabled: true

3. When you insert messages into a queue created under the configured queue manager, traces display in end-to-end monitoring.

Queue manager transaction traces display in end-to-end monitoring for monitoring and analysis. You can view message put/get operations, queue depths, and message flow patterns in the end-to-end monitoring Platform UI.

• Validate that traces are displaying in the end-to-end monitoring Platform UI

• Configure additional queue managers to send traces

• Set up alerts for Queue manager message failures or queue depth thresholds