IBM MQ トレース

オンライン編集

IBM MQ ユーザー出口を使用して IBM MQ メッセージをトレースできます。 IBM の MQ ユーザー・エクジットを使用することで、メッセージのフローに関する貴重な知見を得て、潜在的な問題を特定できます。

IBM MQ ユーザー・エグジットのトレース機能は、 IBM MQ オンプレミスでデプロイされた環境と、 IBM MQ Red Hat OpenShift クラスター上でコンテナ内で実行される環境をサポートします。

IBM MQ トレースの構成

オンライン編集

IBM MQ を効果的にトレースするには、次の手順を完了してください：

  1. IBM を有効化 MQ トレース:トレースを開始するには IBMMQ キューマネージャ設定でトレースユーザー退出を有効化してください。
  2. IBM の設定 MQ トレース: IBMMQ トレースはデフォルトで設定されています。 ただし、 IBM MQ のトレース設定を変更することは可能です。
  3. IBM のアップグレード MQ トレース: 新バージョンがリリースされたら、トレースユーザーエグジットに更新を適用してください。 トレースが不要になった場合は、システムリソースを節約するために無効にしてください。

環境固有の指示については、以下を参照してください：

トレースデータの報告

オンライン編集

IBM MQ のトレース設定後、トレースデータは以下の通り報告されます:

  • IBM MQ の場合、トレースデータは同じホスト上の Instana ホストエージェントに報告されます。
  • Red Hat OpenShift クラスタ上のコンテナで実行されている IBM MQ の場合、トレースデータは、キューマネージャポッドと同じノードにデプロイされている Instana ホストエージェントにレポートされます。

IBM の MQ トレース設定により、トレースデータをリモートホストエージェントに報告することもできます。 設定パラメータを参照してください。

トレースデータの相関分析

オンライン編集

IBM によって収集されるデータのトレース MQ ユーザー・エグジットおよびその他のトレーサーのトレースは、 IBM MQ メッセージにトレース・コンテキスト・ヘッダー（トレース相関情報）が設定されている場合に相関させることができます。

IBM MQ トレースは次のトレースコンテキストヘッダーをサポートします：

  • Instanaトレースコンテキストヘッダー（X_INSTANA_T, X_INSTANA_S, および X_INSTANA_L）
  • W3C トレースコンテキストヘッダー (traceparent と tracestate)

IBM MQ ユーザー・エグジットのトレースにはトレース相関情報の伝播が必要であり、Instanaトレースヘッダーと W3C トレースコンテキストヘッダーが IBM MQ メッセージ内で伝播されます。