Skip to main content

IBM MQ MQI

Pack Assets​

Templates​

The Centreon Monitoring Connector IBM MQ MQI brings 1 host template:

  • App-Ibmmq-Mqi-custom

It brings the following Service Templates:

Service AliasService TemplateDefault
ChannelsApp-Ibmmq-Channels-MqiX
Queue-ManagerApp-Ibmmq-Queue-Manager-MqiX
QueuesApp-Ibmmq-Queues-MqiX

Collected metrics & status​

Metric NameUnit
statusstring
channel.traffic.in.bitspersecondb/s
channel.traffic.out.bitspersecondb/s

Prerequisites​

To take advantage of this Monitoring Pack, you must deploy the Linux MQ client library on the Poller expected to monitor IBM MQ servers. Please refer to the official IBM documentation:

Setup​

  1. Install the Centreon package on every Centreon poller expected to monitor IBM MQ MQI resources:
yum install centreon-plugin-Applications-Ibmmq-Mqi
  1. On the Centreon Web interface, install the IBM MQ MQI Centreon Monitoring Connector on the Configuration > Monitoring Connector Manager page.

Configuration​

Host​

  • Log into Centreon and add a new Host through Configuration > Hosts
  • Fill the Name, Alias & IP Address / DNS fields according to your IBM MQ MQI server settings
  • Select the App-Ibmmq-Mqi-custom template to apply to the Host
  • Once the template is applied, fill in the corresponding macros. Some macros are mandatory.
MandatoryNameDescription
IBMMQMQIEXTRAOPTIONSSpecify a username which will run the command (Default: '--runas=centreon')
IBMMQMQIPORTIBM MQ Listening port (Default: '1414')
EXTRAOPTIONSAny extra option you may want to add to every command_line (eg. a --verbose flag))

How to check in the CLI that the configuration is OK and what are the main options for?​

Once the plugin is installed, log into your Centreon Poller CLI using the centreon-engine user account and test the Plugin by running the following command:

/usr/lib/centreon/plugins//centreon_ibmmq_mqi.pl \
    --plugin=apps::mq::ibmmq::mqi::plugin \
    --mode=queues \
    --hostname='10.0.0.1' \
    --channel='' \
    --port='1414' \
    --runas=centreon \
    --filter-name='^(?!(SYSTEM|PERL.COMMAND))' \
    --warning-connections-input='' \
    --critical-connections-input='' \
    --warning-messages-depth='200' \
    --critical-messages-depth='' \
    --warning-message-oldest='' \
    --critical-message-oldest='3600' \
    --verbose \
    --use-new-perfdata

The expected command output is shown below:

WARNING: current input connections: 9000 | 'queue.connections.input.count'=9000;;;0; 'queue.messages.depth.count'=20;200;;0; 'queue.message.oldest.seconds'=150;;3600;;

This command triggers a WARNING because the size of the message queue is greater than 200 which is the warning threshold (--warning-messages-depth='200').

It would trigger a CRITICAL alarm if a message was in a queue for more than one hour / 3600 seconds (--critical-message-oldest='3600').

All available options for a given mode can be displayed by adding the --help parameter to the command:

/usr/lib/centreon/plugins//centreon_ibmmq_mqi.pl \
    --plugin=apps::mq::ibmmq::mqi::plugin \
    --mode=queues \
    --help

All available options for a given mode can be displayed by adding the --list-mode parameter to the command:

/usr/lib/centreon/plugins//centreon_ibmmq_mqi.pl \
    --plugin=apps::mq::ibmmq::mqi::plugin \
    --list-mode

Troubleshooting​

Please find all the troubleshooting documentation for the Centreon Plugins in the dedicated page