[AIX, Linux, Windows]

Troubleshooting IBM MQ Telemetry problems

Look for a troubleshooting task to help you solve a problem with running IBM® MQ Telemetry applications.

Telemetry logs, error logs, and configuration files
Enable and find the logs, error logs, and configuration files used by IBM MQ Telemetry.
Enabling JSON formatted logs for MQTT
To enable JSON format error logging, you need to modify the MQTT configuration files mqxrtraceOn.properties and mqxrtraceOff.properties.
Enabling Java heap dump generation to troubleshoot low memory exceptions for MQTT
To enable automatic generation of a Java heap dump when the IBM MQ Telemetry service reports a low memory exception, you need to modify the MQTT Java Virtual Machine (JVM) configuration file java.properties.
Additional diagnostics using the controlMQXRChannel command
Using the controlMQXRChannel command to provide additional diagnostic information about the MQXR service.
Resolving problem: MQTT client does not connect
Resolve the problem of an MQTT client program failing to connect to the telemetry (MQXR) service.
Resolving problem: MQTT client connection dropped
Find out what is causing a client to throw unexpected ConnectionLost exceptions after successfully connecting and running for either a short or long while.
Resolving problem: Lost messages in an MQTT application
Resolve the problem of losing a message. Is the message non-persistent, sent to the wrong place, or never sent? A wrongly coded client program might lose messages.
Resolving problem: Telemetry (MQXR) service does not start
Resolve the problem of the telemetry (MQXR) service failing to start. Check the IBM MQ Telemetry installation and no files are missing, moved, or have the wrong permissions. Check the paths that are used by the telemetry (MQXR) service locate the telemetry (MQXR) service programs.
Resolving problem: JAAS login module not called by the IBM MQ Telemetry service
Find out if your JAAS login module is not being called by the telemetry (MQXR) service, and configure JAAS to correct the problem.

Parent topic: Detailed troubleshooting

Related concepts

IBM MQ Telemetry

Related tasks

Tracing the telemetry (MQXR) service