IBM MQ Insight Pack

Posted: September 29, 2015 Modified: March 19, 2019


Overview

The IBM MQ Insight Pack provides the capability to index and search against IBM MQ logs files in IBM Operations Analytics – Log Analysis to enable faster problem identification in MQ-related problems.

Operations Analytics - Log Analysis IBM MQ Logs Dasboard.
IBM MQ Operations Analytics – Log Analysis Dasboard

The IBM MQ Insight Pack supports logs from the following:

  • IBM MQ 9.0.0.3 and 9.0.0.4
  • IBM MQ 8.0
  • MQ Series 7.5
  • MQ Series 7.1
  • MQ Series 7.0.1

The IBM MQ Insight Pack supports searching and indexing of the following

AMQERR logs generated per Queue Manager
UNIX: At /var/mqm/qmgrs//errors
Windows: At c:\Program Files\IBM\WebSphere MQ\qmgrs\\errors

AMQERR.log that is common for all queue managers.
UNIX: At /var/mqm/errors
Windows: At c:\Program Files\IBM\WebSphere MQ\qmgrs\errors

The error log files, named AMQERR01.LOG, AMQERR02.LOG, and AMQERR03.LOG, contain information that is logged by queue managers that can be used for problem debugging.

MQ FFST files generated by Queue Manager
UNIX: At /var/mqm/errors
Windows: At c:\ProgramData\IBM\MQ\errors

The MQ FFST files are named AMQnnnnn.mm.FDC where nnnn is the ID of the process reporting the
error, and mm is the sequence number.

IBM MQ Insight Pack Dashboard

You can use the IBM MQ Insight Pack dashboard example app to visualize data from MQ logs. Use the IBM MQ Insight Pack dashboard to find MQ-related problems in the shortest time, and drill down into the problem to identify the root cause.

The IBM MQ Insight Pack app contains the following charts:

  • Which are top MsgIDs? Plots a pie chart of MsgIDs from the selected log records.
  • Which MsgID occurred the most and when? Plots a bar graph that shows how MsgIDs are distributed over a selected time frame.
  • Which Qmgr logged these MsgIDs? Plots a bubble chart that shows which Qmgr logged most of the MsgIDs.
  • Which MQ program logged these MsgIDs? Plots a bar graph that shows which MQ program logged the MsgIDs.

Additional information

The following artifacts are created when the IBM MQ Insight Pack is installed:

Splitter file set: WMQAMQERRSplitter, WMQFDCSplitter

Annotator file set: WMQAMQERRAnnoator, WMQFDCAnnoator

Source type: WMQ_AMQERR, WMQ_FDC

Collection:  WMQAMQERR_C1, WMQFDC_C1

 

Training Information

Review the following video for information on using and setting up the Insight Pack.

Download

Released: 19 March 2019
Version: 1.0.3.0
Cost: No Charge
Support: Supported
Provider: IBM

Resources

Product Information
Product Documentation
Documentation
Support
Forum

Requirements

  • IBM Operations Analytics – Log Analysis v1.3.0.0 and later
  • IBM MQ 9.0.0.3 and 9.0.0.4
  • IBM MQ 8.0
  • MQ Series 7.5
  • MQ Series 7.1
  • MQ Series 7.0.1

Support

This package is subject to the terms and conditions displayed upon download.
Download license L-JROZ-72S5LA

To report a problem with deploying this entry, entitled customers may contact the country specific IBM support channel, reference the IBM Worldwide Directory. Also use the “Support” link to access the support site for IBM Operations Analytics – Log Analysis information.