IBM MQ トレース

IBM MQ のユーザー・エクジットを使用することで、 IBM MQ のメッセージを追跡することができます。 IBM MQ のユーザー・エグジットを使用することで、メッセージの流れに関する有益な情報を得て、潜在的な問題を特定することができます。

IBM MQ のトレース・ユーザー・エクジットは、オンプレミスで展開された IBM MQ および、 Red Hat OpenShift クラスタ上のコンテナで実行されている IBM MQ をサポートしています。

IBM MQ トレースの構成

IBM MQ を効果的に追跡するには、以下の手順を実行してください：

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

環境ごとの手順については、以下を参照してください：

IBM MQ のトレース設定が完了すると、トレースデータは次のように報告されます：

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

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

IBM MQ によって収集されたトレースデータの追跡 IBM MQ メッセージにトレースコンテキストヘッダー（トレース相関情報）が設定されている場合、ユーザーエクジットやその他のトレーサーのトレースを相互に関連付けることができます。

IBM MQ Tracingは、以下のトレースコンテキストヘッダーをサポートしています：

IBM MQ で、ユーザー・エグジットのトレースを行う際にトレース相関情報の伝播が必要な場合、 IBM MQ メッセージ内で Instana トレースヘッダーおよび W3C トレースコンテキストヘッダーが伝播されます。

IBM MQ のトレースに関する問題のトラブルシューティングについては、「 IBM MQ のトレースのトラブルシューティング」を参照してください。