レガシー XML 監査証跡

概要

TIBCO EBX®リポジトリで実行された永続的な更新はすべて、監査証跡XMLファイルに記録されます。プロシージャは常にトランザクションと見なされるため、更新を実行しなくても、プロシージャの実行もログに記録されます。次の情報がログに記録されます。

• データセットの作成、レコードの変更、レコードの削除、特定の手順などのトランザクションタイプ。

• トランザクションが実行されるデータスペースまたはスナップショット。

• トランザクションソース。アクションがEBX®によって開始された場合、このソースは、ユーザーID、HTTPセッションID、およびクライアントIPアドレスによって記述されます。アクションがプログラムで開始された場合、ユーザーのIDのみがログに記録されます。

• セッションに関するオプションの「trackingInfo」値。

• トランザクションの日付と時刻（ミリ秒単位）。

• トランザクションUUID（Leach-Salzバリアント、バージョン1に準拠）。

• エラー情報（トランザクションが失敗した場合）。

• 実行された更新の詳細。更新があり、履歴の詳細がアクティブになっている場合は、次のセクションを参照してください。

更新の詳細とディスク管理

監査証跡は、EBX®リポジトリで行われたすべての更新を最高レベルで説明できます。したがって、XMLファイルは非常に大きくなる可能性があり、監査証跡ディレクトリは注意深く監視する必要があります。以下を考慮に入れる必要があります。

1. アーカイブのインポートが非対話型モード（変更セットなし）で実行された場合、監査証跡は更新の詳細を示しません。インポートされたアーカイブのみを指定します。この場合、インポート-置換の詳細なトレースを保持することが重要である場合は、アーカイブ自体を保持する必要があります。

2. アーカイブのインポートが（変更が設定された）対話モードで実行される場合、またはデータスペースがその親にマージされる場合、結果のログサイズはアーカイブの解凍されたサイズのほぼ3倍になります。さらに、一貫性の問題から、各トランザクションはメインファイルに移動される前に（監査証跡ディレクトリ内の）一時ファイルに記録されます。したがって、EBX®には、インポートできる最大のアーカイブの解凍サイズの少なくとも6倍が必要です。

3. 監査を必要としない多くの更新を実行するカスタムプロシージャのコンテキストでは、開発者はメソッド ProcedureContext.setHistoryActivation を使用して詳細な履歴を無効にすることができます。

ファイル編成

すべての監査証跡ファイルは、ディレクトリ ${ ebx.repository.directory}/History に保存されます。

「閉じた」監査ファイル

各ファイルの名前は次のとおりです。

<yyyy-mm-dd>-part<nn>.xml

ここで、<yyyy-mm-dd>はファイルの日付、<nn>は現在の日のファイルインデックスです。

現在の監査ファイルへの書き込み

監査ファイルが書き込まれているとき、XML構造は「オープンモード」での作業を意味します。変更のXMLエレメントは、次の名前のテキストファイルに追加されます。

<yyyy-mm-dd>-part<nn>Content.txt

標準のXML形式は、テキストファイルを参照するXMLファイルで引き続き使用できます。このファイルの名前は次のとおりです。

<yyyy-mm-dd>-part<nn>Ref.xml

これらの2つのファイルは、リポジトリが正常にシャットダウンされたとき、またはEBX®が再起動されたときに、「閉じた」XMLファイルに再集約されます。

監査ディレクトリの例