ユーザー・トレースは、WebSphere Message Broker で使用できるオプション・トレースの 2 つのタイプの 1 つです。ユーザー・トレースは、デフォルトでは非アクティブで、イベント・ログのエントリーに示されている以上の情報が必要な場合には、 コマンドかワークベンチで明示的にアクティブにする必要があります。ログの詳細については、ログを参照してください。
一般に、ユーザー・トレースは、アプリケーションをデバッグするときに使用し、ブローカー、実行グループ、およびデプロイされた メッセージ・フロー をトレースできます。
ワークベンチを使用することにより、必要なほとんどのトレース・アクティビティーを制御できます。また、ワークベンチを使用して、リモート・システムでのトレースを開始および停止することも可能です。
ユーザー・トレースを活動化すると、トレースするコンポーネントの全アクティビティーに対して、追加の処理が行われることになります。コンポーネントによって大量のデータが生成されます。ユーザー・トレースをアクティブにするときには、当然パフォーマンスは影響を受けると見なさなければなりません。トレース対象を選択することや、 トレースがアクティブになっている期間を制限することで、 この追加処理を制限できます。
ファイル名は、トレースがアクティブになっているコンポーネントおよびサブコンポーネントを反映します。例えば、ある実行グループ内のアクティビティーをトレースするときに、そのブローカーの名前と固有の実行グループ ID がファイル名の一部を構成することになります。
WBRK_BROKER.682ec116-dc00-0000-0080-ce28a236e03d.userTrace.bin.1WBRK_BROKER.682ec116-dc00-0000-0080-ce28a236e03d.userTrace.bin.2
これらのファイルを直接に表示することはできません。 提供されたコマンドを使用してトレース情報にアクセスし、表示可能な形式に変換します。mqsireadlog コマンドを使用すれば、指定したコンポーネントのトレース・ログを取り出すことができます。 このコマンドは、ログが生成されたコンピューター上で発行します。出力がファイルに送信されるように指定することができます。ファイルはオペレーティング・システムから独立しているので、表示するために他のシステムに転送したり、mqsiformatlog コマンドを使用してフォーマット設定したりすることができます。
メッセージ・フローの開発およびテスト時に Trace ノードを含める場合、このオプションを使用すると、フロー内のメッセージやアクティビティーをトレースできるだけでなく、 興味のある内容を取り分けるために、トレース内容用の代替ターゲット・ファイルを指定できます。Trace ノードの使用方法と構成方法の詳細については、Trace ノードのトピックを参照してください。