Apache log4j を使用して、Process Engine REST Service でロギングを構成できます。
ロギングの構成は、ロギングの動作、優先順位、および出力形式を指定するオプションを使って、log4j ファイルに設定します。
サンプルの log4j 構成ファイルが、Content Platform Engine インストールに含まれています。
Process Engine REST API のロギングを構成するには:
- Content Platform Engine インストールから、/install_path/IBM/FileNet/ContentEngine/tools/PE/samples/fnlog4j.properties.sample ファイルをコピーします。
- クライアントがデプロイされるアプリケーション・サーバーの jre/lib ディレクトリーにファイルを配置します。
以下の表に、クライアントが WebSphere® Application
Server にデプロイされる場合の jre/lib ディレクトリーのデフォルト・パスを示します。
オペレーティング・システム |
デフォルト・ファイル・パス |
AIX® |
/usr/IBM/WebSphere/AppServer/java/jre/lib |
Linux |
/opt/IBM/WebSphere/AppServer/java/jre/lib |
Linux for System z |
/opt/IBM/WebSphere/AppServer/java/jre/lib |
Windows |
drive:¥Program Files (x86)¥IBM¥WebSphere¥AppServer¥java¥jre¥lib¥ |
クライアントを Oracle WebLogic Server にデプロイした場合、jre/lib ディレクトリーの場所は、WebLogic Server が使用するように構成された JRE に応じて異なります。
JRE の例としては、Oracle JRockit、Sun、IBM JRE などがあります。JRockit JRE の場合、fnlog4j.properties ファイルの標準パスは /usr/Oracle/Middleware/bea/jrockit_version/jre/lib/ の可能性があります。
- ファイルを fnlog4j.properties に名前変更します。
- 以下の例をガイドとして使用して、望ましいロギング・レベルを指定するように fnlog4j.properties ファイルを編集してください。
# for tracking REST accesses------------------------------------------
log4j.appender.REST=org.apache.log4j.DailyRollingFileAppender
log4j.appender.REST.layout=org.apache.log4j.PatternLayout
log4j.appender.REST.layout.ConversionPattern=%d{yyyy/MM/dd HH:mm:ss} [%t] %m%n
log4j.appender.REST.File=c:\\RESTLog.txt
log4j.appender.REST.Append=true
# ---------- filenet.pe.rest.* loggers---------
log4j.logger.filenet.pe.rest=DEBUG,TXT
#--------------------------------------------------
log4j.logger.filenet.pe.rest.servlet=DEBUG
log4j.logger.filenet.pe.rest.request=DEBUG
log4j.logger.filenet.pe.rest.response=DEBUG
log4j.logger.filenet.pe.rest.handler=DEBUG
log4j.logger.filenet.pe.rest.utils=DEBUG
log4j.logger.filenet.pe.rest.auditTrail=INFO,REST
- 更新した fnlog4j.properties ファイルを保存します。
ファイルが正しい jre/lib ディレクトリー内にある場合、ロギングが自動的に有効になります。
クライアント・アプリケーションやアプリケーション・サーバーを再始動する必要はありません。