Configuring IBM MQ monitoring in Unified Agent

When you deploy the Unified Agent, you can select to install IBM MQ plug-in to monitor IBM MQ container in IBM® Cloud Private cluster environments. It can monitor the system resource utilization, such as CPU, memory, and storage. It can also monitor how many API calls failed, how many messages put in and get out from the container IBM MQ service and so on.

About this task

To deploy the Unified Agent with IBM MQ container monitoring, do the following steps:

Procedure

  1. Ensure that you complete steps 1-3 at Installing and configuring the Unified Agent to deploy the Unified Agent.
  2. Configure the authorization to log in IBM Cloud Private Cluster.
    1. Enter the IBM Cloud Private cluster user name, the default is admin.
    2. Enter the IBM Cloud Private cluster password.
  3. Configure IBM MQ Services for monitoring. The following config items can be repeated:
    1. Enter the monitored IBM MQ Service Name. It is the service name to monitor, and it can include asterisk(*) for fuzzy matching, for example, * to match all, abc* to match the name that begins with abc. The default is *.
    2. Enter the Service Namespace. It is the namespace where the services are deployed.
    3. Enter the IBM MQ administrative REST user name. It is the user name of IBM MQ administration interface and configured when deploying the IBM MQ container. The default is admin.
      Where to find the user name and password
    4. Enter the IBM MQ administrative REST password. It is the password of IBM MQ administration interface and configured when deploying the IBM MQ container.
      Tip:
      Where to check IBM MQ administrative REST user name and password?
      When deploying IBM MQ container, you must create a Secret in the target namespace. This must contain the admin user password and optionally the app user password to use for messaging. If you do not know the administrative REST user name and password when you deploy the IBM MQ plug-in in Unified Agent, you can do the following steps to check:
      1. Run the following command to get the secret:
        kubectl get secret
      2. Find the IBM MQ container secret, run the following command to open it:
        kubectl edit secret secret_name
        You can see the password and username information, similar to the following example:
        "data": {
            "password": "YWRtaW4=",
            "username": "YWRtaW4="
          },
      3. Run the following command to get the password and username:
        echo password | base64 -d

Results

The IBM MQ plug-in is successfully installed and configured in Unified Agent.

What to do next

If you want to view the oldest message number of IBM MQ plug-in, do the following steps to set the MONQ attribute to MEDIUM for QMGR:
  1. Enter the IBM MQ container by kubectl exec -it podname /bin/sh -n namespace.
  2. Execute dspmq to get the queue manager name.
  3. Run runmqsc queue manager name.
  4. Execute ALERT QMGR MONQ(MEDIUM).
  5. End from mqsc and exit the container.