Red Hat OpenShift クラスタにおける IBM MQ のトレース
コンテナ化された環境( Red Hat OpenShift など)において、 IBM MQ トレースの有効化、設定、更新、無効化が可能です。
前提条件
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 ノードでサポートされています。
オプション 2: Instana AutoTrace Webhook (非推奨)
あるいは、 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 トレース設定セクションに記載されている設定項目名と一致する必要があります。 キューマネージャポッド用の環境変数を追加するには、次の手順を完了してください:
- Red Hat OpenShift クラスター Web コンソールにログインします。
- ナビゲーションメニューから、 をクリックします。 指定されたプロジェクトにインストールされているすべてのオペレーターが表示されます。
- IBM MQ 演算子を選択してください。 IBM MQ オペレータウィンドウが表示されます。
- Go キューマネージャータブへ キュー管理者の詳細ウィンドウが表示されます。
- トレース構成を変更するキュー・マネージャを選択してください。
- 「YAML」タブに移動します。
- セクションに環境変数を追加してください。 たとえば、 IBM MQ トレースのログレベルをデバッグに変更するには、次のスニペットを使用します:
template: pod: containers: - env: - name: LOG_LEVEL value: debug - 更新されたキューマネージャの 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 トレースが有効化されている場合、以下のいずれかの手順を完了してください:
- 「 Instana 」 AutoTrace Webhook をアンインストールし、キューマネージャーのポッドを再起動してください。
- Instana のウェブフックをアンインストールし、 AutoTrace を
autotrace.ibmmq.enabledに設定してから、falseInstana のウェブフックを再度デプロイしてください。 AutoTrace 変更を有効にするには、キューマネージャポッドを再起動してください。 「 AutoTrace 」ウェブフックのインストール」 を参照してください。