MQ Tracing - Header Insertion results in Message Queue problems.

Document ID : KB000013123
Last Modified Date : 14/02/2018
Show Technical Document Details
Question:

 

 After configuring the APM MQ Agent to perform MQ tracing, and restarting my application, the message queue begins to behave abnormally. What can be done to fix this?

 

Environment:
Introscope MQ Agent from 9.5x to 10x
Answer:

  This can occur due to insertion of correlation id’s in MQ headers. Applications with strict MQ message validation may reject MQ messages with altered headers.

 

 This can be addressed by disabling MQ header insertion. By default, the MQ header insertion property is enabled in MQPP. It will enable the MQ header insertion for MQRFH2 and JMS headers. It is needed to correlate MQ connector calls with other Java components. If it is disabled, then the correlation between the traces might not happen properly. To disable the MQ header insertion, make the following change in the MQAgent.properties file.

 

mq.headerinsertion.enabled= false

 

mq.headerread.enabled= false

 

After making these changes, the MQ Agent will need to be restarted.

 

 

 

Additional Information: