Red Hat OpenShift クラスタにおける IBM MQ のトレース

コンテナ化された環境( Red Hat OpenShift など)において、 IBM MQ トレースの有効化、設定、更新、無効化が可能です。

IBM MQ トレースの有効化

IBM MQ トレースは、以下のいずれかの方法で有効にできます:

オプション1: IBM MQ 演算子

ネイティブトレースのため、 IBM MQ オペレータ( 2.2.0 以降)をインストールしてください。 ネイティブサポートを利用するには、 IBM MQ queue manager container image 9.3.1.0-r2 またはそれ以降のバージョンを使用してください。

IBM Cloud Pak for Integration クラスタまたは Red Hat OpenShift Container Platform クラスタ上で、 IBM MQ オペレータ 2.2.0 以降を使用してデプロイされたキューマネージャに対して IBM MQ トレースを有効にするには、 IBM MQ ガイドを参照してください。 IBM MQ トレースは、 Linux、 x86_64、 ppc64le、および s390xKubernetes ノードでサポートされています。

注記: Red Hat OpenShift Container Platform クラスターで IBM MQ オペレーターを使用して IBM MQ トレースを有効にするには、 IBM Cloud Pak for Integration ライセンスと IBM MQ オペレーターが必要です。

オプション 2: Instana AutoTrace Webhook (非推奨)

重要:Instana における IBM MQ への Autotrace Webhook サポートは非推奨となりました。 2027年5月31日をもちまして、 Instana のサポートは正式に終了し、本機能はサポート終了(EOL)となります。 この機能は、 IBM MQ 演算子に置き換えられました。

あるいは、 Instana AutoTrace のWebhookを使用して、 IBM Cloud Pak for Integration クラスタ上の IBM MQ に対して Instana IBM MQ のトレースを有効化できます。 Instana AutoTrace Webhookは、 IBM MQ キューマネージャーコンテナーイメージバージョン 9.3.3.0 以前と、 Linux/amd64 Kubernetes ノード。

IBM Cloud Pak for Integration クラスター上で実行される IBM MQ コンテナのトレースを有効にする方法の詳細については、「 IBM MQ およびACE向けのWebhook計測機能の有効化」 を参照してください。

IBM MQ トレースの構成

Red Hat OpenShift クラスタ上で実行されているキューマネージャの IBM MQ トレース設定を変更するには、キューマネージャポッドに新しい環境変数を追加します。

環境変数名は、 オンプレミス版 IBM MQ 向け IBM MQ トレース設定セクションに記載されている設定項目名と一致する必要があります。 キューマネージャポッド用の環境変数を追加するには、次の手順を完了してください:

  1. Red Hat OpenShift クラスター Web コンソールにログインします。
  2. ナビゲーションメニューから、 「演算子 」>「 インストール済みの演算子」 をクリックします。 指定されたプロジェクトにインストールされているすべてのオペレーターが表示されます。
  3. IBM MQ 演算子を選択してください。 IBM MQ オペレータウィンドウが表示されます。
  4. Go キューマネージャータブへ キュー管理者の詳細ウィンドウが表示されます。
  5. トレース構成を変更するキュー・マネージャを選択してください。
  6. 「YAML」タブに移動します。
  7. spec > template > pod > containers > env セクションに環境変数を追加してください。 たとえば、 IBM MQ トレースのログレベルをデバッグに変更するには、次のスニペットを使用します:
    template:
     pod:
       containers:
         - env:
             - name: LOG_LEVEL
               value: debug
  8. 更新されたキューマネージャの YAML ファイルを保存します。

IBM MQ トレースのアップグレード

Red Hat OpenShift クラスターで IBM MQ トレースをアップグレードするには、次のいずれかの手順を完了してください:

  • IBM MQ オペレーターの 2.2.0 以降を使用して IBM MQ トレースが有効化されている場合、 IBM MQ キューマネージャをアップグレードしてください。
  • IBM MQ トレースが Instana AutoTrace ウェブフックによって有効化されている場合、 Instana AutoTrace ウェブフックを再度デプロイし、キューマネージャポッドを再起動してください。

IBM MQ トレースの無効化

Red Hat OpenShift クラスターで IBM MQ トレースを無効にするには、次のいずれかの手順を完了します:

  • IBM MQ オペレータ版 2.2.0 以降を使用して IBM MQ トレースが有効化されている場合、 IBM Cloud Pak for Integration プラットフォームUIまたは Red Hat OpenShift ウェブコンソールでトグルを「 Enable Instana tracing オン」 false に設定してください。 IBM MQ ガイドを参照してください。

  • Instana AutoTrace ウェブフックを使用して IBM MQ トレースが有効化されている場合、以下のいずれかの手順を完了してください: