Trace ノードを使用して、メッセージ・フローの動作をモニターするのに使用できるトレース・レコードを生成します。
このトピックには、以下のセクションが含まれています。
トレース・レコードには、メッセージ・フローの動きをモニターするのに役立つ、テキスト、メッセージ内容、また日時情報を盛り込むことができます。
選択に応じて、レコードをユーザー・トレース・ファイル、別のファイル、 またはローカル・エラー・ログ (他のすべての WebSphere® Message Broker コンポーネントによって書き込まれるエラーおよび情報メッセージが記載されます) に書き込むことができます。 トレースをローカル・エラー・ログに書き込む場合には、WebSphere Message Broker で提供されているデフォルトのメッセージ・カタログからメッセージを発行したり、独自のメッセージ・カタログを作成することができます。
Trace ノードの操作は、そのノードを含むメッセージ・フローのユーザー・トレースの設定から独立しています。 特に、Trace ノードがユーザー・トレース・ログに書き込むレコードは、 ユーザー・トレースがメッセージ・フローに対してその時点でアクティブでなくても書き込まれます。
Trace ノードはパレットの「構造」ドロワーに含まれていて、ワークベンチ内では次のアイコンによって表されます。
このノードが使用される方法に関しては、次のサンプルを参照してください。
サンプルは、Message Brokers Toolkit と統合されているインフォメーション・センターを使用する場合にのみ表示できます。
Trace ノードを組み込むと、 メッセージ・フローでのエラーを診断するのに役立ちます。 フロー内のさまざまなポイントでメッセージの内容をトレースすると、処理のシーケンスを判別できます。 メッセージの内容を記録したり、メッセージに対する特定のノードのアクションを検査できるよう、Trace ノードを構成できます。 例えば、Compute ノードの直後に Trace ノードを組み込み、 出力メッセージが要求したとおりの形式になっているかを検査できます。
さらに、Trace ノードを使用して、メッセージ・フローでのエラー処理における情報を提供することができます。 例えば、このノードを使用して、メッセージの内容または形式のエラーに起因する処理中の障害を記録できます。
メッセージ・フローのテストを行い、 操作が正しいことを検証したら、メッセージ・フローから Trace ノードを除去します。
Trace ノードのインスタンスをメッセージ・フローに入れると、それを構成することができます。メッセージ・フロー・ノードの構成を参照してください。 ノードのプロパティーが、「プロパティー」ビューに表示されます。ノードのプロパティーを「プロパティー」ダイアログに表示するには、ノードをダブルクリックするか、またはノードを右クリックしてから「プロパティー」をクリックします。 値を入力する必要のある (デフォルト値が定義されていない) すべての必須プロパティーには、アスタリスクが表示されます。
Trace ノードのターミナルについては、次の表に説明されています。
ターミナル | 説明 |
---|---|
In | ノードが処理するメッセージを受け入れる入力ターミナル。 |
Out | メッセージが伝搬される際に経由する出力ターミナル。 |
以下の表は、ノード・プロパティーについて説明しています。 M の見出しの列は、プロパティーが必須 かどうかを示します (デフォルトが定義されていない場合に値を入力することが必要なら、アスタリスクのマークが付きます)。 C の見出しの列は、プロパティーが構成可能 かどうかを示します (メッセージ・フローを BAR ファイルに追加してデプロイするとき、値を変更できます)。
Trace ノードの「説明」プロパティーについては、次の表に説明されています。
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
ノード名 | いいえ | いいえ | ノード・タイプ: Trace | ノードの名前。 |
簡略説明 | いいえ | いいえ | ノードの簡単な説明 | |
詳細説明 | いいえ | いいえ | メッセージ・フロー内のノードの目的を説明するテキスト |
Trace ノードの基本プロパティーについては、次の表に説明されています。
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
宛先 | はい | いいえ | ユーザー・トレース | このノードが書き込むトレース・レコードの宛先。
宛先は、
Trace ノードがデプロイされるブローカーをホストするコンピューターを参照します。
|
ファイル・パス | いいえ | はい | レコードが書き込まれるファイルの完全修飾ファイル名。 「宛先」が「ファイル」に設定されている場合に限り、このプロパティーは有効です。 | |
パターン | いいえ | いいえ | トレース・レコードに含めるデータ。書き込む情報を指定するための ESQL パターンを作成します。
トレース・レコードをローカル・エラー・ログに書き込む場合は、選択したメッセージ番号のテキストに書き込まれる情報がパターンによって制御されます。
デフォルトのメッセージ・カタログを使用し、3051 から 3099 の範囲内の番号を使用する場合、メッセージ・テキストにパターン情報が &1 のように挿入されます。
以下のパターンは、有効なオプションの一部を示しています。
このパターンにより、テキストの最初の行が書き込まれ、現行メッセージの 2 つのエレメントが記録され、単純なタイム・スタンプが追加されます。
Message passed through with the following fields: Store name is ${Body.storedetailselement.storename} Total sales are ${Body.totalselement.totalsales} Time is: ${EXTRACT(HOUR FROM CURRENT_TIMESTAMP)} :${EXTRACT(MINUTE FROM CURRENT_TIMESTAMP)} 結果のトレース・レコードは次のようになります。
Message passed through with the following fields: Store name is 'SRUCorporation' Total sales are '34.98' Time is: 11:19 パターンに構文エラーがあると、Trace ノードが含まれているメッセージ・フローは通常どおりデプロイされますが、 このノードからはトレース・レコードは書き出されません。 |
|
メッセージ・カタログ | いいえ | いいえ | 例外のエラー番号のエラー・テキストを取り出す元のメッセージ・カタログの名前。 デフォルト値 (ブランク) は、WebSphere Message Broker で提供されるメッセージ・カタログからメッセージが取られることを示します。![]() ![]() |
|
メッセージ番号 | いいえ | いいえ | 3051 | 書き込むメッセージのエラー番号。 |