Configurazione del monitoraggio di " IBM MQ " nei cluster " Kubernetes "

Modifica online

Configurare il sensore IBM MQ in base all'implementazione dell'agente Instana e del gestore delle code nel proprio ambiente.

Scenari di configurazione basati sull'implementazione

Modifica online

La tabella seguente illustra le configurazioni relative ai diversi scenari di implementazione del gestore delle code degli agenti:

Implementazione del gestore delle code degli agenti Metodo di monitoraggio Configurazione
Entrambi nello stesso cluster di Kubernetes Monitoraggio locale con modalità di associazione client Configurare i parametri di connessione nel file configuration.yaml dell'agente (host e port non è obbligatorio)
In diversi ambienti ( VM, Docker o Kubernetes ) Monitoraggio remoto con modalità di associazione client Configurare i parametri di connessione, inclusi host e port, nel file configuration.yaml dell'agente.

Configurazione del monitoraggio locale con la modalità di associazione client

Modifica online

Quando l'agente host di Instana e il gestore delle code ( IBM MQ ) vengono eseguiti nello stesso cluster di Kubernetes, è supportata solo la modalità di associazione client, poiché l'agente host e il gestore delle code non possono essere eseguiti nello stesso pod.

Per abilitare il monitoraggio, configurare i parametri di connessione di IBM MQ nel file di configurazione dell'agente come segue.

Nota: non impostare l'host e la porta, poiché vengono rilevati automaticamente. La loro configurazione potrebbe causare l'esecuzione di query duplicate su tutte le istanze del gestore delle code nel cluster Kubernetes.
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

Configurazione del supporto per l' TLS

Modifica online

Se l'opzione " TLS " è abilitata per le istanze del gestore delle code monitorate in un cluster Kubernetes, è necessario configurare l'opzione " TLS " nel file di configurazione dell'agente host Instana presente nello stesso cluster.

Per configurare il supporto per l' TLS, procedere come segue:

  1. Crea un segreto utilizzando il file keystore dell'utente nello spazio dei nomi dell'agente Instana :

    kubectl create secret generic keystore-secret-name --from-file=./<jks-file-name>.jks -n instana-agent
    Nota: Sostituisci <jks-file-name> con il file jks utente che utilizzi. Per il file del certificato è supportato solo il formato JKS ( Java KeyStore ).

  2. Montare il segreto come volume nel pod dell'agente Instana specificando il volume e i collegamenti del volume nel file CustomResource dell'agente o nel file values.yamlHelm del chart come segue:

    agent:
  pod:
    volumeMounts:
    - mountPath: /opt/instana/agent/etc/jks-file-name.jks
      name: mq-key-jks-name
      subPath: jks-file-name.jks
    volumes:
    - name: mq-key-jks-name
      secret:
        secretName: keystore-secret-name
    Nota: per ulteriori informazioni sull'integrazione dei segreti nel pod dell'agente di Instana, consultare la documentazione relativa al grafico dell'agente Instana all'indirizzo Helm.

  3. Configurare il file keystore nella com.instana.plugin.ibmmq sezione del file configuration.yaml dell'agente, sia nel file di configurazione CustomResource che nel file values.yaml di configurazione Helm :

    com.instana.plugin.ibmmq:
  enabled: true
  ...
  keystore: /opt/instana/agent/etc/jks-file-name.jks
  keystorePassword: <optional-keystore-password>
  ...
    Nota: non impostare l'host e la porta nel file di configurazione dell'agente, ma concedere l'autorizzazione a connettersi al gestore delle code nel cluster Kubernetes. Questi indicatori vengono visualizzati anche nell'interfaccia utente di Instana.

Configurazione del monitoraggio remoto con la modalità di associazione client

Modifica online

Nel monitoraggio remoto, il sensore IBM MQ utilizza la modalità di associazione client per recuperare e visualizzare i dati da IBM MQ. Per abilitare il monitoraggio remoto, configurare i parametri di connessione dell' IBM MQ e nel file di configurazione dell'agente. I passaggi di configurazione sono gli stessi descritti nella sezione " Monitoraggio locale con modalità di associazione client ". Tuttavia, è necessario configurare l'host e la porta, poiché il sensore IBM MQ non è in grado di rilevarli durante il monitoraggio remoto. Questi dati vengono visualizzati anche nell'interfaccia utente di Instana.