Aller au contenu principal

IBM MQ MQI

Contenu du Pack​

Modèles​

Le connecteur de supervision Centreon IBM MQ MQI apporte 1 modèle d'hôte :

  • App-Ibmmq-Mqi-custom

Il apporte les Modèles de Service suivants :

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

Métriques & statuts collectés​

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

Prérequis​

Afin de pouvoir exploiter ce Pack, vous devez installer le client IBM MQ pour Linux. Une procédure est disponible ici: https://www.ibm.com/docs/en/ibm-mq/8.0?topic=server-installing-mq-linux.

Installation​

  1. Installer le Plugin Centreon sur tous les collecteurs Centreon devant superviser des resources IBM MQ MQI:
yum install centreon-plugin-Applications-Ibmmq-Mqi
  1. Sur l'interface Web de Centreon, installer le connecteur de supervision IBM MQ MQI depuis la page Configuration > Packs de plugins.

Configuration​

Hôte​

  • Ajoutez un Hôte à Centreon depuis la page Configuration > Hôtes

  • Complétez les champs Nom,Alias & IP Address / DNS correspondant à votre serveur IBM MQ MQI.

  • Appliquez le Modèle d'Hôte App-Ibmmq-Mqi-custom

  • Une fois le modèle appliqué, renseignez les macros correspondantes. Attention, certaines macros sont obligatoires ("mandatory").

MandatoryNameDescription
IBMMQMQIEXTRAOPTIONSNom de l'utilisateur à utiliser pour lancer les commandes (Par défaut: '--runas=centreon')
IBMMQMQIPORTPort d'écoute de l'instance IBM MQ (Par défaut: '1414')
EXTRAOPTIONSOption supplémentaire à ajouter à toutes les commandes de contrôles (ex: l'option --verbose)

Comment puis-je tester le Plugin et que signifient les options des commandes ?​

Une fois le Plugin installé, vous pouvez tester celui-ci directement en ligne de commande depuis votre collecteur Centreon en vous connectant avec l'utilisateur centreon-engine:

/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

La commande devrait retourner un message de sortie similaire à :

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

Dans cet exemple, une alarme de type WARNING est déclenchée car le nombre de message dans la queue est supérieur au seuil de 200 configuré (--warning-messages-depth='200').

Une alarme CRITICAL serait déclenchée si un des messages datait de plus d'une heure/3600 secondes (--critical-message-oldest='3600').

La liste de toutes les options complémentaires et leur signification peut être affichée en ajoutant le paramètre --help à la commande:

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

Tous les modes disponibles peuvent être affichés en ajoutant le paramètre --list-mode à la commande:

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

Diagnostic des erreurs communes​

Rendez-vous sur la documentation dédiée pour le diagnostic des erreurs communes des Plugins Centreon.