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
- Ensure that you complete steps 1-3 at Installing and configuring the Unified Agent to deploy the Unified Agent.
- Configure the authorization to log in IBM Cloud
Private Cluster.
- Enter the IBM Cloud
Private cluster
user name, the default is admin.
- Enter the IBM Cloud
Private cluster
password.
- Configure IBM MQ Services for monitoring.
The following config items can be repeated:
- 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 *.
- Enter the Service Namespace. It is the namespace where the services are
deployed.
- 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
- 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:
- Run the following command to get the secret:
kubectl get secret
- 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="
},
- Run the following command to get the password and
username:
echo password | base64 -d
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
:
- Enter the IBM MQ container by
kubectl
exec -it podname /bin/sh -n namespace
.
- Execute
dspmq
to get the queue manager name.
- Run
runmqsc queue manager name.
- Execute
ALERT QMGR MONQ(MEDIUM)
.
- End from
mqsc
and exit the container.