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