WebSphere Application Server での Common Base Event のロギング
以下を実施することで、ご使用のコンポーネント内、およびご使用の コンポーネントと WebSphere® Application Server コンポーネントとの間で、Common Base Event を一貫性をもって使用できるように なります。
以下のガイドラインに従ってください。
- それぞれのコンポーネントごとに異なるロガーを使用します。 複数のコンポーネント間でロガーを共有するということは、ロガーをコンポーネント固有の情報と関連付ける際の障害となります。
- ロガーを、ソース・コンポーネント識別を指定するイベント・テンプレートと関連付けます。 この関連付けにより、ロガーを使用して作成されたすべてのイベントのソースが、正しく識別されるようになります。
- 同じコンポーネント内で、直接作成された Common Base Event (Common Base Event ファクトリーを使用して作成されたイベント) および間接的に作成された Common Base Event (Java™ ロギング API を使用して作成されたイベント) に対して、同じテンプレートを使用します。
- データを Common Base Event に追加し終わって、ログに記録する準備ができるまで、Common Base Event 上で complete メソッドを呼び出さないようにしてください。 これにより、既にイベント内にあるデータに基づいてコンテンツ・ハンドラーによってなされる判断が、最終データを使用してなされるようになります。
以下のサンプルの Logger.properties ファイル・エントリーは、com.ibm.componentX ロガーを com.ibm.componentX イベント・ファクトリーと関連付ける方法を示しています。
com.ibm.componentX.eventfactory=com.ibm.componentX
以下のサンプル・コードは、直接 (パート 1) および間接 (パート 2) Common Base Event ロギング用の同じイベント・ファクトリー設定の使用を説明しています。
<?xml version="1.0" encoding="UTF-8"?>
<TemplateEvent>
version="1.0.1"
xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
xsi:noNamespaceSchemaLocation="templateEvent.xsd">
<CommonBaseEvent>
<sourceComponentId application="My application" component="com.ibm.componentX"/>
<extendedDataElements CommonBaseEventname="Sample ExtendedDataElement name" type="string">
<values>Sample ExtendedDataElement value</values>
</extendedDataElements>
< /CommonBaseEvent>
< /TemplateEvent>