Suivi de l' IBM MQ e sur les clusters Red Hat OpenShift

Vous pouvez activer, configurer, mettre à jour et désactiver le traçage d' IBM MQ dans des environnements conteneurisés tels qu' Red Hat OpenShift

Activation du traçage d' IBM MQ

Vous pouvez activer le traçage d' IBM MQ s à l'aide de l'une des méthodes suivantes :

Option 1 : Opérateur IBM MQ

Installez IBM MQ Operator 2.2.0 et versions ultérieures pour le traçage natif. Pour bénéficier d'une prise en charge native, utilisez l'image de conteneur du gestionnaire de file d'attente IBM MQ 9.3.1.0-r2 ou les versions ultérieures.

Pour activer le traçage d' IBM MQ s pour les gestionnaires de file d'attente déployés à l'aide d' IBM MQ Operator 2.2.0 ou versions ultérieures sur un cluster IBM Cloud Pak for Integration ou un cluster Red Hat OpenShift Container Platform, consultez le guide IBM MQ. IBM MQ Le traçage est pris en charge sur Linux sur x86_64, ppc64le et s390x Kubernetes nodes.

Remarque : pour activer le traçage de l' IBM MQ à l'aide de l'opérateur IBM MQ sur un cluster Red Hat OpenShift Container Platform, vous devez utiliser une licence IBM Cloud Pak for Integration avec l'opérateur IBM MQ.

Option 2 : Webhook « Instana AutoTrace » (obsolète)

Important : Instana La prise en charge du webhook Autotrace pour IBM MQ est obsolète. À compter du 31 mai 2027, Instana met officiellement fin au support de cette fonctionnalité et en annonce la fin de vie (EOL). Cette fonctionnalité est remplacée par l'opérateur « IBM MQ ».

Vous pouvez également utiliser le webhook Instana AutoTrace pour activer le traçage Instana IBM MQ pour IBM MQ sur un cluster IBM Cloud Pak for Integration. Le webhook Instana AutoTrace ne prend en charge que les versions d'image de conteneur du gestionnaire de files d'attente IBM MQ antérieures à la 9.3.3.0 et Linux/amd64 Nœuds Kubernetes.

Pour plus d'informations sur l'activation du traçage pour les conteneurs d' IBM MQ s qui s'exécutent sur un cluster d' IBM Cloud Pak for Integration, consultez Activation de l'instrumentation webhook pour IBM MQ et ACE.

Configuration d' IBM MQ Tracing

Pour modifier la configuration du traçage d' IBM MQ s pour un gestionnaire de file d'attente s'exécutant sur un cluster Red Hat OpenShift, ajoutez de nouvelles variables d'environnement au pod du gestionnaire de file d'attente.

Le nom de la variable d'environnement doit correspondre au nom de l'élément de configuration répertorié dans la section Configuration du traçage d' IBM MQ pour IBM MQ sur site. Pour ajouter une variable d'environnement pour un pod de gestionnaire de file d'attente, procédez comme suit :

  1. Connectez-vous à la console Web de votre cluster Red Hat OpenShift.
  2. Dans le menu de navigation, cliquez sur Opérateurs > Opérateurs installés. Tous les opérateurs installés dans le projet spécifié sont affichés.
  3. Sélectionnez l'opérateur d' IBM MQ. La fenêtre Opérateur de l' IBM MQ s s'affiche.
  4. Go à l'onglet Gestionnaire de file d'attente. La fenêtre Détails du gestionnaire de file d'attente s'affiche.
  5. Sélectionnez le gestionnaire de file d'attente pour lequel vous souhaitez modifier la configuration de traçage.
  6. Accédez à l'onglet YAML.
  7. Ajoutez la variable d'environnement dans la section `spec > template > pod > containers > env `. Par exemple, utilisez l'extrait suivant pour modifier le niveau de journalisation du traçage d' IBM MQ s en mode débogage :
    template:
     pod:
       containers:
         - env:
             - name: LOG_LEVEL
               value: debug
  8. Enregistrez le fichier d' YAML s du gestionnaire de file d'attente mis à jour.

Mise à niveau du traçage d' IBM MQ

Pour mettre à niveau le traçage d' IBM MQ s sur un cluster Red Hat OpenShift, effectuez l'une des opérations suivantes :

  • Si le traçage d' IBM MQ s est activé à l'aide de l'opérateur IBM MQ 2.2.0 ou des versions ultérieures, mettez à niveau le gestionnaire de file d'attente IBM MQ.
  • Si le traçage IBM MQ est activé à l'aide du webhook Instana AutoTrace, déployez à nouveau le webhook Instana AutoTrace et redémarrez les pods du gestionnaire de file d'attente.

Désactivation du traçage d' IBM MQ

Pour désactiver le traçage d' IBM MQ sur un cluster Red Hat OpenShift, effectuez l'une des opérations suivantes :

  • Si le traçage d' IBM MQ s est activé à l'aide de la version 2.2.0 ou ultérieure de l'opérateur IBM MQ, définissez le Enable Instana tracing commutateur sur false dans l'interface utilisateur de la plate-forme IBM Cloud Pak for Integration ou dans la console Web Red Hat OpenShift. Consultez le guide IBM MQ.

  • Si le traçage d' IBM MQ s est activé à l'aide du webhook Instana AutoTrace, effectuez l'une des opérations suivantes :