Configuration de la surveillance d' IBM MQ s dans des machines virtuelles ou physiques

Modifier en ligne

Configurez le capteur IBM MQ en fonction du déploiement de l'agent Instana et du gestionnaire de file d'attente dans votre environnement.

Scénarios de configuration basés sur le déploiement

Modifier en ligne

Lorsque l'agent hôte Instana et IBM MQ s'exécutent sur la même machine, les modes de connexion suivants sont pris en charge : mode de liaison locale et mode de liaison client. Lorsque l'agent hôte Instana et IBM MQ s'exécutent sur des machines différentes, seul le mode de liaison client est pris en charge.

Le tableau suivant présente les configurations pour différents scénarios de déploiement d'agents et de gestionnaires de files d'attente :

Déploiement du gestionnaire de file d'attente d'agents Type d'utilisateur Méthode de surveillance Exigence de configuration
Les deux dans la même machine virtuelle ou physique Utilisateur privilégié Surveillance locale avec mode de liaison local Aucune configuration requise (surveillance automatique)
Les deux dans la même machine virtuelle ou physique Utilisateur non privilégié Surveillance locale avec mode de liaison client Configuration manuelle requise dans configuration.yaml
Les deux sur la même machine d' Linux Utilisateur sans privilèges et non root Surveillance locale avec mode de liaison client Configuration manuelle requise dans configuration.yaml
Dans différents environnements ( VM, Docker, ou Kubernetes ) Surveillance à distance avec mode de liaison client Configuration manuelle requise dans configuration.yaml

Configuration de la surveillance locale avec le mode de liaison locale

Modifier en ligne

Si le compte utilisateur de l'agent Instana dispose de privilèges, le capteur IBM MQ utilise le mode de liaison local pour récupérer les données à partir de IBM MQ.

En utilisant le mode de liaison local, le capteur d' IBM MQ s peut détecter automatiquement les instances du gestionnaire de files d' IBM MQ s et afficher toutes les données. Vous n'avez pas besoin de configurer le fichier de configuration de l'agent Instana.

Configuration de la surveillance locale avec le mode de liaison client

Modifier en ligne

Si le compte utilisateur de l'agent d' Instana n 'est pas privilégié, le capteur d' IBM MQ doit utiliser le mode de liaison client pour récupérer les données à partir de IBM MQ. Vous devez configurer les paramètres de connexion IBM MQ dans le fichier de configuration de l'agent.

Pour configurer les paramètres de connexion d' IBM MQ, procédez comme suit :

  1. Configurez la section ibmmq plug-in dans le fichier de configuration de l'agent comme suit :

    com.instana.plugin.ibmmq:
  enabled: true
  poll_rate: 60
  queueManagers:
    QMGR03:    # Your Queue Manager name here. If there are queue managers with the same name, it is required to append '-<instance>' in the queue manager name to distinguish them. You can select any string for <instance>.
      channel: '<INSERT_CHANNEL_HERE>' # Remote administration channel

  2. Configurez d'autres autorités en fonction des configurations de votre IBM MQ. Si la sécurité de IBM MQ est activée, configurez l'utilisateur et le mot de passe. Si TLS de IBM MQ est activé, fournissez les informations relatives au keystore dans le fichier de configuration de l'agent. Voir l'exemple de configuration suivant :

    Remarque : pour le fichier de certificat du keystore, seul le jks fichier est pris en charge.
    com.instana.plugin.ibmmq:
  enabled: true
  poll_rate: 60
  queueManagers:
    QMGR03:    # Your Queue Manager name here. If there are queue managers with the same name, it is required to append '-<instance>' in the queue manager name to distinguish them. You can select any string for <instance>.
      channel: '<INSERT_CHANNEL_HERE>' # Remote administration channel
      username: '<INSERT_USERNAME_HERE>' # User ID to connect to MQ (optional)
      password: '<INSERT_PASSWORD_HERE>' # User password to connect to MQ (optional)
      keystore: '<INSERT_KEYSTORE_PATH_HERE>' # Keystore path for TLS connection (required only when TLS is enabled for remote monitoring. Optional)
      keystorePassword: '<INSERT_KEYSTORE_PASSWORD_HERE>' # Keystore password for TLS connection (required only when TLS is enabled for remote monitoring. Optional)
      cipherSuite: '<INSERT_CIPHER_SUITE_HERE>' # TLS cipher suite for TLS connection (required only when TLS is enabled for remote monitoring. Optional)

    En utilisant le mode de liaison client, le capteur IBM MQ peut détecter automatiquement certaines configurations, telles que l'hôte et le port, dans la surveillance locale et afficher les métriques dans l'interface utilisateur Instana.

  3. Pour les utilisateurs sans privilèges et non root sur Linux : configurez le enableStatisticsQueueMetrics paramètre dans le fichier de configuration de l'agent afin de permettre au capteur « IBM MQ » de récupérer les données statistiques relatives aux files d'attente. Voir la section « Configuration des statistiques de file d'attente ».

    Pour plus d'informations sur l'exécution de l'agent « Instana » en tant qu'utilisateur non root sur Linux, consultez la section « Exécution de l'agent en tant qu'utilisateur non root ».

Configuration des statistiques de file d'attente

Pour configurer les statistiques de file d'attente, procédez comme suit :

  1. Activer les statistiques des files d'attente : pour activer la collecte des indicateurs de performance (tels que les débits de messages) pour toutes les files d'attente, mqm l'utilisateur doit suivre les étapes suivantes :

    1. Activez les statistiques au niveau du gestionnaire de files d'attente en exécutant la commande suivante. Cette commande fait office d'interrupteur principal pour toutes les files d'attente dont STATQ l'attribut est défini sur QMGR (la valeur par défaut).

      ALTER QMGR STATQ(ON)

    2. b. Définissez l'intervalle de collecte (obligatoire) en exécutant la commande suivante. La STATINT valeur doit correspondre à l'agent poll_rate pour obtenir des statistiques précises en temps réel. Si STATINT est supérieur à, poll_rateles statistiques ne sont pas en temps réel.

      ALTER QMGR STATINT(60)
      Important : mqm l'utilisateur doit accorder toutes les autorisations requises. {: important)
  2. Configurer l'agent : ajoutez le enableStatisticsQueueMetrics paramètre dans le fichier de configuration.yaml l'agent (*instanaAgentDir*/etc/instana/configuration.yaml):
    com.instana.plugin.ibmmq:
  enabled: true
  poll_rate: 60
  enableStatisticsQueueMetrics: false # Default is false. If false, uses RESET PCF command (requires mqm privileges). If true (Linux only), uses STATS mode from statistics queue (STATINT must match POLL_RATE for accuracy).

    Une fois ces configurations mises en place, l'agent d' Instana s collecte avec succès les métriques statistiques des files d'attente en récupérant les messages de la file d'attente des statistiques, sans nécessiter d'accès root ni d'accès mqm au groupe.

    Lorsque enableStatisticsQueueMetrics est défini sur true, le capteur « IBM MQ » active le mode STATS afin de collecter des statistiques sur le débit de la file d'attente. Assurez-vous que l'intervalle STATINT de calcul des statistiques est défini de manière à correspondre à la poll_rate valeur. Lorsqu'il est réglé sur false (par défaut), le capteur utilise la méthode RESET PCF de commande pour collecter des statistiques, ce qui nécessite mqm des privilèges.

Configuration de la surveillance à distance avec le mode de liaison client

Modifier en ligne

Dans le cadre de la surveillance à distance, le capteur IBM MQ utilise le mode de liaison client pour récupérer et afficher les données provenant de IBM MQ. Vous devez configurer les paramètres de connexion IBM MQ dans le fichier de configuration de l'agent. Les étapes de configuration sont identiques à celles décrites dans la section Surveillance locale avec le mode de liaison client.

En utilisant le mode de liaison client dans la surveillance à distance, vous devez configurer l'hôte et le port, car le capteur d' IBM MQ s ne peut pas les détecter dans la surveillance à distance. Les métriques sont également affichées dans l'interface utilisateur d' Instana.