メッセージ・フローのテストおよびトラブルシューティング
開発環境でメッセージ・フローをテストして、本番稼働環境にデプロイする前に問題を検出できます。また、トレース・ノードを使用して、メッセージ・フローのデプロイ後にそのメッセージ・フローをトラブルシューティングする一助となります。さらに、メッセージ・フロー・ノードとメッセージ・フロー・ノードの単体テスト作成や、開発中またはメッセージ・フローのデプロイ後のテスト実行もできます。
始める前に
メッセージフロー および IBM® App Connect Enterprise ツールキットにおけるその表現について、基本的な理解が必要です。 メッセージ・フローの概要を参照してください。
このタスクの概要
- フロー・エクササイザー の使用
フロー・エクササイザー を使用して、メッセージ・フローをデプロイし、メッセージを作成してフローに送信することができます。 メッセージの処理後、そのメッセージの使用したパスは強調表示されます。 その後、メッセージ・フローの任意の強調表示された接続における論理メッセージ・ツリーの構造および内容を表示できます。 フロー・エクササイザーを使用したメッセージ・フローのテストを参照してください。 メッセージ・フローの操作を確認する場合は、 フロー・エクササイザー を使用できます。
- メッセージ・フローの単体テストの作成
- 単体テストを作成して実行し、 App Connect Enterprise フローおよびメッセージ・フロー・ノードの操作を検証できます。 開発中のフローおよびノード、または既にデプロイされているフローに対するテストを作成して実行することができます。 詳しくは、 統合テストの開発を参照してください。
- フロー・デバッガーの使用
- フロー・デバッガーを使用すると、メッセージ・フロー内でメッセージをリアルタイムで追跡できます。 メッセージ・フロー内にブレークポイントを設定してからフロー内をステップスルーできます。 ステップスルー中に、メッセージ変数と、 ESQL コードおよび Java™ コードによって使用される変数を調べて変更することができます。 フロー・デバッガーを使用したメッセージ・フローのテストを参照してください。 フロー・デバッガーは、メッセージ・フローに問題があることが分かっていて、その問題のトラブルシューティングを行う必要があるような状況で使用できます。注: フロー・エクササイザーでフロー・デバッガーを使用することはできません。 フロー・デバッガーを使用する場合は、サード・パーティー・ツールまたは テスト・クライアント を使用してメッセージをフローに送信する必要があります。 テスト・クライアントを参照してください。
- ユーザー・トレースを有効に設定
ユーザー・トレースを有効にすることで、特定のメッセージ・フローで実行された処理の履歴を表示できます。 組み込みノードは、作業処理時にメッセージをユーザー・トレースに書き込みます。 これらのメッセージを使用して、メッセージ・フロー内のアクティビティーを確認し、呼び出されたメッセージ・フロー・ノード、ノードが実行したコード、およびメッセージ送信の経由端末などの情報を表示することができます。 ユーザー・トレースの有効化によるメッセージ・フローのテストを参照してください。
- トレース・ノードの使用
トレース・ノードを使用することで、独自のデバッグ情報をメッセージ・フロー内の特定のポイントに書き込むことができます。 デバッグ情報は、ファイル、ユーザー・トレース、またはシステム・ログに書き込まれます。 メッセージ・フローが 1 つ以上のメッセージを処理すると、ユーザーはその情報を確認できます。 Trace ノードの追加によるメッセージ・フローのテストを参照してください。 開発中にトレース・ノードをメッセージ・フローに追加することで、フローを実稼働環境にデプロイした後、ユーザー・トレースを使用してフローのトラブルシューティングを行う場合に追加情報を取得できます。
- 例外ログの使用可能化
- 例外ログは、メッセージ・フロー内の問題やエラーに関連するデータを記録するために有効にします。 例外ログの有効化を参照してください。