2.8 ログ機能
概要
biz-StreamのWebサービスサーバではログの出力にLog4j の後継と位置づけられているロギングライブラリであるLogbackを使用しています。
Logbackではログの出力方法等を柔軟に設定することが可能です。
Logbackの設定はconfディレクトリ下にあるlogback.xmlで行います。
logback.xmlの記述方法についての詳細は、biz-Streamライブラリ共通ガイド『第4章 ログ設定』を参照してください。
Webサービスサーバで出力されるログファイル
| ログファイル名 | 概要 |
|---|---|
| bspdf.log | PDFライブラリに関するログ |
| bsxml.log | XMLエンジンに関するログ |
| bs.log | その他ブレインセラーズのライブラリに関するログ |
| other.log | ブレインセラーズ以外のライブラリに関するログ |
| soap.log | SOAPメッセージの入出力に関するログ |
| webdav.log | コンテンツリポジトリへWebDAV経由でのアクセスに関するログ |
ここではWebサービスサーバ独自のログの設定について説明します。
Webサービスサーバにおけるログ機能
Webサービスサーバへ、クライアントアプリケーションからSOAPでアクセスされた際に、そのクライアント情報と操作情報を監査ログとして記録します。その際に記録する項目は下表を参照してください。記録時には別途フィルタリング設定をしておくことにより、そのフィルタ条件を満たすもののみログに残すことができ、かつ、項目毎にログに記録する・しないを設定することができます。
ログは、デフォルト設定の場合は、logs/soap.logに記録されます。
soap.log
| 項目名 | 説明 | フィルタリング |
|---|---|---|
| HostName | リクエストを送信したクライアントのホスト名 | 指定可能 |
| IpAddress | リクエストを送信したクライアントのIPアドレス | 指定可能 |
| Service | WSSのサービス名 | 指定可能 |
| Operation | WSSのオペレーション名 | 指定可能 |
| RequestEnvelope ※1 | SOAPリクエスト・エンベロープ | 指定不可能 |
| ResponseEnvelope ※1 | SOAPレスポンス・エンベロープ | 指定不可能 |
| RequestTime | リクエストを受け付けたシステム時刻 | 指定可能 |
| User | リクエストを送信したクライアントのユーザ名 ただし、ユーザ認証を経てアクセスされた場合に限る | 指定可能 |
| UserDef | ロギング設定サービス経由で設定した値 HTTPのリクエストにてパラメータ名"UserDef"として設定された文字列が使用される | 指定可能 |
- ※1インストール時のデフォルト状態では出力されません。出力する為には、logback.xmlの「SOAP Log definitions」内のコメントアウト個所をコメントインする必要があります。
コンテンツ生成/管理機能におけるログ機能
Webサービスサーバのコンテンツリポジトリへ、クライアントアプリまたはユーザからアクセスされた際に、そのクライアント情報と操作情報を監査ログとして記録します。その際に記録する項目については、下表を参照してください。
ログは、デフォルト設定の場合は、logs/webdav.logに記録されます。
webdav.log
| 項目名 | 説明 | フィルタリング |
|---|---|---|
| HostName | リクエストを送信したクライアントのホスト名 | 指定可能 |
| IpAddress | リクエストを送信したクライアントのIPアドレス | 指定可能 |
| Method | リクエスト(WebDAV)のメソッド名 | 指定可能 |
| URI | リクエスト時のURI(ファイルパスなど) | 指定可能 |
| User | リクエストを送信したクライアントのユーザ名 | 指定可能 |
- 記録する経路はWebDAV経由にてリポジトリにアクセスした場合に限ります。Webサービス(SOAP)経由の場合は、Webサービスログ機能にて記録します。
その他のログ
その他のログについては、以下のファイルが設定ファイルになります。
| logファイル | 設定ファイル |
|---|---|
| axis2.log | <bsws_server_home>/conf/logback.xml |
| jackrabbit.log | <bsws_server_home>/conf/logback.xml |
| localhost_access_log.YYYY-MM-DD.txt | <bsws_server_home>/conf/logging.properties |
