IBM MQ

Prerequisites

  • IBM MQ 8.0+ for Windows/Linux/AIX
  • An Environment ActiveGate (version 1.155+) that isn't used for synthetic or mainframe monitoring
  • 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 to reach out to Dynatrace One.

ActiveGate 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 files (linux.custom.remote.python.ibmmq.zip and windows.custom.remote.python.ibmmq.zip). Don't rename the files.

  2. Depending on the OS that your ActiveGate runs on, unzip either linux.custom.remote.python.ibmmq.zip or windows.custom.remote.python.ibmmq.zip to the plugin_deployment directory of your ActiveGate host.

  3. If the resulting directory structure isn't either .\plugin_deployment\linux.custom.remote.python.ibmmq\ or .\plugin_deployment\windows.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 the zipped file.

  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, please review this 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

  8. Troubleshoot 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 %