IBM FileNet P8, バージョン 5.2.1            

Process Engine REST Service のロギング

Apache log4j を使用して、Process Engine REST Service でロギングを構成できます。 ロギングの構成は、ロギングの動作、優先順位、および出力形式を指定するオプションを使って、log4j ファイルに設定します。 サンプルの log4j 構成ファイルが、Content Platform Engine インストールに含まれています。

Process Engine REST API のロギングを構成するには:

  1. Content Platform Engine インストールから、/install_path/IBM/FileNet/ContentEngine/tools/PE/samples/fnlog4j.properties.sample ファイルをコピーします。
  2. クライアントがデプロイされるアプリケーション・サーバーの 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/ の可能性があります。

  3. ファイルを fnlog4j.properties に名前変更します。
  4. 以下の例をガイドとして使用して、望ましいロギング・レベルを指定するように 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
  5. 更新した fnlog4j.properties ファイルを保存します。

    ファイルが正しい jre/lib ディレクトリー内にある場合、ロギングが自動的に有効になります。 クライアント・アプリケーションやアプリケーション・サーバーを再始動する必要はありません。



最終更新日: 2016 年 3 月
rest_logging.htm

© Copyright IBM Corp. 2016.