IBM MQ

Prerequisites

  • IBM MQ 8.0+ for Windows/Linux/AIX
  • An Environment ActiveGate (version 1.155+) that has the ActiveGate plugin module installed and isn't used for synthetic or mainframe monitoring
    • 1 environment ActiveGate can typically support 30-50 IBM MQ queue managers
  • IBM MQ client installed on Environment ActiveGate
  • A server-connection channel on the queue manager for communication with the plugin

Interested in monitoring IBM MQ with Dynatrace?

The quickest way to get started is by contacting a Dynatrace ONE product specialist. Just click the chat button in the upper-right corner of the Dynatrace menu bar.

Environment ActiveGate installation

ActiveGate plugin module installation

IBM MQ Client Installation

See the current version here. Alternatively, you can search the IBM website for the MQ client version download that matches your environment.

  • For Windows, install the MQ client as specified.
  • Note that for Linux-based ActiveGates, you only need to install MQSeriesRuntime.rpm and MQSeriesClient.rpm.
    1. Add the MQ client lib64 libraries to LD PATH by creating a new file in /etc/ld.so.conf.d/.
    2. Enter a line that points to the lib64 libraries. The default is /opt/mqm/lib64.
    3. Save and restart the LD configuration with sudo ldconfig.

Extension installation

  1. Obtain the install file (custom.remote.python.ibmmq.zip). Don't rename the file.

  2. Unzip custom.remote.python.ibmmq.zip to the plugin_deployment directory of your ActiveGate host.

  3. If the resulting directory structure isn't .\plugin_deployment\custom.remote.python.ibmmq\, please make the neccessary changes.

  4. Restart the Dynatrace Remote Plugin Module service.

    • On Linux, restart the service using the following commands with admin rights:
      • systemctl restart remotepluginmodule.service
    • On Windows, run these two commands in a Command Prompt launched as Admin:
      • sc stop "Dynatrace Remote Plugin Module"
      • sc start "Dynatrace Remote Plugin Module"
  5. Return to the Dynatrace web UI. Click Settings, the Add new technology monitoring button, and finally the Add ActiveGate plugin button.

  6. Click the Upload plugin button and upload custom.remote.python.ibmmq.zip.

  7. Enter the following information to connect to your IBM MQ Queue Manager:

    • Endpoint name: Type a meaningful endpoint name.
    • User: The username for connecting to the IBM MQ instance.
    • Password: The user password.
    • Comma-separated Queue Manager hosts:ports: IP(port) or hostname(port)
    • Server-connection channel: Name of communication channel
    • Single queue manager: My_qmgr_name
    • Channels: Leave empty for none, abc* (to include), or -abc* (to exclude)
    • Comma seperated queues: Queue1, Que* (to include); -UnwantedQu* (to exclude)
    • Exclude System queues
    • Run Rest Stats on Queues: retrieves Deq/Enq
    • Listener channels: Leave empty for none, * for all
    • Path to key repository: If using SSL, key repository location must be provided and the below conditions must be satisfied:
      • Two key repositories must exist - one on the ActiveGate where the MQ Client resides, and the other on the IBM MQ server.
      • Each repository must have the other’s public key certificate.
      • The certificate label of the MQ Server must be ibmwebspheremq<queue_manager>(all lowercase).
      • The certificate label of the MQ Client on the ActiveGate must be ibmwebspheremq<username> (all lowercase).
      • The username is the account through which the Remote Plugin process runs.
      • For additional information on configuring SSL in IBM MQ, see the configuration guide
    • Cipher spec
    • Name of group: If queue manager is part of a cluster, type the name here to group in the GUI.
    • Output debug: Only enable if requested by Dynatrace.

    IBM MQ

Installation troubleshooting

  • Error (libmqic_r.so: cannot open shared object file: No such file or directory)
    • See the IBM MQ Client Installation section for details. This error is likely caused by the IBM MQ Client not being installed on the ActiveGate host, or the path hasn't been updated to point to the libmqic_r.so.
  • Update failed - Authorization error Connection failed. Unauthorized user <username>. FAILED: MQRC_NOT_AUTHORIZED
    • Either the provided user wasn't added to the IBM MQ environment or the password is incorrect. Note that the password isn't applied automatically during updates; you need to manually add the password again.
  • Troubleshooting ActiveGate plugin installation issues

Metrics

Queue Manager

  • Availability %
  • Connections
  • Active channels

Channel (split by channel)

  • Channel status
  • Channel messages
  • Bytes sent
  • Bytes received
  • Buffers sent
  • Buffers received
  • Last message
  • Number of conversations

Queues (split by queue)

  • number of messages in queue
  • percent of queue depth
  • Enqueue
  • Dequeue
  • Open in handles
  • Open out handles
  • Oldest message
  • Uncommitted messages
  • Time in queue short period
  • Time in queue long period
  • Last get
  • Last put
  • Inhibit get
  • Inhibit put

Listener (split by listener)

  • Availability %