Configurando o monitoramento d IBM MQ em clusters d Kubernetes

Editar online

Configure o sensor IBM MQ com base na implantação do agente Instana e do gerenciador de filas em seu ambiente.

Cenários de configuração baseados em implantação

Editar online

A tabela a seguir exibe as configurações para diferentes cenários de implantação do gerenciador de fila de agentes:

Implantação do gerenciador de fila de agentes Método de monitoramento Configuração
Ambos no mesmo cluster Kubernetes Monitoramento local com modo de vinculação do cliente Configure os parâmetros de conexão no arquivo configuration.yaml do agente (não host obrigatório port )
Em diferentes ambientes ( VM, Docker ou Kubernetes ) Monitoramento remoto com modo de vinculação do cliente Configure os parâmetros de conexão, incluindo host e port, no arquivo configuration.yaml do agente.

Configurando o monitoramento local com o modo de vinculação do cliente

Editar online

Quando o agente host Instana e o gerenciador de filas IBM MQ são executados no mesmo cluster Kubernetes, apenas o modo de vinculação do cliente é compatível, pois o agente host e o gerenciador de filas não podem ser executados no mesmo pod.

Para habilitar o monitoramento, configure os parâmetros de conexão IBM MQ no arquivo de configuração do agente da seguinte maneira.

Observação: Não defina o host e a porta, pois eles são detectados automaticamente. Definir essas opções pode causar consultas duplicadas de todas as instâncias do gerenciador de filas no 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

Configurando o suporte a TLS

Editar online

Se o recurso " TLS " estiver habilitado para instâncias monitoradas do gerenciador de filas em um cluster " Kubernetes ", você deverá configurar " TLS " no arquivo de configuração do agente host " Instana " no mesmo cluster.

Para configurar o suporte ao TLS, execute as seguintes etapas:

  1. Crie um segredo com o arquivo keystore do usuário no namespace do agente Instana :

    kubectl create secret generic keystore-secret-name --from-file=./<jks-file-name>.jks -n instana-agent
    Observação: Substitua <jks-file-name> pelo arquivo jks de usuário que você utiliza. Para o arquivo de certificado, apenas o formato JKS ( Java KeyStore ) é compatível.

  2. Monte o segredo como um volume no pod do agente Instana, especificando o volume e as montagens de volume no agente CustomResource ou no arquivo values.yaml de gráfico Helm da seguinte maneira:

    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
    Observação: para obter mais informações sobre como montar segredos no pod do agente Instana, consulte a documentação do gráfico Helm do agente Instana.

  3. Configure o arquivo keystore na com.instana.plugin.ibmmq seção do arquivo configuration.yaml do agente, seja no arquivo CustomResource ou no arquivo Helmvalues.yaml chart:

    com.instana.plugin.ibmmq:
  enabled: true
  ...
  keystore: /opt/instana/agent/etc/jks-file-name.jks
  keystorePassword: <optional-keystore-password>
  ...
    Observação: não defina o host e a porta no arquivo de configuração do agente, mas conceda autoridade para se conectar ao gerenciador de filas no cluster Kubernetes. As métricas também são exibidas na interface do usuário do Instana.

Configurando o monitoramento remoto com o modo de vinculação do cliente

Editar online

No monitoramento remoto, o sensor IBM MQ usa o modo de vinculação do cliente para recuperar e exibir dados de IBM MQ. Para habilitar o monitoramento remoto, configure os parâmetros de conexão IBM MQ no arquivo de configuração do agente. As etapas de configuração são as mesmas descritas na seção Monitoramento local com modo de vinculação do cliente. No entanto, você precisa configurar o host e a porta, pois o sensor IBM MQ não consegue detectá-los no monitoramento remoto. As métricas também são exibidas na interface do usuário do Instana.