第8章 ルートを介したメッセージのトレース

ツールバーの右側にある ボタンをクリックし、リストから Fuse Integration を選択します。

Fuse Integration パースペクティブがデフォルトのレイアウトで開きます。

JMX Navigator タブを Terminal タブの右端にドラッグし、そこにドロップします。

この配置により、Diagram View がルーティングコンテキストのノードをグラフィカルに表示するためのスペースが増え、メッセージがルーティングコンテキストを通過する際にたどるパスを視覚的に追跡しやすくなります。

注記

ルーティングコンテキストの .xml ファイルへのアクセスを容易にするために (特にプロジェクトが複数のコンテキストで設定される場合)、このツールは Project Explorer の Camel Contexts フォルダーにコンテキストを一覧表示します。

さらに、ルーティングコンテキスト内のすべてのルートは、コンテキストファイルエントリーのすぐ下にアイコンとして表示されます。キャンバスのルーティングコンテキストに単一のルートを表示するには、Project Explorer でそのアイコンをダブルクリックします。ルーティングコンテキスト内のすべてのルートを表示するには、コンテキストファイルエントリーをダブルクリックします。

Run As Local Camel Context (without tests) を選択します。

JMX Navigator で、Local Processes を展開します。

ルートの要素を展開します。

Routes ノードを右クリックし、Start Tracing を選択します。

ツールは、ルーティングコンテキストのグラフィック表現を Diagram View に表示します。

すべてのメッセージフローパスを明確に表示するには、ノードをドラッグして Diagram View タブにぴったり収まるようにノードを再配置する必要があります。また、Red Hat CodeReady Studio の他のビューとタブのサイズを調整して、Diagram View タブを拡張できるようにする必要がある場合もあります。

Project Explorer で、メッセージファイル (message1.xml から message6.xml まで) にアクセスできるように ZooOrderApp/src/data を展開します。

message1.xml を JMX Navigatorの _context1>Endpoints>file>src/data?noop=true ノードにドラッグアンドドロップします。

メッセージがルートを通過すると、ツールは各ステップでその通過をトレースして記録します。

パネルのメニューバー の アイコンをクリックし、Configure Columns を選択して、Configure Columns ウィザードを開きます。

アイテムを選択または選択解除することにより、Messages View にアイテムを含めたり除外したりできます。選択した個々のアイテムを強調表示してリスト内で上下に移動することにより、Messages View にアイテムが表示される列の順序を並べ替えることができます。

Configure Columns ウィザードで、次の方法で列を選択して順序付けします。

これらの列とその順序は、再度変更するまで Messages View に保持されます。

Messages View で (リフレッシュボタン) をクリックし、表示に message2.xml のメッセージトレースを反映させます。

JMX Navigator でメッセージをドロップするたびに、Messages View を更新してメッセージトレースを入力する必要があります。

メッセージトレースのいずれかをクリックし、Properties ビューでその詳細を表示します。

このツールでは、メッセージトレースに関する詳細 (メッセージヘッダーが設定されている場合はそれを含む) が Properties ビューの上半分に、メッセージインスタンスのコンテンツが Properties ビュー下半分に表示されます。したがって、アプリケーションがルート内の任意のステップでヘッダーを設定する場合は、Message Details をチェックして、それらが期待どおりに設定されているかどうかを確認できます。

各メッセージを強調表示して、特定のメッセージがルートをどのように通過したか、およびルートの各ステップで期待どおりに処理されたかどうかを確認することで、メッセージインスタンスをステップスルーできます。

Diagram View を開き、ルートの関連するステップが強調表示されていることを確認します。

ツールは、Diagram View でルートを表示し、処理ステップを終了するパスにタイミングとパフォーマンスのメトリック (ミリ秒単位) をタグ付けします。メトリックの Total exchanges のみが図に表示されます。

表示されたメトリックにマウスポインターを合わせると、メッセージフローに関する追加のメトリックが表示されます。

任意で、トレースが有効であれば、いつでも ZooOrderApp/src/data/ の残りのメッセージを JMX Navigator の _context1>Endpoints>file>src/data?noop=true ノードにドラッグし、ドロップすることができます。

ドロップするたびに、 (更新ボタン) をクリックし、Messages View に新しいメッセージのトレースを入力することを忘れないでください。

それが終わったら: