Instana monitoring: Verifying and debugging

To be able to monitor a queue manager through an IBM® Instana® agent on the Red Hat® OpenShift® Container Platform, you must configure both the agent and the queue manager.

Before you begin

Important: Integration with IBM Instana tracing is supported only on the Red Hat OpenShift Container Platform.

This task assumes that you have configured the queue manager for IBM Instana monitoring.

Procedure

Verifying

To verify that you have been successful in your deployment, view your queue manager in the IBM Instana dashboard.

The queue manager should be visible in the services section of the application page, and also in the Infrastructure view.

Debugging

Note: These debugging steps assume an Openshift deployment of the IBM Instana agent running as a daemonset.

If you cannot see your queue manager in the IBM Instana dashboard, then you might have misconfigured your queue manager. Use the following steps to investigate.

Identify the node on which your active queue manager pod is running.
Run the following command in your queue manager namespace:
```
oc get pods -o wide -n your-queue-manager-namespace
```
To determine which IBM Instana agent pod is running on the same node as your queue manager, run the same command in the instana-agent namespace:
```
oc get pods -o wide -n instana-agent-namespace
```
To help understand any issues from the IBM Instana agent side, get the logs of the IBM Instana agent pod and look for entries relating to 'mq' or to the name of your queue manager.
Run the following command:
```
oc logs instana-agent-pod -c instana-agent -n instana-agent
```
Check the queue manager logs.
If the agent has made an attempt to connect to the queue manager, then the queue manager logs should indicate why the connection was not successful. Run the following command:
```
oc logs your-queue-manager-name -n your-queue-manager-namespace
```

Results

You have completed all four tasks to configure authenticated IBM Instana monitoring with TLS.