Tracciamento di IBM MQ su cluster Red Hat OpenShift
È possibile abilitare, configurare, aggiornare e disabilitare il tracciamento dell' IBM MQ in ambienti containerizzati come Red Hat OpenShift.
Prerequisiti
Verificare la compatibilità dei sistemi operativi supportati per il tracciamento dell' IBM MQ.
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.
Opzione 2: Webhook Instana AutoTrace (obsoleto)
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:
- Accedi alla console web del cluster Red Hat OpenShift.
- Dal menu di navigazione, fare clic su . Vengono visualizzati tutti gli operatori installati nel progetto specificato.
- Selezionare l'operatore " IBM MQ ". Viene visualizzata la finestra Operatore dell' IBM MQ.
- Go alla scheda Gestione code. Viene visualizzata la finestra Dettagli del gestore delle code.
- Selezionare il gestore della coda per il quale si desidera modificare la configurazione di tracciamento.
- Go alla YAML scheda.
- Aggiungi la variabile d'ambiente nella sezione . 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 - 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 tracingtoggle sufalsenell'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:
- Disinstallare il webhook AutoTrace dell' Instana, quindi riavviare i pod del Queue Manager.
- Disinstalla il webhook Instana AutoTrace, imposta
autotrace.ibmmq.enabledsufalse, quindi distribuisci nuovamente il webhook Instana AutoTrace. Affinché le modifiche abbiano effetto, riavviare i pod del gestore della coda. Vedi Installazione del webhook " AutoTrace ".