Rastreando IBM MQ em clusters Red Hat OpenShift

Editar online

Você pode habilitar, configurar, atualizar e desabilitar o rastreamento do IBM MQ em ambientes em contêineres, como o Red Hat OpenShift.

Ativando o rastreamento do IBM MQ

Editar online

Você pode habilitar o rastreamento do IBM MQ por qualquer um dos seguintes métodos:

Opção 1: Operador IBM MQ

Editar online

Instale o IBM MQ Operator 2.2.0 e versões posteriores para rastreamento nativo. Para obter suporte nativo, use uma imagem de contêiner do gerenciador de filas IBM MQ 9.3.1.0-r2 ou versões posteriores.

Para habilitar o rastreamento de eventos do gerenciador de filas ( IBM MQ ) para gerenciadores de filas implantados usando o IBM MQ Operator 2.2.0 ou versões posteriores em um cluster IBM Cloud Pak for Integration ou um cluster Red Hat OpenShift Container Platform, consulte o guia IBM MQ. IBM MQ O rastreamento é compatível com os nós Linux, x86_64, ppc64le e s390xKubernetes.

Observação: para habilitar o rastreamento IBM MQ usando o operador IBM MQ em um cluster Red Hat OpenShift Container Platform, você deve usar uma licença IBM Cloud Pak for Integration com o operador IBM MQ.

Opção 2: Webhook Instana AutoTrace (obsoleto)

Editar online
Importante: Instana O suporte ao webhook do Autotrace para IBM MQ foi descontinuado. A partir de 31 de maio de 2027, o Instana encerra oficialmente o suporte e declara o fim da vida útil (EOL) desse recurso. Esse recurso é substituído pelo operad IBM MQ.

Como alternativa, você pode usar Instana AutoTrace webhook para habilitar Instana IBM MQ rastreamento para IBM MQ em um cluster IBM Cloud Pak for Integration. O webhook Instana AutoTrace suporta apenas versões de imagem de contêiner do gerenciador de filas IBM MQ anteriores à 9.3.3.0 e Linux/amd64 Nós Kubernetes.

Para obter mais informações sobre como habilitar o rastreamento para contêineres do IBM MQ executados em um cluster do IBM Cloud Pak for Integration, consulte Habilitando a instrumentação de webhook para IBM MQ e ACE.

Configurando o IBM MQ Tracing

Editar online

Para alterar a configuração do rastreamento de IBM MQ para um gerenciador de fila em execução em um cluster Red Hat OpenShift, adicione novas variáveis de ambiente ao pod do gerenciador de fila.

O nome da variável de ambiente deve corresponder ao nome do item de configuração listado na seção Configurando o rastreamento do IBM MQ para o IBM MQ local. Para adicionar uma variável de ambiente para um pod do gerenciador de filas, execute as seguintes etapas:

  1. Faça login em seu console da web do Red Hat OpenShift.
  2. No menu de navegação, clique em Operadores > Operadores instalados. Todos os operadores instalados no projeto especificado são exibidos.
  3. Selecione o operador “ IBM MQ ”. A janela Operador do IBM MQ é exibida.
  4. Go para a guia gerenciador de filas. A janela Detalhes do gerenciador de filas é exibida.
  5. Selecione o gerenciador de fila para o qual você deseja alterar a configuração de rastreamento.
  6. Vá para a guia YAML.
  7. Adicione a variável de ambiente na seção spec > template > pod > containers > env. Por exemplo, use o seguinte trecho para alterar o nível de log de um traçag IBM MQ e para depuração:
    template:
 pod:
   containers:
     - env:
         - name: LOG_LEVEL
           value: debug
  8. Salve o arquivo atualizado do gerenciador de fila YAML.

Atualização do rastreamento d IBM MQ

Editar online

Para atualizar o rastreamento do IBM MQ em um cluster do Red Hat OpenShift, execute uma das seguintes etapas:

  • Se o rastreamento de e IBM MQ s estiver habilitado usando o operador IBM MQ 2.2.0 ou versões posteriores, atualize o gerenciador de filas IBM MQ.
  • Se o rastreamento IBM MQ estiver habilitado usando o webhook Instana AutoTrace, implante novamente o webhook Instana AutoTrace e reinicie os pods do gerenciador de filas.

Desativando o rastreamento do IBM MQ

Editar online

Para desativar o rastreamento do IBM MQ em um cluster do Red Hat OpenShift, execute uma das seguintes etapas:

  • Se o rastreamento de IBM MQ estiver habilitado usando o operador IBM MQ versão 2.2.0 ou posterior, defina a opção Enable Instana tracing toggle para false na interface do usuário da plataforma IBM Cloud Pak for Integration ou no console da web Red Hat OpenShift. Consulte o guia IBM MQ.

  • Se o rastreamento IBM MQ estiver habilitado usando o webhook Instana AutoTrace, execute uma das seguintes etapas: