何か興味を引くことが生じた場合、IBM® Integration Bus がモニター・イベント (XML 文書) を発行するように構成することができます。 通常は、トランザクション・モニター、トランザクション監査、およびビジネス・プロセス・モニターをサポートするためにイベントが発行されます。 イベント XML はモニター・イベント・スキーマの WMBEvent.xsd に準拠しています。
WMBEvent.xsd スキーマ・ファイルは、ワークスペースにインポートした場合、WebSphere® Business Monitor のサンプルの WBMonitorEventsProject フォルダーに存在します。 また、WMBEvent.xsd ファイルは、デフォルトのメッセージ・カタログで利用できます。 IBM Integration Toolkit からスキーマにアクセスするには、をクリックします。
モニター・イベントには以下のアイテムも含まれる場合があります。
イベントを処理するソフトウェア (WebSphere Business Monitor など) がイベントを正しく順序付けられるようにするため、ISO 8601 タイム・スタンプとカウンター属性の両方が生成されます。 カウンター属性は、モニター・イベントの EventSequence エレメント内にあります。 このカウンターは、メッセージの処理により最初のイベント (通常は transaction.Start イベント) が生成されると 1 から始まり、以後イベントが生成されるたびに大きくなります。 次のメッセージの開始時に 1 にリセットされます。 すべてのモニター・イベントに対して、作成時刻とカウンターが常に生成されます。 イベントを処理するソフトウェアは、イベントの順序付けに使用するフィールドを選択でき、2 つのフィールドの組み合わせも選択できます。
メッセージが正常に処理された場合、生成されたモニター・イベントは、1 から始まって連続して大きくなっていく一連のカウンター値を持ちます。これはイベントが作成されたときに割り当てられたものです。 メッセージが失敗してロールバックされた場合は、カウンターのシーケンスにギャップが生じることがあります。 欠落するのは、ロールバックされたメッセージ・フロー作業単位の一部として生成されたイベントで使用された値です。
<?xml version="1.0" encoding="UTF-8"?>
<wmb:event xmlns:wmb=http://www.ibm.com/xmlns/prod/websphere/messagebroker/6.1.0/monitoring/event>
<wmb:eventPointData>
<wmb:eventData wmb:eventSourceAddress="MQInput1.terminal.in"
wmb:eventSchemaVersion="6.1.0.3" wmb:productVersion="7000">
<wmb:eventIdentity wmb:eventName="MQInput event"/>
<wmb:eventSequence wmb:creationTime="2001-12-31T12:00:00+01:00" wmb:counter='2'/>
<wmb:eventCorrelation wmb:localTransactionId="123"
wmb:parentTransactionId="456"
wmb:globalTransactionId="789"/>
</wmb:eventData>
<wmb:messageFlowData>
<wmb:broker wmb:UUID="d53122ae-1c01-0000-0080-b1b02528c6bf"
wmb:name="myBroker"/>
<wmb:executionGroup wmb:UUID="d43122ae-1c01-0000-0080-b1b02528c6bf"
wmb:name="default"/>
<wmb:messageFlow wmb:UUID="e6d224ae-1c01-0000-0080-9100cd1a61f7"
wmb:name="myMessageFlow" wmb:threadId="4201"
wmb:uniqueFlowName="myBroker.default.myMessageFlow"/>
<wmb:node wmb:nodeLabel="MQInput1" wmb:nodeType="ComIbmMqInputNode"
wmb:terminal="in" wmb:detail="MYMESSAGEFLOW.IN"/>
</wmb:messageFlowData>
</wmb:eventPointData>
<wmb:applicationData xmlns="">
<wmb:simpleContent wmb:name="invoiceNo" wmb:targetNamespace=""
wmb:dataType="string" wmb:value="567"/>
<wmb:complexContent wmb:elementName="customerName" wmb:targetNamespace="">
<customerName>
<firstName>Steve</firstName>
<lastName>Bloggs</lastName>
</customerName>
</wmb:complexContent>
</wmb:applicationData>
<wmb:bitstreamData>
<wmb:bitstream wmb:encoding="base64Binary">TUQgIAIAAAAAAAAACAAAAP////8AAAAAIgIAALUBAAAgICAgICAg
IAAAAAAAAAAAQU1RIFFNMSAgICAgICAgIHo640ggABsHAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACAgICAgICAgICAgICAgI
CAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIFFNMSAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIC
Ag</wmb:bitstream>
</wmb:bitstreamData>
</wmb:event>
イベントが発行される場合、メッセージ・フローのモニター・プロパティーによって提供される情報を使用して、またはモニター・プロファイル構成可能サービスがメッセージ・フローに適用されている場合にはそれを使用して、イベント内のフィールドが作成されます。 明確に指定されていないすべてのイベント・フィールドには、表に示されているようにデフォルト値が与えられます。
| イベント中のフィールド | デフォルト値 |
|---|---|
| eventData/@wmb:eventSourceAddress | デフォルトはありません。この情報を提供する必要があります。 |
| eventData/@wmb:eventSchemaVersion | 6.1.0.3 |
| eventData/@wmb:productVersion | 7000 |
| eventData/eventIdentity/@wmb:eventName | デフォルトは @eventSourceAddress から派生されます。 |
| eventData/eventSequence/@counter | 最初のイベントが発行されるとカウンターは 1 に設定され、以降のイベントごとに 1 ずつ大きくなります。 |
| eventData/eventSequence/@creationTime | イベントが作成された日時。 |
| eventData/eventCorrelation/@localTransactionId | 生成された固有 ID。 |
| eventData/eventCorrelation/@parentTransactionId | デフォルトなし。 この値を設定しなければ、空ストリングが使用されます。 |
| eventData/eventCorrelation/@globalTransactionId | デフォルトなし。 この値を設定しなければ、空ストリングが使用されます。 |
| messageFlowData/broker/@name | ブローカーの名前。 |
| messageFlowData/broker/@UUID | ブローカーの UUID。 |
| messageFlowData/executionGroup/@name | 実行グループの名前。 |
| messageFlowData/executionGroup/@UUID | 実行グループの UUID。 |
| messageFlowData/messageFlow/@name | メッセージ・フローの名前。 |
| messageFlowData/messageFlow/@UUID | メッセージ・フローの UUID。 |
| messageFlowData/messageFlow/@uniqueFlowName | ブローカー、実行グループ、およびフローの名前で構成されるストリング。形式は brokerName.executionGroupName.flowName。 |
| messageFlowData/messageFlow/@threadId | メッセージ・フローのスレッド ID。 フォーマットはプラットフォームに応じて異なります。 |
| messageFlowData/node/@nodeLabel | イベントを発行したノードのラベル。 |
| messageFlowData/node/@nodeType | イベントを発行したノードのタイプ。 |
| messageFlowData/node/@nodeDetail | ノードに関するオプション情報。
|
| applicationData | デフォルトはありません。提供しないと無視されます。 |
| bitstreamData | デフォルトはありません。提供しないと無視されます。 |