Tracciamento di IBM MQ su cluster Red Hat OpenShift

Abilitazione del tracciamento dell' IBM MQ

È possibile abilitare il tracciamento dell' IBM MQ e in uno dei seguenti modi:

Opzione 1: Operatore IBM MQ

Installare IBM MQ Operator 2.2.0 e versioni successive per il tracciamento nativo. Per ottenere il supporto nativo, utilizzare un'immagine container del gestore di code IBM MQ e 9.3.1.0-r2 o versioni successive.

Per abilitare il tracciamento dell' IBM MQ per i gestori di code distribuiti utilizzando IBM MQ Operator 2.2.0 o versioni successive su un cluster IBM Cloud Pak for Integration o un cluster Red Hat OpenShift Container Platform, consultare la guida IBM MQ. IBM MQ Il tracciamento è supportato su Linux su x86_64, ppc64le e s390x Kubernetes nodi.

Nota: per abilitare il tracciamento dell' IBM MQ utilizzando l'operatore IBM MQ su un cluster Red Hat OpenShift Container Platform, è necessario utilizzare una licenza IBM Cloud Pak for Integration con l'operatore IBM MQ.

Opzione 2: Webhook Instana AutoTrace (obsoleto)

Importante: Instana Il supporto dei webhook Autotrace per IBM MQ è stato deprecato. A partire dal 31 maggio 2027, Instana interromperà ufficialmente il supporto e dichiarerà la fine del ciclo di vita (EOL) di questa funzionalità. Questa funzione è sostituita dall 'operatore ` IBM MQ `.

In alternativa, è possibile utilizzare il webhook Instana AutoTrace per abilitare il tracciamento Instana IBM MQ per IBM MQ su un cluster IBM Cloud Pak for Integration. Instana AutoTrace webhook supporta solo le versioni dell'immagine del contenitore del gestore di code IBM MQ precedenti a 9.3.3.0 e Linux/amd64 Kubernetes nodes.

Per ulteriori informazioni su come abilitare il tracciamento per i container IBM MQ in esecuzione su un cluster IBM Cloud Pak for Integration, vedere Abilitazione della strumentazione webhook per IBM MQ e ACE.

Configurazione del tracciamento dell' IBM MQ

Per modificare la configurazione di IBM MQ Tracing per un gestore di code in esecuzione su un cluster Red Hat OpenShift, aggiungere nuove variabili di ambiente al pod del gestore di code.

Il nome della variabile di ambiente deve corrispondere al nome dell'elemento di configurazione elencato nella sezione Configurazione del tracciamento di IBM MQ per IBM MQ locale. Per aggiungere una variabile di ambiente per un pod del gestore di code, completare i seguenti passaggi:

  1. Accedi alla console web del cluster Red Hat OpenShift.
  2. Dal menu di navigazione, fare clic su Operatori > Operatori installati. Vengono visualizzati tutti gli operatori installati nel progetto specificato.
  3. Selezionare l'operatore " IBM MQ ". Viene visualizzata la finestra Operatore dell' IBM MQ.
  4. Go alla scheda Gestione code. Viene visualizzata la finestra Dettagli del gestore delle code.
  5. Selezionare il gestore della coda per il quale si desidera modificare la configurazione di tracciamento.
  6. Go alla YAML scheda.
  7. Aggiungi la variabile d'ambiente nella sezione spec > template > pod > containers > env. Ad esempio, utilizzare il seguente frammento di codice per modificare il livello di log di un tracciam IBM MQ e in debug:
    template:
     pod:
       containers:
         - env:
             - name: LOG_LEVEL
               value: debug
  8. Salvare il file aggiornato del gestore della coda YAML.

Aggiornamento del tracciamento dell' IBM MQ

Per aggiornare il tracciamento di IBM MQ su un cluster Red Hat OpenShift, completare una delle seguenti operazioni:

  • Se il tracciamento dell' IBM MQ è abilitato utilizzando l'operatore IBM MQ 2.2.0 o versioni successive, aggiornare il gestore di code IBM MQ.
  • Se il tracciamento dell' IBM MQ è abilitato utilizzando il webhook Instana AutoTrace, distribuire nuovamente il webhook Instana AutoTrace e riavviare i pod del gestore delle code.

Disabilitazione del tracciamento dell' IBM MQ

Per disabilitare il tracciamento dell' IBM MQ su un cluster di Red Hat OpenShift, completare una delle seguenti operazioni:

  • Se il tracciamento dell' IBM MQ è abilitato utilizzando la versione dell'operatore IBM MQ 2.2.0 o successive, impostare il Enable Instana tracing toggle su false nell'interfaccia utente della piattaforma IBM Cloud Pak for Integration o nella console web Red Hat OpenShift. Consulta la guida " IBM MQ " (Sviluppo di app per iOS).

  • Se il tracciamento dell' IBM MQ è abilitato utilizzando il webhook Instana AutoTrace, completare uno dei seguenti passaggi: