Surveillance d'IBM MQ Appliance avec OpenTelemetry

IBM MQ Appliance est un produit matériel sur lequel est installé le système d'exploitation « IBM MQ », prêt à l'emploi. Instana utilise le collecteur de données OpenTelemetry pour surveiller l'hôte IBM MQ Appliance.

Assurez-vous que le SDK 11 d' Java, ou une version ultérieure, est installé.

Pour vérifier la version du SDK d' Java :

java -version

Pour configurer le collecteur de données OpenTelemetry IBM MQ Appliance, suivez les étapes suivantes :

  1. Téléchargez la dernière version des pilotes OpenTelemetry Data Collector (ODCD) depuis la page des pilotes OpenTelemetry Data Collector.
    Figure 1. S'ouvre dans un nouvel onglet ou une nouvelle fenêtre
    Icône de lien externe
    .
  2. Extraire le paquet vers un emplacement de déploiement.

    tar vxf otel-dc-host-0.2.3.tar
    cd otel-dc-host-0.2.3
    
  3. Dans le dossier extrait, assurez-vous que les fichiers de configuration suivants sont mis à jour en fonction de votre environnement :

    • config/config.yaml
    • config/logging.properties
  4. Mettre à jour le fichier de configuration 'config/config.yaml pour IBM MQ Appliance. Le fichier de configuration par défaut est " config/config.yaml.

  5. Effectuez l'une des étapes suivantes :

    • Copier le fichier 'config/config-mqappliance.yaml dans 'config/config.yaml.

    • Utilisez la variable d'environnement " DC_CONFIG pour spécifier le fichier de configuration, par exemple :

      export DC_CONFIG=config/config-mqappliance.yaml
      

Exemple de fichier de configuration

Un exemple de fichier de configuration inclus dans l'archive pour surveiller les métriques d' IBM MQ Appliance sur Instana, comme le montre l'extrait suivant :

host.system: mq_appliance
instances:
  - appliance.host: testbox1.mqappliance.com
    appliance.user: admin
    appliance.password: xxxxxxxx
    #Data collector properties:
    poll.interval: 10
    callback.interval: 5
    otel.backend.url: http://127.0.0.1:4317
    #otel.backend.using.http: true

Exécutez le collecteur de données à l'aide de la commande suivante, en fonction de votre système actuel :

nohup ./bin/otel-dc-host

Les paramètres suivants sont utilisés dans le fichier de configuration des collecteurs de données de l'hôte.

Paramètre Portée Description Exemples de valeurs
appliance.host mq_appliance Nom d'hôte de IBM MQ Appliance testbox1.mqappliance.com
appliance.user mq_appliance Nom d'utilisateur pour IBM MQ Appliance administrateur
appliance.password mq_appliance Le mot de passe pour IBM MQ Appliance password1

Pour consulter les indicateurs dans l'interface utilisateur d' Instana, cliquez sur « Infrastructure ». IBM MQ Appliance s'affiche sous le nom « OTEL Host ». Sélectionnez IBM MQ Appliance, puis cliquez sur « Ouvrir le tableau de bord ».

Figure 2. OpenTelemetry indicateurs
Entité OpenTelemetry