Présentation

Ce check surveille IBM MQ, versions 5 à 9.0.

Configuration

Installation

Le check IBM MQ est inclus avec le package de l’Agent Datadog.

Pour utiliser le check IBM MQ, vous devez :

1. Vous assurer que le client IBM MQ 9.1+ est installé (sauf si un serveur IBM MQ est déjà installé)
2. Mettre à jour vos LD_LIBRARY_PATH et C_INCLUDE_PATH afin d’inclure l’emplacement des bibliothèques

Par exemple :

export LD_LIBRARY_PATH=/opt/mqm/lib64:/opt/mqm/lib:$LD_LIBRARY_PATH
export C_INCLUDE_PATH=/opt/mqm/inc

Remarque : l’Agent v6+ utilise upstart, systemd ou launchd pour orchestrer le service datadog-agent. Il est possible que des variables d’environnement doivent être ajoutées aux fichiers de configuration du service, dont les emplacements par défaut sont :

• Upstart (Linux) : /etc/init/datadog-agent.conf
• Systemd (Linux) : /lib/systemd/system/datadog-agent.service
• Launchd (MacOS) : ~/Library/LaunchAgents/com.datadoghq.agent.plist
  • Cela ne fonctionne que si le SIP macOS est désactivé (peut ne pas être conseillé en fonction de votre politique de sécurité). Cette situation est due à la suppression de la variable d’environnement LD_LIBRARY_PATH par SIP.

Exemple de configuration pour systemd :

[Unit]
Description="Datadog Agent"
After=network.target
Wants=datadog-agent-trace.service datadog-agent-process.service
StartLimitIntervalSec=10
StartLimitBurst=5

[Service]
Type=simple
PIDFile=/opt/datadog-agent/run/agent.pid
Environment="LD_LIBRARY_PATH=/opt/mqm/lib64:/opt/mqm/lib:$LD_LIBRARY_PATH"
User=dd-agent
Restart=on-failure
ExecStart=/opt/datadog-agent/bin/agent/agent run -p /opt/datadog-agent/run/agent.pid

[Install]
WantedBy=multi-user.target

Exemple de configuration pour upstart :

description "Datadog Agent"

start on started networking
stop on runlevel [!2345]

respawn
respawn limit 10 5
normal exit 0

console log
env DD_LOG_TO_CONSOLE=false
env LD_LIBRARY_PATH=/opt/mqm/lib64:/opt/mqm/lib:$LD_LIBRARY_PATH

setuid dd-agent

script
  exec /opt/datadog-agent/bin/agent/agent start -p /opt/datadog-agent/run/agent.pid
end script

post-stop script
  rm -f /opt/datadog-agent/run/agent.pid
end script

Exemple de configuration pour launchd :

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
    <dict>
        <key>KeepAlive</key>
        <dict>
            <key>SuccessfulExit</key>
            <false/>
        </dict>
        <key>Label</key>
        <string>com.datadoghq.agent</string>
        <key>EnvironmentVariables</key>
        <dict>
            <key>DD_LOG_TO_CONSOLE</key>
            <string>false</string>
            <key>LD_LIBRARY_PATH</key>
            <string>/opt/mqm/lib64:/opt/mqm/lib</string>
        </dict>
        <key>ProgramArguments</key>
        <array>
            <string>/opt/datadog-agent/bin/agent/agent</string>
            <string>run</string>
        </array>
        <key>StandardOutPath</key>
        <string>/var/log/datadog/launchd.log</string>
        <key>StandardErrorPath</key>
        <string>/var/log/datadog/launchd.log</string>
        <key>ExitTimeOut</key>
        <integer>10</integer>
    </dict>
</plist>

À chaque mise à jour de l’Agent, ces fichiers sont effacés et doivent à nouveau être modifiés.

Si vous utilisez Linux, une fois le client MQ installé, vérifiez que l’éditeur de liens du runtime parvient à trouver les bibliothèques. Par exemple, avec ldconfig :

Précisez l’emplacement de la bibliothèque dans un fichier de configuration ld.

sudo sh -c "echo /opt/mqm/lib64 > /etc/ld.so.conf.d/mqm64.conf"
sudo sh -c "echo /opt/mqm/lib > /etc/ld.so.conf.d/mqm.conf"

Mettez à jour les liens :

sudo ldconfig

Autorisations et authentification

Il existe plusieurs façons de configurer les autorisations dans IBM MQ. Selon votre configuration, créez un utilisateur datadog dans MQ avec un accès en lecture seule.

Remarque : le « Queue Monitoring » doit être activé et défini au minimum sur « Medium ». Ce réglage peut s’effectuer via l’IU MQ ou avec une commande mqsc :

> /opt/mqm/bin/runmqsc
5724-H72 (C) Copyright IBM Corp. 1994, 2018.
Starting MQSC for queue manager datadog.


ALTER QMGR MONQ(MEDIUM) MONCHL(MEDIUM)
     1 : ALTER QMGR MONQ(MEDIUM) MONCHL(MEDIUM)
AMQ8005I: IBM MQ queue manager changed.

       :
One MQSC command read.
No commands have a syntax error.
All valid MQSC commands were processed.

Configuration

Validation

Lancez la sous-commande status de l’Agent et cherchez ibm_mq dans la section Checks.

Données collectées

Métriques

Checks de service

mysql.can_connect :
Renvoie CRITICAL si l’Agent ne parvient pas à se connecter au serveur MQ pour une raison quelconque. Si ce n’est pas le cas, renvoie OK.

ibm_mq.queue_manager :
Renvoie CRITICAL si l’Agent ne parvient pas à recueillir des statistiques provenant du gestionnaire de files d’attente. Si ce n’est pas le cas, renvoie OK.

ibm_mq.queue :
Renvoie CRITICAL si l’Agent ne parvient pas à recueillir des statistiques sur les files d’attente. Si ce n’est pas le cas, renvoie OK.

ibm_mq.channel :br> Renvoie CRITICAL si l’Agent ne parvient pas à recueillir des statistiques sur les canaux. Si ce n’est pas le cas, renvoie OK.

ibm_mq.channel.status :
Renvoie CRITICAL si le statut est INACTIVE, STOPPED ou STOPPING. Renvoie OK si le statut est RUNNING et renvoie WARNING si le statut peut passer à running.

Événements

IBM MQ n’inclut aucun événement.

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles :

• Surveiller les métriques et les logs d’IBM MQ avec Datadog