このトピックには、以下のセクションが含まれています。
テキスト、メッセージ内容、また日時情報から構成されるトレース・レコードを生成するには、Trace ノードを使用します。 これは、メッセージ・フローの動きをモニターするのに役立ちます。
レコードをユーザー・トレース・ファイル、別のファイル、またはローカル・エラー・ログ (他のすべての WebSphere Business Integration Message Broker コンポーネントによって書き込まれるエラーおよび情報メッセージを含む) に書き込むことができます。 トレースをローカル・エラー・ログに書き込む場合には、WebSphere Business Integration Message Broker で提供されているデフォルトのメッセージ・カタログからメッセージを発行したり、独自のメッセージ・カタログを作成することができます。
Trace ノードの操作は、Trace ノードがあるメッセージ・フローのユーザー・トレースの設定から独立しています。 特に、Trace ノードがユーザー・トレース・ログに書き込むレコードは、ユーザー・トレースがメッセージ・フローに対してその時点でアクティブでなくても書き込まれます。
ワークベンチでは、Trace ノードは次のアイコンで表されます。
このノードが使用される方法に関しては、次のサンプルを参照してください。
Trace ノードを組み込むと、メッセージ・フローでのエラーを診断するのに役立ちます。 フロー内のさまざまなポイントでメッセージの内容をトレースすると、処理のシーケンスを判別できます。 また、メッセージ内容を記録するようにトレース・ノードを構成して、メッセージに対する特定のノードのアクションを検査できます。 たとえば、Compute ノードの直後に Trace ノードを組み込み、出力メッセージが要求したとおりの形式になっているかを検査できます。
テストを行い、操作が正しいことを検証したら、フローから Trace ノードを除去します。
さらに、Trace ノードを使用して、メッセージ・フローでのエラー処理における情報を提供することができます。 たとえば、このノードを使用して、メッセージ内容または形式のエラーが原因で処理で生じる障害を記録できます。
Trace ノードのインスタンスをメッセージ・フローに入れると、Trace ノードを構成することができます。 エディター・ビューでノードを右クリックして、「プロパティー (Properties)」を選択します。 ノードの基本プロパティーが表示されます。
値を入力する必要のある (デフォルト値が定義されていない) すべての必須プロパティーには、プロパティー・ダイアログにアスタリスクが表示されます。
以下のように、Trace ノードを構成します。
トレース・レコードに記録される情報が、以下に書き込まれます。
このオプションを選択する場合には、書き込むトレース・メッセージの数、およびメッセージが定義されているメッセージ・カタログを指定する必要があります。
また、「メッセージ番号 (Message Number)」に、レコードのエラー番号を入力する必要があります。 番号 3051 から 3099 が、このために WebSphere Business Integration Message Broker (デフォルト) カタログで予約されています。 これらの各デフォルト・メッセージ・カタログのテキストは同じですが、トレースする各状態ごとにこの範囲内の番号を使用すると、エラーの正確な原因を特定できます。 デフォルトのメッセージ番号は 3051 です。
また、「メッセージ番号 (Message Number)」プロパティーに、ローカル・エラー・ログに書き込みたいカタログ内のメッセージに該当する番号を入力する必要もあります。 一部のプラットフォームでは、00 で終わるメッセージ番号はシステムで使用するために予約されているので、メッセージ・カタログには 3100 のような番号のメッセージを組み込まないでください。
これらのレコードは、配置されたメッセージ・フローの「ユーザー・トレース (User Trace)」プロパティーの設定に関係なく書き込まれます。
ユーザー・トレースは、ルート・ディレクトリーの ¥log サブディレクトリーに書き込まれます (たとえば、Windows 2000 のデフォルトでは c:¥Program Files¥IBM¥WebSphere Business Integration Message Broker です)。 このファイル名は、ブローカー名、ブローカーの UUID、および userTrace.bin の接尾部から構成されます (たとえば、broker.e51906cb-dd00-0000-0080-b10e69a5d551.userTrace.bin.0 となります)。 ユーザー・トレース・ログを表示する前に、mqsireadlog および mqsiformatlog コマンドを使用する必要があります。
このオプションを選択する場合には、「ファイル・パス (File Path)」を、トレースの完全修飾パス名に設定することも必要です。 このパスを設定しない場合、ファイルの位置はシステムに依存します。 たとえば、z/OS の場合には、ファイルはブローカー・サービス ID のホーム・ディレクトリーに作成されます。
トレース・ファイルには任意の名前を付けることができます。 たとえば、c:¥$user¥trace¥trace.log のように指定します。
まだ存在していないファイルを指定した場合には、そのファイルが作成されます。 ただし、この処理ではライブラリーは作成されません。 したがって、絶対パスがすでに存在している必要があります。
以下のパターンは、使用可能なオプションの一部を示しています。 テキストの最初の行が書き込まれ、現行メッセージの 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 ノードが含まれているメッセージ・フローは通常どおりデプロイされますが、このノードからはトレース・レコードは書き出されません。
「キャンセル (Cancel)」をクリックすると、ダイアログを閉じてプロパティーの変更をすべて破棄します。
Trace ノード・ターミナルについては、次の表に説明されています。
ターミナル | 説明 |
---|---|
In | ノードが処理するメッセージを受け入れる入力ターミナル。 |
Out | メッセージが伝搬される際に経由する出力ターミナル。 |
以下の表でノードのプロパティーを説明します。M の見出しの列は、プロパティーが必須 かどうかを示します (デフォルトが定義されていない場合に値を入力することが必要なら、プロパティー・ダイアログにアスタリスクのマークが付きます)。 C の見出しの列は、プロパティーが構成可能 かどうかを示します (メッセージ・フローを bar ファイルに追加してデプロイするとき、値を変更できます)。
Trace ノードの「基本 (Basic)」プロパティーについては、次の表に説明されています。
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
宛先 (Destination) | はい | いいえ | ユーザー・トレース (User Trace) | このノードが書き込むトレース・レコードの宛先。 有効な選択項目は、「ユーザー・トレース (User Trace)」、「ファイル (File)」、「ローカル・エラー・ログ (Local Error Log)」、および「なし (None)」です。 |
ファイル・パス (File Path) | いいえ | はい | レコードが書き込まれるファイルの完全修飾ファイル名。 「宛先 (Destination)」が「ファイル (File)」に設定されている場合に限り有効です。 | |
パターン (Pattern) | いいえ | いいえ | トレース・レコードに含めるデータ。 | |
メッセージ・カタログ (Message Catalog) | いいえ | いいえ | 例外のエラー番号のエラー・テキストを取り出す元のメッセージ・カタログの名前。 デフォルト値 (ブランク) は、WebSphere Business Integration Message Broker で提供されるメッセージ・カタログからメッセージが取られることを示します。 | |
メッセージ番号 (Message Number) | いいえ | いいえ | 3051 | 書き込むメッセージのエラー番号。 |
Trace ノードの「説明 (Description)」プロパティーについては、次の表に説明されています。
プロパティー | M | C | デフォルト | 説明 |
---|---|---|---|---|
簡略説明 (Short Description) | いいえ | いいえ | ノードの簡単な説明 | |
詳細説明 (Long Description) | いいえ | いいえ | メッセージ・フロー内のノードの目的を説明するテキスト |
注意 |
商標 |
ダウンロード |
ライブラリー |
技術サポート |
フィードバック
![]() ![]() |
ac04840_ |