8. ログ

8.1. ロギングの概要

ログは日々の運用でのメンテナンスや障害発生時の原因調査など、ログはシステム運営において重要な位置を占めています。本章ではWebOTX ASのロギングおよび業務アプリケーションからのログ出力方法について、その概要を説明します。

8.1.1. WebOTXのログについて

この節ではWebOTX AS が出力するログの概要を説明します。

8.1.1.1. ドメインを構成するサービスについて

WebOTX AS は運用領域をドメインと呼ばれる単位にグルーピングして管理しています。ドメインは各種の機能を提供するサービス群から構成されており、各サービスはその機能を提供するプロセス群またはモジュールと制御モジュールから構成されます。

各サービスは運用管理サービスの中核を担うAgentプロセス内のモジュールとその制御モジュールから構成されるサービスと、Agentプロセスの外部のプロセス群とAgentプロセス内の制御モジュールから構成されるサービスがあります。

図8.1.1.1-1

1つのドメイン内で出力されるログはそのドメインを構成するサービスが個々の方法を利用して出力しています。そのため、ログの出力方法はサービスにより異なります。

WebOTX ASのログの出力方法は大きくは以下のように分けられます。

• Log4otx(*1)によるログ出力
• サービス独自の方法によるログ出力

(*1)Log4JをベースとしたWebOTX AS独自のログモジュールです

このログ出力方法の違いから、WebOTX AS でのログの設定方法は多岐に渡っています。

そこで、WebOTX AS のログの概要を理解するために、まずはWebOTX AS を構成するサービスの関係について説明します。

ここで、WebOTX AS ではエディションによりドメインを構成するサービスが異なるため、以下にエディション別のサービス構成図を記します。

・Express

図8.1.1.1-2

Express ではドメインは、ドメイン全体を管理する 運用管理サービス、JMS関連の機能を提供するJMSサービス、CORBA通信関連の機能を提供するObject Brokerサービス、Webサーバ関連の機能を提供するWebServerサービスから構成されます。

ここで、運用管理サービスのAgentプロセスおよびJMSコンポーネントのJMSプロセスはともにJavaのプロセスであり、ログの出力にはLog4otxを用いています。その他のプロセスは独自の方法を利用してログを出力しています。

各サービスとログの関係の詳細については次節を参照してください。

・Standard/Enterprise

図8.1.1.1-3

Standard および Enterprise では Express を構成するサービスに加え、Transactionの管理機能を提供するTransactionサービス、高信頼実行基盤であるTPモニタ サービスから構成されます。また、運用管理サービスのAgentプロセスおよびJMSコンポーネントのJMSプロセスはともにLog4otxを、その他のプロセスは独自の機構を利用してログを出力しています。

各コンポーネントとログの関係については次節を参照してください。

サービスとログの関係

前節でも述べたようにサービスはプロセス群またはモジュールと制御モジュールから構成されています。また、制御モジュールはAgentプロセスの内部で稼動しています。ここで ${INSTANCE_ROOT}/logsにはサービス毎にディレクトリが分けられており、各ディレクトリにはプロセス群またはモジュールが出力するログファイルと制御モジュールが出力するログファイルが格納されます。

${INSTANCE_ROOT}/logs/

${INSTANCE_ROOT}/logs/agent/

${INSTANCE_ROOT}/logs/deploy/

${INSTANCE_ROOT}/logs/diagnostics/

${INSTANCE_ROOT}/logs/ejb/

${INSTANCE_ROOT}/logs/ha/

${INSTANCE_ROOT}/logs/jdbc/

${INSTANCE_ROOT}/logs/jpa/

${INSTANCE_ROOT}/logs/ObjectBroker/

${INSTANCE_ROOT}/logs/tpsystem/

${INSTANCE_ROOT}/logs/TS/

${INSTANCE_ROOT}/logs/web/

${INSTANCE_ROOT}/logs/wojms/

以下はエディション別のサービスと出力先ディレクトリの関係図です。

・Express

図8.1.1.1-4

Webサーバ、JMS、Object Brokerのサービスはそれぞれ外部プロセス群とAgentプロセス内の制御モジュールとから構成され、その他のサービスはAgentプロセス内のモジュールと制御モジュールから構成されています。また、サービス毎に${INSTANCE_ROOT}/logs内にディレクトリ区分されログが出力されます。

${INSTANCE_ROOT}/logs直下に出力されるとログファイルについては以下のようなログが出力されます。

webotx_agent.log ・・・Agentプロセス内の全てのサービスが出力するメッセージが出力されます。

server.log ・・・ Agentプロセスの標準出力が出力されます。

server_err.log ・・・ Agentプロセスの標準エラーが出力されます。

server_access.log ・・・ Webコンテナへのアクセスログが出力されます。

・Standard/Enterprise

図8.1.1.1-5

Expressの場合に加え、Transactionサービス、TPモニタサービスが各々外部プロセス群とサービスから構成され、追加されます。また、ExpressではAgentプロセス内で動作していたWebコンテナ(*2)、EJBコンテナがTPモニタ上で動作します。そして、サービス毎に${INSTANCE_ROOT}/logs内にディレクトリ区分されログが出力されます。

また、${INSTANCE_ROOT}/logs直下に出力されるwebotx_agent.log、server.log、server_err.logについてはExpressと同様です。

(*2) インストール時にアドバンスドモードを選択した場合

8.1.2. 業務アプリケーションからログを出力する場合

この節では業務アプリケーションからログを出力する方法について説明します。

業務アプリケーションからログを出力する方法として、以下を提供しています。

・JavaEE アプリケーション

 JDK Logger、Log4JなどJavaライブラリを用いて出力する方法と、標準出力に出力する方法があります。Log4Jを利用する場合は次節を参照してください。

(※1)  Log4Jなどのライブラリは業務アプリケーション側で用意する必要があります。

(※2） Log4OTXはWebOTX内部コンポーネント専用のライブラリであり、業務アプリケーションのログ出力用ライブラリとしては機能を提供していません。

・CORBA アプリケーション

WebOTX ASが提供するAPIを利用する方法があります。詳細は「APIリファレンスマニュアル」を参照してください。

8.1.2.1. 業務アプリケーションで用意したLog4Jを利用する場合

業務アプリケーションで用意したLog4Jを利用する場合、アプリケーションが利用するLog4J定義ファイルは、WEB-INF/classes以下に配置する必要があります。

図8.1.2.1-1

8.1.2.2. 標準出力を利用する場合

標準出力を利用する場合、エディションまたはドメインの構成により以下のファイルへ出力されます。

• Expressの場合

  標準出力の出力先ファイル(既定値はserver.log)に出力されます。

• Standard / Enterprise をスタンダードモードでインストールした場合

  Webアプリケーションでは、標準出力の出力先ファイル(既定値はserver.log)に出力されます。EJBアプリケーションでは、サーバアプリケーショントレースログに出力されます。

• Standard / Enterprise をアドバンスドモードでインストールした場合

  標準出力に出力したメッセージはサーバアプリケーショントレースログに出力されます。

8.2. 各サービスのログ

WebOTXの各サービスが出力するログについて説明します。

WebOTXの各オプション製品が出力するログに関しては、各製品のマニュアルを参照してください。

8.2.1. 運用管理

8.2.1.1. server.log、server_err.log

• 概要
  エージェントプロセスの標準出力と標準エラー出力の出力先ログ。 既定ではrotatetlogsを利用してローテートします。また、既定ではserver_err.logは出力されません。
  
  
• ローテート条件変更方法
  ローテート条件には時間またはファイルサイズを指定可能です。
  
  ファイルサイズを指定する場合、メガバイト単位で "<n>M"として指定してください。

  otxadmin > set server.log-service.rotatelogs-condition=<n>M

  設定可能なサイズはMB単位です。例えば、10MBを設定する場合は「10M」と設定してください。
  デフォルトでは2MBに設定されています。
  
  時間を指定する場合、ローテーションを行う間隔を"<rotationtime> <offset>" として指定してください。
  

  otxadmin > set server.log-service.rotatelogs-condition=<rotationtime> <offset>	

  <rotationtime>にはローテーション間隔を秒で、<offset>にはUTCからのオフセットを分で指定してください。
  例えば、日本はUTC+9に属するので、日本時間の零時にローテーションを行う場合は"86400 540"と指定します。
  
  
• 世代数設定方法
  世代数を超えたバックアップファイルについては削除されます。世代数の変更は以下のコマンドで変更することができます。デフォルトでは3となっています。

  otxadmin > set server.log-service.log-rotation-generations=<世代数>

  世代数管理を無効化する場合は以下のコマンドを実行してください。 ただし、世代管理を無効化した場合、ローテーションされたファイルは削除されずに残り続けます。 ログファイルによるディスクフルを引き起こさないためにも定期的にログファイルを削除するよう対処してください。

  otxadmin > set server.log-service.generation-management-enabled=false

  世代管理を無効化した場合、ログファイル名の末尾に「.<システム時間>」が追加されます。 また、ローテーション後のファイル名については、ファイル名の末尾に「.<世代数番号>」は付与されません。
  
  ※ 起動時のバージョン番号を含むログについて
  世代管理を無効化した場合、起動時にエージェントプロセスの標準出力と標準エラー出力の出力先は server.log.<システム時間>(またはserver_err.log.<システム時間>)に出力されますが、 ドメイン起動時に出力される以下のログメッセージは、${INSTANCE_ROOT}/logs/server.logに固定で出力されます。

  20xx-xx-xx xx:xx:xx,xxx com.nec.webotx.enterprise.admin.launcher.WebOTXLauncherLogger 情報: 
  ================================================================================
  [Version] WebOTX 9.30.00.00 (build xxxxxxxx)
  ================================================================================ 
  20xx-xx-xx xx:xx:xx,xxx com.nec.webotx.enterprise.admin.launcher.WebOTXLauncherLogger 情報: Successfully launched in 11 msec. 
  

  また、${INSTANCE_ROOT}/logs/server.logについても、世代管理が無効化されますので、 定期的にログファイルを削除するよう対処してください。
  
  
• レイアウト設定方法
  以下のコマンドでログの出力書式を設定することができます。既定では "%d - %m [%t]%n" となっています。
  
  ・標準出力

  otxadmin > set server.log-service.property.stdout-format="<レイアウトパターン>"

  ・標準エラー

  otxadmin > set server.log-service.property.stderr-format="<レイアウトパターン>"

• その他の設定
  ・標準出力と標準エラーを別のファイルに分ける方法
  以下のコマンドを実行してください。

  otxadmin > set server.log-service.separate-stdout-and-stderr=true

  既定では標準出力へserver.log、標準エラーはserver_err.logへ出力されるようになります。

8.2.1.2. webotx_agent.log

• 概要
  WebOTX ドメインのエージェントプロセス内で出力される全てのメッセージを統合したログ。
  
  
• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  

8.2.1.3. webotx_admin.log

• 概要
  WebOTXドメインのエージェントプロセス内の運用管理機能が出力するログ。
  
  
• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  モジュールログレベルの以下の属性を変更することでレベルが変わります。
  • Admin
  • Apache Commons
  • Server Core
  • Security

8.2.1.4. agent_operation.log

• 概要
  統合運用管理ツールまたは運用管理コマンドからの運用操作履歴に関するログ。
  
  
• 設定方法
  デフォルトでは出力されません。以下のコマンドを実行して機能を有効にしてください。
  また、設定を反映するためにドメインを再起動する必要があります。

  otxadmin > set server.admin-service.jmx-connector.jmx_connector.access-log-enabled=true	

• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  モジュールログレベルの以下の属性を変更することでレベルが変わります。
  • JMX Remote Access

8.2.1.5. webotx_prcstop.log

• 概要
  ドメインの強制停止を実行した際のログ。
  デフォルトではログファイルは存在しません。強制停止を初めて実行した際に、ログファイルが作成されます。
  
  
• ログサイズ変更方法
  ログサイズは無制限です。変更はできません。
  
  
• ローテーション設定方法
  ローテーションは設定できません。強制停止を実行する度に、2KB程度のログが追記されます。
  ログファイルのサイズが大きくなった場合は、手動でログファイルの退避や削除を実施してください。
  
  
• ログレベル変更方法
  ログレベルはありません。
  

8.2.1.6. adminconsole_operations.log

• 概要
  Web版統合運用管理コンソールの操作ログ。
  
  
• ログサイズ変更方法
  ログファイルの最大サイズを変更するには ${INSTANCE_ROOT}/config/log4otx.xml の以下の appender の MaxFileSize を編集し、ドメインを再起動してください。 ログファイルの最大サイズのデフォルト値は 10MB です。
  • ADMINCONSOLEOPERATIONSLOG
  
  
• ローテーション設定方法
  ログの世代数を変更するには ${INSTANCE_ROOT}/config/log4otx.xml の以下の appender の MaxBackupIndex を編集し、ドメインを再起動してください。 ログの世代数のデフォルト値は 3 です。
  • ADMINCONSOLEOPERATIONSLOG
  
  
• ログレベル変更方法
  ログレベルを変更するには ${INSTANCE_ROOT}/config/log4otx.xml の以下の logger のレベルを編集し、ドメインを再起動してください。 ログレベルのデフォルト値は INFO です。
  • com.nec.webotx.ajaxconsole.adminConsoleOperationsLogger

8.2.3. 配備

8.2.3.1. webotx_deploy.log

• 概要
  アプリケーション配備に関するログ。
  
  
• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  モジュールログレベルの以下の属性を変更することでレベルが変わります。
  • Deployment

8.2.4. EJBコンテナ

8.2.4.1. webotx_ejbcont.log

• 概要
  EJBコンテナが出力するログ。
  
  
• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  モジュールログレベルの以下の属性を変更することでレベルが変わります。
  • EJB Container

8.2.5. JDBC

8.2.5.1. webotx_jdbc.log

• 概要
  JDBCデータソースに関するログ。 デフォルトのログレベルは、次の通り、モジュールログレベルの属性によって異なります。
  • JDBC DataSource    CONFIG
  • JDBC Driver            WARN
  
  次の内容のログは、JDBC DriverのINFOレベルで出力されます。負荷を抑えつつ障害時にこれらのデバッグ情報を採取するためには、JDBC DriverのログレベルをINFOレベルに変更してください。
  • autoCommitモードがfalse に設定されている場合に、キャッシュしておいたJDBCドライバログの一部(データ更新に関わる内容のみ)を、例外発生を検出した際にまとめて出力
  • IRS利用時のJDBCドライバに設定されているトランザクション（マイクロシャード）の識別子
  
  
• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  モジュールログレベルの以下の属性を変更することでレベルが変わります。
  • JDBC DataSource
  • JDBC Driver

8.2.5.2. webotx_jta.log

• 概要
  JTA に関するログ。
  
  
• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  モジュールログレベルの以下の属性を変更することでレベルが変わります。
  • JTA

8.2.6. JMS

8.2.6.1. webotx_jms.log

• 概要
  JMSリソースアダプタおよびクライアントに関するログ。
  
  
• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  モジュールログレベルの以下の属性を変更することでレベルが変わります。
  • JMS Client

8.2.6.2. wojmsserver.log

• 概要
  JMSサーバのログ情報。
  
  
• ログサイズ変更方法
  以下のコマンドで変更することができます。デフォルトでは1048576 バイト(1MB) となっています。

  otxadmin > set server.jms-service.logfileRolloverBytes=<サイズ(バイト)>

• ローテーション設定方法
  ローテーションは上記で設定したファイルサイズを超えた場合、または経過時間で行うことができます。経過時間を設定する場合は、次のコマンドにより、秒単位で指定してください。デフォルトでは-1( 切り替えなし) が設定されています。

  otxadmin > set server.jms-service.logfileRolloverSecs=<秒>

  ローテーション数は、デフォルトで9世代となっています。変更する場合、${INSTANCE_ROOT}/wojms/instances/wojmsbroker/props/config.propertiesに以下の定義を追加してください。
  wojms.log.file.filenum=<世代数>
  
  
• ログレベル変更方法
  以下のコマンドでログレベルを変更してください。

  otxadmin > set server.jms-service.loglevel=<ログレベル>

  設定できるログレベルは以下になります。
  
  NONE, ERROR, WARNING, INFO, DEBUG, DEBUGMED, DEBUGHIGH

8.2.6.3. std.log

• 概要
  JMSサーバの標準出力、標準エラー出力。
  JMSサーバ起動時のエラーや、スレッドダンプの取得結果を出力します。
  
  
• ログサイズ変更方法
  ログサイズは無制限です。
  
  
• ローテーション設定方法
  JMS サーバが起動するタイミングでstd.log.bak にリネームし、一世代分のバックアップを行います。世代数は設定できません。
  
  
• ログレベル変更方法
  ログレベルはありません。

8.2.6.4. wojmsadmin.log

• 概要
  JMS 管理コマンドや、統合統合運用管理ツール、運用管理コマンドからの JMS サーバに対する運用管理操作の実行履歴。
  出力内容は[ 8.2.6.10. 出力形式について ]を参照してください。
  
  
• ログサイズ変更方法
  以下のコマンドで変更することができます。デフォルトでは1048576 バイト(1MB)となっています。

  otxadmin > set server.jms-service.logfileRolloverBytesAdmin=<サイズ(バイト)>

• ローテーション設定方法
  ローテーションは上記で設定したファイルサイズを超えた場合、または経過時間で行うことができます。経過時間を設定する場合は、次のコマンドにより、秒単位で指定してください。デフォルトでは-1(切り替えなし)が設定されています。

  otxadmin > set server.jms-service.logfileRolloverSecsAdmin=<秒>

  ローテーション数は、デフォルトで9世代となっています。変更する場合、${INSTANCE_ROOT}/wojms/instances/wojmsbroker/props/config.propertiesに以下の定義を追加してください。
  wojms.log.admin.filenum=<世代数>
  
  
• ログレベル変更方法
  ログレベルはありませんが、以下のコマンドで出力するかどうかを変更することができます。デフォルトではtrue(出力する)が設定されています。
  ・ログを出力する場合

  otxadmin > set server.jms-service.logAdmin=true

  ・ログを出力しない場合

  otxadmin > set server.jms-service.logAdmin=false

8.2.6.5. wojmspacket.log

• 概要
  JMS サーバとJMSクライアント間で送受信されるJMSメッセージのパケットの情報。
  
  
• ログサイズ変更方法
  以下のコマンドで変更することができます。デフォルトでは1048576 バイト(1MB) となっています。

  otxadmin > set server.jms-service.logfileRolloverBytesPacket=<サイズ(バイト)>

• ローテーション設定方法
  ローテーションは上記で設定したファイルサイズを超えた場合、または経過時間で行うことができます。経過時間を設定する場合は、次のコマンドにより、秒単位で指定してください。デフォルトでは-1( 切り替えなし) が設定されています。

  otxadmin > set server.jms-service.logfileRolloverSecsPacket=<秒>

  ローテーション数は、デフォルトで9世代となっています。変更する場合、${INSTANCE_ROOT}/wojms/instances/wojmsbroker/props/config.propertiesに以下の定義を追加してください。
  wojms.log.packet.filenum=<世代数>
  
  
• ログレベル変更方法
  ログレベルはありませんが、以下のコマンドで出力されるログの内容を変更することができます。デフォルトではいずれもfalse(出力しない)が設定されています。
  ・メッセージのパケット情報を出力する場合

  otxadmin > set server.jms-service.logPacketMessage=true

  ・PINGパケットの情報を出力する場合

  otxadmin > set server.jms-service.logPacketPing=true

  ・運用管理操作のパケット情報を出力する場合

  otxadmin > set server.jms-service.logPacketAdmin=true

  ・JMSサーバクラスタ構成でのクラスタパケットの情報を出力する場合

  otxadmin > set server.jms-service.logPacketCluster=true

8.2.6.6. wojmsmessage.log

• 概要
  メッセージライフサイクルの情報。
  JMSメッセージの送信先に対する送信（ADD）、送信先からの削除（REMOVE）に関する情報を出力します。出力形式は[ 8.2.6.10. 出力形式について ]を参照してください。
  
  
• ログサイズ変更方法
  以下のコマンドで変更することができます。デフォルトでは1048576 バイト(1MB) となっています。

  otxadmin > set server.jms-service.logfileRolloverBytesMessage=<サイズ(バイト)>	

• ローテーション設定方法
  ローテーションは上記で設定したファイルサイズを超えた場合、または経過時間で行うことができます。経過時間を設定する場合は、次のコマンドにより、秒単位で指定してください。デフォルトでは-1( 切り替えなし) が設定されています。

  otxadmin > set server.jms-service.logfileRolloverSecsMessage=<秒>
  				

  ローテーション数は、デフォルトで9世代となっています。変更する場合、${INSTANCE_ROOT}/wojms/instances/wojmsbroker/props/config.propertiesに以下の定義を追加してください。
  wojms.log.message.filenum=<世代数>
  
  
• ログレベル変更方法
  ログレベルはありませんが、以下のコマンドで出力するかどうかを変更することができます。デフォルトではfalse(出力しない)が設定されています。
  ・ログを出力する場合

  otxadmin > set server.jms-service.logMessage=true

  ・ログを出力しない場合

  otxadmin > set server.jms-service.logMessage=false

8.2.6.7. wojmserror.log

• 概要
  JMSが出力するエラー情報。
  
  
• ログサイズ変更方法
  以下のコマンドで変更することができます。デフォルトでは1048576 バイト(1MB) となっています。

  otxadmin > set server.jms-service.logfileRolloverBytesError=<サイズ(バイト)>

• ローテーション設定方法
  ローテーションは上記で設定したファイルサイズを超えた場合、または経過時間で行うことができます。経過時間を設定する場合は、次のコマンドにより、秒単位で指定してください。デフォルトでは-1( 切り替えなし) が設定されています。

  otxadmin > set server.jms-service.logfileRolloverSecsError=<秒>

  ローテーション数は、デフォルトで9世代となっています。変更する場合、${INSTANCE_ROOT}/wojms/instances/wojmsbroker/props/config.propertiesに以下の定義を追加してください。
  wojms.log.error.filenum=<世代数>
  
  
• ログレベル変更方法
  ログレベルはありませんが、以下のコマンドで出力するかどうかを変更することができます。デフォルトではtrue(出力しない)が設定されています。
  ・ログを出力する場合

  otxadmin > set server.jms-service.logError=true

  ・ログを出力しない場合

  otxadmin > set server.jms-service.logError=false

8.2.6.8. wojmssv.pid / wojmsserver.pid

• 概要
  JMS サーバのプロセスID。
  
  • Windows：wojmssv.pid
  • UNIX系OS：wojmsserver.pid
  
  
• ログサイズ変更方法
  ログサイズは無制限です。ただし、出力内容はプロセスIDのみですので、実際に、サイズが無制限に増えることはありません。
  
  
• ローテーション設定方法
  JMSサーバが起動するタイミングでファイルを切り替えます。
  
  
• ログレベル変更方法
  ログレベルはありません。
  
  

8.2.6.9. wojmsexec.log

• 概要
  JMS サーバの起動、停止時の情報。
  JMS サーバの起動引数や、終了コードなどを出力します(Windowsのみ)。
  
  
• ログサイズ変更方法
  ログサイズは無制限です。ただし、出力内容は起動と停止の情報のみですので、実際に、サイズが無制限に増えることはありません。
  
  
• ローテーション設定方法
  JMS サーバが起動するタイミングでwojmsexec.log.bak にリネームし、一世代分のバックアップを行います。世代数は設定できません。
  
  
• ログレベル変更方法
  ログレベルはありません。
  
  

8.2.6.10. 出力形式について

運用管理操作履歴の出力形式

運用管理操作履歴の出力形式は以下のようになっています。

[タイムスタンプ] <メッセージID>: <メッセージ> [<結果>]

メッセージライフサイクルの出力形式

メッセージライフサイクルの出力形式は以下のようになっています。

[タイムスタンプ] <メッセージID> [<送信先名>] [<ライフサイクルイベント>] <プロデューサID>:<トランザクションID>

なお、メッセージ移動操作によりメッセージが移動した場合は、上記の情報に加え、次の形式で移動前と移動後の情報を出力します。

[タイムスタンプ] [MESSAGE:MOVE] [<移動元の送信先名>] <移動前のメッセージID> -> [<移動先の送信先名>] <移動後のメッセージID>

8.2.7. JNDI

8.2.7.1. webotx_jndisp.log

• 概要
  JNDIサービスに関するログ。
  
  
• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  モジュールログレベルの以下の属性を変更することでレベルが変わります。
  
  
  • JNDI Service

8.2.8. Object Broker

8.2.8.1. objava.log

• 概要
  WebOTX Object Broker Java の診断メッセージおよび通信データ(メッセージダンプ)を出力します。ただし、エラー 情報は常に出力します。
  
  
• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  
  • Object Broker Java Library
    診断メッセージのログレベルを設定します。
    
    • OFF - 診断メッセージを表示しません
    • ERROR - 通信エラーなど、エラーが起ったときに診断メッセージを表示します
    • WARN - エラーではないが警告的な意味合いを持つ状況が起ったときに診断メッセージを表示します
    • INFO, CONFIG - アプリケーションプログラムの動作情報を表示します
    • DEBUG, DETAIL, TRACE - 詳細な診断情報を表示します
  • Object Broker Java Message
    通信データ(メッセージダンプ)のログレベルを設定します。
    
    • OFF, ERROR, WARN, INFO, CONFIG - 通信データを採取しません
    • DEBUG - 通信データのヘッダのみ採取します
    • DETAIL, TRACE - 通信データ全てを採取します

8.2.8.2. webotx_ospi.log

• 概要
  WebOTX Object Broker に関するログ。
  
  
• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  モジュールログレベルの以下の属性を変更することでレベルが変わります。
  • Object Broker

8.2.8.3. ObLog.log

• 概要
  oad 、名前サーバ、IRサーバ、corbalocサーバおよびキャッシュ名前サーバ以外のAPが出力する。
  
  
• ログサイズ変更方法
  ログファイルのサイズは、デフォルトでは、10240KBです。以下のコマンドでファイルサイズを変更することができます。0を設定するとファイルサイズの上限がなくなります。

  otxadmin > set server.objectbrokerconfig.LogLimit=<サイズ(KB)>

  なお、LogLimitの値はObLog.log、oad.log、InterfaceRepository.log、corbaloc.log、namesv.log、cnamesv.log、message.logで共通となります。
  
  
• ローテーション設定方法
  上記コマンドで指定したファイルサイズを超えた場合、_old という拡張子をつけて1世代分待避されます。世代数は設定できません。
  
  
• ログレベル変更方法
  以下のコマンドでログレベルを設定することができます。既定値はERROR です。

  otxadmin > set server.objectbrokerconfig.LoggingLevel=<ログレベル>

  設定できるログレベルは以下になります。
  
  NONE , ERROR , WARNING , INFORMATION

8.2.8.4. oad.log

• 概要
  oad が出力するログ。内容はObLog.log と同じ。
  
  
• ログサイズ変更方法
  ログファイルのサイズは、デフォルトでは、10240KBです。以下のコマンドでファイルサイズを変更することができます。0を設定するとファイルサイズの上限がなくなります。

  otxadmin > set server.objectbrokerconfig.LogLimit=<サイズ(KB)>

  なお、LogLimitの値はObLog.log、oad.log、InterfaceRepository.log、corbaloc.log、namesv.log、cnamesv.log、message.logで共通となります。
  
  
• ローテーション設定方法
  上記コマンドで指定したファイルサイズを超えた場合、_old という拡張子をつけて1世代分待避されます。世代数は設定できません。
  
  
• ログレベル変更方法
  以下のコマンドでログレベルを設定することができます。既定値はNONE です。

  otxadmin > set server.objectbrokerservice.oad.OadLoggingLevel=<ログレベル>

  設定できるログレベルは以下になります。
  
  NONE , ERROR , WARNING , INFORMATION
  
  NONE が設定されているときはLoggingLevel の設定値を使用(既定値) されます。

8.2.8.5. InterfaceRepository.log

• 概要
  IR サーバが出力するログ。内容はObLog.log と同じ。
  
  
• ログサイズ変更方法
  ログファイルのサイズは、デフォルトでは、10240KBです。以下のコマンドでファイルサイズを変更することができます。0を設定するとファイルサイズの上限がなくなります。

  otxadmin > set server.objectbrokerconfig.LogLimit=<サイズ(KB)>

  なお、LogLimitの値はObLog.log、oad.log、InterfaceRepository.log、corbaloc.log、namesv.log、cnamesv.log、message.logで共通となります。
  
  
• ローテーション設定方法
  上記コマンドで指定したファイルサイズを超えた場合、_old という拡張子をつけて1世代分待避されます。世代数は設定できません。
  
  
• ログレベル変更方法
  以下のコマンドでログレベルを設定することができます。既定値はNONE です。

  otxadmin > set server.objectbrokerservice.irsv.InterfaceRepositoryLoggingLevel=< ログレベル>

  設定できるログレベルは以下になります。
  
  NONE , ERROR , WARNING , INFORMATION
  
  NONE が設定されているときはLoggingLevel の設定値を使用(既定値) されます。

8.2.8.6. corbaloc.log

• 概要
  corbaloc サーバが出力するログ。内容はObLog.log と同じ。
  
  
• ログサイズ変更方法
  ログファイルのサイズは、デフォルトでは、10240KBです。以下のコマンドでファイルサイズを変更することができます。0を設定するとファイルサイズの上限がなくなります。

  otxadmin > set server.objectbrokerconfig.LogLimit=<サイズ(KB)>

  なお、LogLimitの値はObLog.log、oad.log、InterfaceRepository.log、corbaloc.log、namesv.log、cnamesv.log、message.logで共通となります。
  
  
• ローテーション設定方法
  上記コマンドで指定したファイルサイズを超えた場合、_old という拡張子をつけて1世代分待避されます。世代数は設定できません。
  
  
• ログレベル変更方法
  以下のコマンドでログレベルを設定することができます。既定値はNONE です。

  otxadmin > set server.objectbrokerservice.corbaloc.CorbalocLoggingLevel=<ログレベル>

  設定できるログレベルは以下になります。
  
  NONE , ERROR , WARNING , INFORMATION
  
  NONE が設定されているときはLoggingLevel の設定値を使用(既定値) されます。

8.2.8.7. namesv.log

• 概要
  名前サーバが出力するログ。名前サーバのエラー情報とObLog.log と同じ内容が出力される。
  
  
• ログサイズ変更方法
  ログファイルのサイズは、デフォルトでは、10240KBです。以下のコマンドでファイルサイズを変更することができます。0を設定するとファイルサイズの上限がなくなります。

  otxadmin > set server.objectbrokerconfig.LogLimit=<サイズ(KB)>

  なお、LogLimitの値はObLog.log、oad.log、InterfaceRepository.log、corbaloc.log、namesv.log、cnamesv.log、message.logで共通となります。
  
  
• ローテーション設定方法
  上記コマンドで指定したファイルサイズを超えた場合、_old という拡張子をつけて1世代分待避されます。世代数は設定できません。
  
  
• ログレベル変更方法
  以下のコマンドでログレベルを設定することができます。既定値はNONE です。

  otxadmin > set server.objectbrokerservice.namesv.NameServiceLoggingLevel=<ログレベル>

  設定できるログレベルは以下になります。
  
  NONE , ERROR , WARNING , INFORMATION
  
  NONE が設定されているときはLoggingLevel の設定値を使用(既定値) されます。

8.2.8.8. cnamesv.log

• 概要
  キャッシュ名前サーバが出力するログ。キャッシュ名前サーバのエラー情報とObLog.log と同じ内容が出力される。
  
  
• ログサイズ変更方法
  ログファイルのサイズは、デフォルトでは、10240KBです。以下のコマンドでファイルサイズを変更することができます。0を設定するとファイルサイズの上限がなくなります。

  otxadmin > set server.objectbrokerconfig.LogLimit=<サイズ(KB)>

  なお、LogLimitの値はObLog.log、oad.log、InterfaceRepository.log、corbaloc.log、namesv.log、cnamesv.log、message.logで共通となります。
  
  
• ローテーション設定方法
  上記コマンドで指定したファイルサイズを超えた場合、_old という拡張子をつけて1世代分待避されます。世代数は設定できません。
  
  
• ログレベル変更方法
  以下のコマンドでログレベルを設定することができます。既定値はNONE です。

  otxadmin > set server.objectbrokerservice.cnamesv.CacheNameServiceLoggingLevel=< ログレベル>

  設定できるログレベルは以下になります。
  
  NONE , ERROR , WARNING , INFORMATION
  
  NONE が設定されているときはLoggingLevel の設定値を使用(既定値) されます。

8.2.8.9. message.log

• 概要
  通信毎に通信内容、通信相手、通信量を出力するログ。Object Broker ライブラリを使用する全APが出力。デフォルト設定では出力されません。
  
  
• ログサイズ変更方法
  ログファイルのサイズは、デフォルトでは、10240KBです。以下のコマンドでファイルサイズを変更することができます。0を設定するとファイルサイズの上限がなくなります。

  otxadmin > set server.objectbrokerconfig.LogLimit=<サイズ(KB)>

  なお、LogLimitの値はObLog.log、oad.log、InterfaceRepository.log、corbaloc.log、namesv.log、cnamesv.log、message.logで共通となります。
  
  
• ローテーション設定方法
  上記コマンドで指定したファイルサイズを超えた場合、_old という拡張子をつけて1世代分待避されます。世代数は設定できません。
  
  
• ログレベル変更方法
  ログレベルはありませんが、出力されるログの内容を変更することができます。
  ・ログを出力する場合

  otxadmin > server.objectbrokerconfig.MessagingLog=true

  ・通信内容をmessage.logに出力させる場合

  otxadmin > server.objectbrokerconfig.MessageBodyLog=true

8.2.8.10. syslog.log

• 概要
  syslog(UNIX系OSのみ)。デフォルトの設定ではログは出力されません。ただし、oad 、名前サーバ等のObject Broker サービスのデーモン類については、この設定にかかわらず、syslog に起動時と停止時のメッセージが常に出力されます。
  
  
• ログサイズ変更方法
  ログファイルのサイズは、デフォルトでは、10240KBです。以下のコマンドでファイルサイズを変更することができます。0を設定するとファイルサイズの上限がなくなります。

  otxadmin > set server.objectbrokerconfig.LogLimit=<サイズ(KB)>

  なお、LogLimitの値はObLog.log、oad.log、InterfaceRepository.log、corbaloc.log、namesv.log、cnamesv.log、message.logで共通となります。
  
  
• ローテーション設定方法
  上記コマンドで指定したファイルサイズを超えた場合、_old という拡張子をつけて1世代分待避されます。世代数は設定できません。
  
  
• ログレベル変更方法
  ログレベルはありませんが、出力されるログの内容を変更することができます。
  ・ログを出力する場合

  otxadmin > server.objectbrokerconfig.Syslog=true

  ・システム運用者向けのログを出力する場合

  otxadmin > server.objectbrokerconfig.SyslogForOperator=true

  ・アプリケーション開発者向けのログを出力する場合

  otxadmin > server.objectbrokerconfig.SyslogForDeveloper=true

  ・システム運用者向け、アプリケーション開発者向けの詳細情報があれば、追加で出力する場合

  otxadmin > server.objectbrokerconfig.SyslogDetail=true

8.2.8.11. oadj.log

• 概要
  OadJの運用時のログを出力。必要に応じてログファイルを作成。
  
  
• ログサイズ変更方法
  以下のコマンドでファイルサイズを変更することができます。デフォルトで100KB が設定されています。

  otxadmin > set server.objectbrokerservice.oadj.LogFileSize=<サイズ(KB)>

• ローテーション設定方法
  LogFileSize に設定されたファイルサイズを超えた場合、.bak という拡張子をつけて1世代分ログが待避されます。待避する世代数を変更することはできません。
  
  
• ログレベル変更方法
  以下のコマンドでログレベルを設定することができます。既定値はERROR です。

  otxadmin > set server.objectbrokerservice.oadj.LogLevel=<ログレベル>

  設定できるログレベルは以下になります。
  
  NO, ERROR, WARN, INFO, DEBUG

8.2.8.12. oadjinit.log

• 概要
  Object Broker Java 単体製品、もしくはドメイン外でObject Broker のサービスを起動した場合のoadj(java プロセス)の起動に関するログです。インストール時は存在しません。ドメイン外でサービスを起動した際に、ログファイルが作成され、情報が出力されます。oadj が起動されないような問題の解決に有効です。起動時の1 回のみ出力し、再起動の際には上書きするため、サイズが肥大することはありません。
  
  ログサイズやログレベルを変更することはできません。

8.2.11. TPシステム

8.2.11.1. webotx_tpmmgr.log

• 概要
  TP モニタマネージャにおけるTP モニタ連携マネージャに関するログ。運用アシスタント機能に関するログを出力。
  
  
• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  モジュールログレベルの以下の属性を変更することでレベルが変わります。
  • Admin assistant
  • Downloader Manager Service
  • TP Monitor Manager

8.2.11.2. ${PGNAME}.${PID}.log

• 概要
  サーバアプリケーションのトレースログ。サーバアプリケーションのトレース情報を出力。
  「トレースファイル名を固定する」を設定した場合は固定ID (${PGNAME}.${固定ID}.log)、しない場合はPID (${PGNAME}.${PID}.log) をログに付与します。
  どのプロセスIDがどの固定IDを利用しているかを確認する場合はアプリケーションのログファイル${PGNAME}_sys.${固定ID}.logの [ProcessGroup Information]ブロックに出力されるProcessID、TraceIDを参照することで確認できます。
  例)ProcessIDが1234で固定IDが1の場合
  

  　　[ProcessGroup Information]
  　　　ProcessID = 1234
  　　　TraceID = 1

• ログサイズ変更方法
  以下のコマンドでログサイズを変更することができます。デフォルト値は1024KB となっています。
  Javaアプリケーションの場合、Javaのネイティブが出力する標準出力、標準エラーもログ出力を行います。この出力はログ出力サイズにカウントします。
  例) JavaVMオプションの -verbose:gc 指定によるGCログは、Javaのネイディブが出力していますが、ログ出力サイズにカウントします。
  

  otxadmin > set tpsystem.applicationGroups.${APGNAME}.processGroups.${PGNAME}.traceFileMaxSize=<サイズ(KB)>

• ローテーション設定方法
  トレースファイルはトレースファイルの最大サイズに達すると、ファイル名に".bak" を付加してバックアップファイルを作成します。そして、新規にトレースファイルを作成します。1世代のみで古いbak ファイルは削除されます。プロセスグループが再起動した場合は、${TIME} が付加されsave ディレクトリに退避されます。退避後、保存期間を経過したログは自動で削除されます。
  保存期間は以下のコマンドで変更することができます。デフォルト値は30日となっています。

  otxadmin > set tpsystem.traceFilePreservationPeriod=<保存期間(日)>

• ログレベル変更方法
  

  otxadmin > set tpsystem.applicationGroups.${APGNAME}.processGroups.${PGNAME}.traceLevel=<レベル>

  設定できるレベルは以下になります。
    0 -  0. パニック状態
    1 -  1. 即時に訂正すべきである状態
    2 -  2. 危急の状態
    3 -  3. 一般的なエラー
    4 -  4. 警告メッセージ
    5 -  5. 通知メッセージ
    6 -  6. 情報メッセージ
    7 -  7. デバッグ時のメッセージ
   -1 -  -1. 採取しない
  
  Java EEプロセスグループとCORBA Javaプロセスグループでは以下の手順でログレベルの変更が可能です。
  （CORBA Javaプロセスグループはログレベルの動的変更をサポートしません。CORBA Javaプロセスグループでは、コマンド上で変更したログレベルを適用するにはアプリケーショングループの再起動が必要になります。）

  otxadmin > set tpsystem.applicationGroups.${APGNAME}.processGroups.${PGNAME}.<モジュールログレベル属性名>=<レベル>

  設定できるレベルは以下になります。
  

  表8.2.11.2-1

  レベル	説明
  OFF	全ての出力を行いません
  ERROR	ERRORレベル以上のメッセージを出力します。（V7以前ではSEVERE）
  WARN	WARNレベル以上のメッセージを出力します。（V7以前ではWARNING）
  INFO	INFOレベル以上のメッセージを出力します。
  CONFIG	CONFIGレベル以上のメッセージを出力します。
  DEBUG	DEBUGレベル以上のメッセージを出力します。（V7以前ではFINE）
  DETAIL	DETAILレベル以上のメッセージを出力します。（V7以前ではFINER）
  TRACE	TRACEレベル以上のメッセージを出力します。（V7以前ではFINEST）

  
  設定できるコンポーネントと属性名については以下のようになります。

  表8.2.11.2-2

  記号	説明
  ○	該当プロセスグループにて設定可能なモジュールログレベル
  −	該当プロセスグループでは設定不可能なモジュールログレベル

  表8.2.11.2-3

  カテゴリ名	属性名	Java EE	CORBA Java	概要
  Agent	AdminLogLevel	○	○	Adminモジュールのログレベル
  	ApacheCommonsLogLevel	○	−	Apache Commonsモジュールのログレベル
  	JNDIServiceLogLevel	○	−	JNDI Serviceモジュールのログレベル
  	SecurityLogLevel	○	−	Securityモジュールのログレベル
  	ServerCoreLogLevel	○	−	Server Coreモジュールのログレベル
  Web	CatalinaLogLevel	○	−	Catalinaモジュールのログレベル
  	HttpListenerLogLevel	○	−	Httpリスナモジュールのログレベル
  	JSPLogLevel	○	−	JSPモジュールのログレベル
  	WebContainerLogLevel	○	○	Webコンテナモジュールのログレベル
  EJB	EJBContainerLogLevel	○	○	EJBコンテナモジュールのログレベル
  JDBC	JDBCLogLevel	○	○	JDBCデータソースモジュールのログレベル
  	JDBCDriverLogLevel	○	−	JDBCドライバモジュールのログレベル
  Transactionサービス	JTALogLevel	○	○	JTAモジュールのログレベル
  JMS	JMSLogLevel	○	○	JMSモジュールのログレベル
  CORBA	ObjectBrokerJavaLibLogLevel	○	○	Object Broker Java Libraryモジュールのログレベル
  	ObjectBrokerJavaMsgLogLevel	○	○	Object Broker Java Messageモジュールのログレベル
  Web Service	WebServiceLogLevel	○	−	Web Serviceモジュールのログレベル
  JPA	JPALogLevel	○	−	JPAモジュールのログレベル
  DataGrid	WebotxCacheImplLogLevel	○	−	データグリッドモジュールのログレベル
  	CoherenceLogLevel	○	−	Coherenceのログレベル
  	InfinispanLogLevel	○	−	Infinispanのログレベル

8.2.11.3. ${PGNAME}_sys.${PID}.log

• 概要
  システムトレースファイル。プロセス起動時の情報やCORBA アプリケーションで検出したエラーの情報、Javaアプリケーションでスタック情報採取を行ったときに出力。
  「トレースファイル名を固定する」を設定した場合は固定ID (${PGNAME}_sys.${固定ID}.log)、しない場合はPID (${PGNAME}_sys.${PID}.log) をログに付与します。
  どのプロセスIDがどの固定IDを利用しているかを確認する場合はアプリケーションのログファイル${PGNAME}_sys.${固定ID}.logの [ProcessGroup Information]ブロックに出力されるProcessID、TraceIDを参照することで確認できます。
  例)ProcessIDが1234、固定IDが1の場合
  

  　　[ProcessGroup Information]
  　　　ProcessID = 1234
  　　　TraceID = 1

• ログサイズ変更方法
  以下のコマンドでログサイズを変更することができます。デフォルト値は1024KB となっています。
  Javaアプリケーションの場合、Javaのネイティブが出力する標準出力、標準エラーもログ出力を行います。この出力はログ出力サイズにカウントします。
  例) JavaVMオプションの -verbose:gc 指定によるGCログは、Javaのネイディブが出力していますが、ログ出力サイズにカウントします。
  

  otxadmin > set tpsystem.applicationGroups.${APGNAME}.processGroups.${PGNAME}.sysTraceFileMaxSize=<サイズ(KB)>

• ローテーション設定方法
  システムトレースファイルはログの最大サイズ(デフォルト1024KB)に達すると、ファイル名に".bak" を付加してバックアップファイルを作成します。そして、新規にトレースファイルを作成します。1世代のみで古いbak ファイルは削除されます。プロセスグループが再起動した場合は、${TIME} が付加されsave ディレクトリに退避されます。退避後、保存期間を経過したログは自動で削除されます。
  保存期間は以下のコマンドで変更することができます。デフォルト値は30日となっています。

  otxadmin > set tpsystem.traceFilePreservationPeriod=<保存期間(日)>

• ログレベル変更方法
  ログレベルの変更はできません。

8.2.11.4. ${PGNAME}_recovery.${PID}.log

• 概要
  リカバリプロセスのトレース情報を出力します。
  名前サーバへの登録方式を一時的としている場合、プロセス起動時に名前サーバにオブジェクトリファレンスを登録し、正常停止時に削除を行います。
  プロセスが異常終了した場合、削除処理が行われないため、リカバリプロセスを起動して、このオブジェクトリファレンスを削除します。
  そのため、オブジェクトリファレンスを名前サーバに永続的に登録している場合は、リカバリプロセスは不要となります。
  「トレースファイル名を固定する」を設定した場合は固定ID (${PGNAME}_recovery.${固定ID}.log)、しない場合はPID (${PGNAME}_recovery.${PID}.log) をログに付与します。
  どのプロセスIDがどの固定IDを利用しているかを確認する場合はアプリケーションのログファイル${PGNAME}_sys.${固定ID}.logの [ProcessGroup Information]ブロックに出力されるProcessID、TraceIDを参照することで確認できます。
  例)ProcessIDが1234、固定IDが1の場合
  

  　　[ProcessGroup Information]
  　　　ProcessID = 1234
  　　　TraceID = 1

• ログサイズ変更方法
  ファイルサイズ上限は1MB です。1MBを超える出力は通常ありません。
  
  
• ローテーション設定方法
  ローテーションできません。プロセスグループ停止時に${TIME} が付加されsave ディレクトリに退避されます。退避後、保存期間を経過したログは自動で削除されます。
  
  保存期間は以下のコマンドで変更することができます。デフォルト値は30日となっています。

  otxadmin > set tpsystem.traceFilePreservationPeriod=<保存期間(日)>

• ログレベル変更方法
  ログレベルの変更はできません。

8.2.11.5. ${APGNAME}_EXIT_sys.${PID}.log

• 概要
  アプリケーション初期プロセスのシステムトレースファイル。アプリケーション初期プロセスを使用する場合のみ、プロセス起動時の情報やエラーの情報が出力される。
  
  
• ログサイズ変更方法
  ファイルサイズ上限は1MBです。1MBを超える出力は通常ありません。
  
  
• ローテーション設定方法
  ローテーションできません。プロセスグループ停止時に${TIME} が付加されsave ディレクトリに退避されます。退避後、保存期間を経過したログは自動で削除されます。
  
  保存期間は以下のコマンドで変更することができます。デフォルト値は30日となっています。

  otxadmin > set tpsystem.traceFilePreservationPeriod=<保存期間(日)>

• ログレベル変更方法
  ログレベルの変更はできません。

8.2.11.6. ${SYSTEMNAME}_IIOPLsn.log${SYSTEMNAME}_A_IIOPLsn.log

• 概要
  IIOP リスナ内部トレースファイル。(振り分け部分)
  
  
• ログサイズ変更方法
  以下のコマンドでログサイズを変更することができます。デフォルト値は32KB となっています。
  

  otxadmin > set tpsystem.IIOPListener.iiopControlLogSize=<サイズ(KB)>

• ローテーション設定方法
  ログファイルのサイズが設定値( デフォルト32KB) を超えると新しいログファイルが作成されます。古いログファイルは< ログファイル名.bak>として保存されます。1世代のみバックアップされます。
  
  
• ログレベル変更方法
  ログレベルはありません。

8.2.11.7. iiopbase.log

• 概要
  IIOP リスナ内部トレースファイル。(通信管理部分)
  
  
• ログサイズ変更方法
  以下のコマンドでログサイズを変更することができます。デフォルト値は10240KB となっています。
  

  otxadmin > set tpsystem.IIOPListener.iiopManagementLogSize=<サイズ(KB)>

• ローテーション設定方法
  ログが指定したサイズに達したら、再帰出力を行います。
  
  
• ログレベル変更方法
  ログレベルはありません。

8.2.11.8. ${SYSTEMNAME}_AJPLsn.log

• 概要
  AJP リスナ内部トレースファイル。(振り分け部分)
  
  
• ログサイズ変更方法
  以下のコマンドでログサイズを変更することができます。デフォルト値は32KB となっています。
  

  otxadmin > set tpsystem.AJPListener.ajpControlLogSize=<サイズ(KB)>

• ローテーション設定方法
  ログファイルのサイズが設定値( デフォルト32KB) を超えると新しいログファイルが作成されます。古いログファイルは< ログファイル名.bak>として保存されます。1世代のみバックアップされます。
  
  
• ログレベル変更方法
  ログレベルはありません。

8.2.11.9. ajpbase.log

• 概要
  AJP リスナ内部トレースファイル。(通信管理部分)
  
  
• ログサイズ変更方法
  以下のコマンドでログサイズを変更することができます。デフォルト値は10240KB となっています。
  

  otxadmin > set tpsystem.AJPListener.ajpManagementLogSize=<サイズ(KB)>

• ローテーション設定方法
  ログが指定したサイズに達したら、再帰出力を行います。
  
  
• ログレベル変更方法
  ログレベルはありません。

8.2.11.10. access.ajp.log access_${YYYYMMDDhhmmss}.ajp.log

• 概要
  AJP リスナ アクセスログ
  
  
• ログサイズ変更方法
  以下のコマンドでログサイズを変更することができます。デフォルト値は10240KB となっています。
  ローテーション方式を1:ファイルサイズ単位で指定に指定している場合に有効です。
  

  otxadmin > set tpsystem.AJPListener.accesslogFileMaxSize=<サイズ(KB)>

• ローテーション設定方法
  アクセスログのローテーション方式は以下の2つから選ぶことができます。
  (1)ファイルサイズ単位で指定:
  指定した[最大ファイルサイズ](KB)に達すると、指定した[最大バックアップ数]までバックアップします。アクセスログのファイル名は、以下となります。
  ・ajplsn.access.log 出力中のカレントのファイル名
  ・ajplsn.access.log.<世代数> ローテーション後のファイル名(世代数が大きいほど古い)
  (2)実行する間隔を秒単位で指定:
  指定した[ローテーション間隔]で定期的にファイルをバックアップします。例えば、24時間ごとのローテーションにより、日単位でバックアップをとることができます。また、ローテーションの起点となる時刻を指定することができ、アクセスログのファイル名にはローテーションの開始日時が付与されます。アクセスログのファイル名は、以下となります。
  ・access_<YYYYMMDDhhmmss>.ajp.log
  以下のコマンドでローテーション方式を変更することができます。デフォルト値は[2:実行する間隔を秒単位で指定] となっています。
  

  otxadmin > set tpsystem.AJPListener.accesslogFileRotateType=<ローテーション方式>

  
  
• ログレベル変更方法
  ログレベルはありません。

8.2.11.11. ${SYSTEMNAME}_woejout_<number>.log ${SYSTEMNAME}_woejout_<generation>_<number>.log

• 概要
  イベントジャーナルの採取をユーザが実行した場合のみ作成されます。
  世代数を指定した場合、${SYSTEMNAME}_woejout_<generation>_<number>.logと作成されます。
  
  
• ログサイズ変更方法
  変更できません。
  
  
• ローテーション設定方法
  変更できません。
  
  
• ログレベル変更方法
  ログレベルはありません。

8.2.12. Transactionサービス

8.2.12.1. webotx_ts.log

• 概要
  WebOTX Transactionサービス に関するログ。
  
  
• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  モジュールログレベルの以下の属性を変更することでレベルが変わります。
  • Transaction Service

8.2.12.2. RCS.trc

• 概要
  Transactionサービス 関連のログ。Transaction 復旧用プロセス(RCS) のログ。
  
  
• ログサイズ変更方法
  以下のコマンドで変更することができます。デフォルト値は1024KB となっています。なお、
  以下の値は、RCS.trc、LRS.trc両方で使用されます。

  otxadmin > set server.transactionservice.trace-size=<サイズ(KB)>

• ローテーション設定方法
  最大サイズを超えると、常に上書きされます。バックアップを残すことはできません。
  
  
• ログレベル変更方法
  以下のコマンドで設定することができます。既定値は2です。

  otxadmin > set server.transactionservice.trace-level=<レベル>

  レベルは1(エラーレベル)〜5(デバッグレベル)が設定できます。

8.2.12.3. LRS.trc

• 概要
  Transactionサービス 関連のログ。AP 内でのTransaction 動作ログ。
  
  
• ログサイズ変更方法
  以下のコマンドで変更することができます。デフォルト値は1024KB となっています。なお、
  以下の値は、RCS.trc、LRS.trc両方で使用されます。

  otxadmin > set server.transactionservice.trace-size=<サイズ(KB)>

• ローテーション設定方法
  最大サイズを超えると、常に上書きされます。バックアップを残すことはできません。
  
  
• ログレベル変更方法
  以下のコマンドで設定することができます。既定値は2です。

  otxadmin > set server.transactionservice.trace-level=<レベル>

  レベルは1(エラーレベル)〜5(デバッグレベル)が設定できます。

8.2.12.4. webotx_ts_cpp.log

• 概要
  Transactionサービス 関連のログ。Transaction 復旧用プロセス(RCS(C++AP 用)) 。
  
  
• ログサイズ変更方法
  起動時と終了時のログのみで、大量に出力されることはありません。また、再起動時に上書きされるため、ログサイズを変更する必要はありません。
  
  
• ローテーション設定方法
  再起動時には上書きされるため、サイズが無尽蔵に増えることはありません。これよりローテーションを行う必要はありません。
  
  
• ログレベル変更方法
  ログレベルはありません。

8.2.14. Webコンテナ

8.2.14.1. webotx_catalina.log

• 概要
  Web コンテナの基盤部分の動作ログ。
  
  
• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  モジュールログレベルの以下の属性を変更することでレベルが変わります。
  • Catalina

8.2.14.2. webotx_webcont.log

• 概要
  Webコンテナと接続するドメインの基幹部分の動作ログ。
  
  
• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  モジュールログレベルの以下の属性を変更することでレベルが変わります。
  • Web Container

8.2.14.3. mod_jk-22.log/mod_jk-24.log

• 概要
  スタンダードモードで、WebOTX Web Server2.2/WebOTX Web Server2.4やApache HTTP Server2.2/Apache HTTP Server2.4と連携している時に、Webサーバに組み込んだプラグインモジュールの動作トレースや障害内容を出力。
  
  
• ログサイズ変更方法
  rotatelogs を利用した場合は任意に指定可能です。詳しくは[8.3.2.2. mod_jk のログのローテーション] を参照してください。
  
  
• ローテーション設定方法
  rotatelogs を利用した場合は任意に指定可能です。%d などで日付の利用可。省略時はマシン起動からの経過時間が付加されます。詳しくは[8.3.2.2. mod_jk のログのローテーション] を参照してください。
  
  
• ログレベル変更方法
  otxadmin コマンドで以下を実行して、Webサーバを再起動してください。
  

  otxadmin > set server.web-container.plugin-config.plugin-log-level=<ログレベル>

  ログレベルには以下のいずれかの値を指定できます。既定値はerrorです。
  error, warn, info, debug, trace

8.2.14.4. isapi.log

• 概要
  IIS と連携している時に、Web サーバに組み込んだプラグインモジュールの動作トレースや障害内容を出力。
  
  
• ログサイズ変更方法
  ログローテーションを行う場合にのみ変更可能です。
  
  
• ローテーション設定方法
  [8.3.7. IIS連携時のログローテーション] を参照してください。
  
  
• ログレベル変更方法
  otxadmin コマンドで以下を実行して、Webサーバを再起動してください。
  

  otxadmin > set server.web-container.plugin-config.plugin-log-level=<ログレベル>

  ログレベルには以下のいずれかの値を指定できます。既定値はerrorです。
  error, warn, info, debug, trace

8.2.14.5. mod_jk_om-22.log/mod_jk_om-24.log

• 概要
  アドバンスドモードでIIOPリスナを利用時に、WebOTX Web Server2.2/WebOTX Web Server2.4 や Apache HTTP Server2.2/Apache HTTP Server2.4 と連携している場合に出力されるログ。Web サーバに組み込んだプラグインモジュールの動作トレースや障害内容が出力。
  
  
• ログサイズ変更方法
  rotatelogs を利用した場合は任意に指定可能です。詳しくは[8.3.2.2. mod_jk のログのローテーション] を参照してください。
  
  
• ローテーション設定方法
  rotatelogs を利用した場合は任意に指定可能です。%d などで日付の利用可。省略時はマシン起動からの経過時間が付加されます。詳しくは[8.3.2.2. mod_jk のログのローテーション] を参照してください。
  
  
• ログレベル変更方法
  otxadmin コマンドで以下を実行して、Webサーバを再起動してください。
  

  otxadmin > set server.web-container.plugin-config.plugin-log-level=<ログレベル>

  ログレベルには以下のいずれかの値を指定できます。既定値はerrorです。
  error, warn, info, debug, trace

8.2.15. Webサーバ

8.2.15.1. webotx_websv.log

• 概要
  WebOTX Web サーバのライフサイクルに関するログ。
  
  
• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  モジュールログレベルの以下の属性を変更することでレベルが変わります。
  • Web Server

8.2.15.2. access_log(access.log)

• 概要
  ブラウザのアクセス情報を出力するアクセスログ。1 行で１リクエストに対応。
  
  
• ログサイズ変更方法
  rotatelogs を利用した場合は任意に指定可能です。詳しくは 7. WebOTXの内部サービス > 7.6. WebOTX Webサーバ > 7.6.4. 運用 > 7.6.4.6. アクセスログファイルのローテーションを参照してください。
  
  
• ローテーション設定方法
  rotatelogs を利用した場合は任意に指定可能です。%d などで日付の利用可。省略時はマシン起動からの経過時間が付加されます。詳しくは[4.2.1 Web サーバのログのローテーション] を参照してください。
  
  
• ログレベル変更方法
  ログレベルはありません。

8.2.15.3. error_log(error.log)

• 概要
  WebOTX Web サーバのエラー情報を出力するエラーログ。WebOTX Web サーバで発生したエラー情報等を出力。
  
  
• ログサイズ変更方法
  rotatelogs を利用した場合は任意に指定可能です。詳しくは 7. WebOTXの内部サービス > 7.6. WebOTX Webサーバ > 7.6.4. 運用 > 7.6.4.6. アクセスログファイルのローテーションを参照してください。
  
  
• ローテーション設定方法
  rotatelogs を利用した場合は任意に指定可能です。%d などで日付の利用可。省略時はマシン起動からの経過時間が付加されます。詳しくは[4.2.1 Web サーバのログのローテーション] を参照してください。
  
  
• ログレベル変更方法
  ${INSTANCE_ROOT}/config/WebServer/httpd.confの以下の定義を編集し、Webサーバを再起動してください。
  LogLevel < レベル>
  レベルには以下のいずれかの値を指定できます。既定値はwarn です。
  debug, info, notice, warn, error, crit,alert, emerg

8.2.15.4. ssl_request_log(ssl_request.log)

• 概要
  HTTPS 通信時のブラウザのアクセス情報と、SSL プロトコルのバージョンと暗号化アルゴリズムの情報を出力するアクセスログ。1 行で１リクエストに対応。
  
  
• ログサイズ変更方法
  rotatelogs を利用した場合は任意に指定可能です。詳しくは 7. WebOTXの内部サービス > 7.6. WebOTX Webサーバ > 7.6.4. 運用 > 7.6.4.6. アクセスログファイルのローテーションを参照してください。
  
  
• ローテーション設定方法
  rotatelogs を利用した場合は任意に指定可能です。%d などで日付の利用可。省略時はマシン起動からの経過時間が付加されます。詳しくは[4.2.1 Web サーバのログのローテーション]を参照してください。
  
  
• ログレベル変更方法
  ログレベルはありません。

8.2.15.5. server_access.log

• 概要
  Web コンテナのアクセスログ。リクエストの状況や結果が記録される。
  
  
• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  ${INSTANCE_ROOT}/config/log4otx.xml の以下のlogger のレベルを編集し、ドメインを再起動してください。
  • __otxadmin

8.2.16. Webサービス

8.2.16.1. webservice.log

• 概要
  WebOTX Web サービスに関するログ。
  
  
• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  モジュールログレベルの以下の属性を変更することでレベルが変わります。
  • Web Service

8.2.17. Working Domain Coordinator

8.2.17.1. wowdc.log

• 概要
  WebOTX Working Domain Coordinator に関するログ。
  Working Domain Coordinator は本バージョンで未サポートとなりました。
  

8.2.18. Enterprise Service Bus

8.2.18.1. webotx_esb.log

• 概要
  WebOTX Enterprise Service Bus に関するログ。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  モジュールログレベルのESBタブから各コンポーネントの属性を変更することでレベルが変わります。

8.2.19. Portal

8.2.19.1. portal_common_framework.log

• 概要
  WebOTX Portal の動作ログ。WebOTX Portal 内部の動作やエラー発生時の障害解析およびデバッグ情報が記録されるログです。
  
  
• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  モジュールログレベルのPortalタブから各コンポーネントの属性を変更することでレベルが変わります。

8.2.19.2. portal_builtin_portlet.log

• 概要
  WebOTX Portal の同梱ポートレットのログ。
  
  
• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  モジュールログレベルのPortalタブから各コンポーネントの属性を変更することでレベルが変わります。

8.2.19.3. portal_access.log

• 概要
  WebOTX Portal のアクセスログ。ポータル利用者がポータルサーバに対してログインやログアウト、ページの移動やページの変更等の操作を行ったときに記録されるログです。
  アドバンスドモードでインストールした場合は、ファイル名が portal_access_${PID}.log (${PID} はプロセスID) になり、プロセスごとにファイルが出力されます。
  
  
• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  モジュールログレベルのPortalタブから各コンポーネントの属性を変更することでレベルが変わります。

8.2.19.4. portal_trace.log

• 概要
  WebOTX Portal トレースログ。WebOTX Portal 内の各メソッドの呼び出し/復帰のタイミングで呼び出されたメソッドの名前や呼び出し時の引数、戻り値が記録されるログです(*1)。
  

  (*1) トレースログの出力は性能劣化が大きいため、障害解析時以外は出力OFFにして下さい。なお、既定でOFFになっています。

• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  モジュールログレベルのPortalタブから各コンポーネントの属性を変更することでレベルが変わります。

8.2.19.5. portal_common_service.log

• 概要
  WebOTX Portal の共通サービスのログ。
  
  
• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  モジュールログレベルのPortalタブから各コンポーネントの属性を変更することでレベルが変わります。

8.2.19.6. Portalに関するその他のログ

• 概要
  WebOTX Portalでは内部管理用として以下のファイルを出力します。
  これらのログは上記と異なり、[ 8.3. その他 > 8.3.5. ログの設定方法 ] による設定変更ができません。
  
  
  • jetspeed.log
  • portal.log
  • portal_error.log
  • portal_statistics.log
  • portal-diagnostics.log
  • portal-digester.log
  • portal-pluto.log
  • portal-velocity.log
  • menu_access.log
  • security.log

8.2.20. 分散管理サーバ

8.2.20.1. admin_access.log

• 概要
  分散管理サーバ の運用操作履歴ログ。
  
  
• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  モジュールログレベルの以下の属性を変更することでレベルが変わります。
  • Access for domain groups

8.2.20.2. admin_event.log

• 概要
  分散管理サーバ のイベント通知ログ。
  
  
• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  モジュールログレベルの以下の属性を変更することでレベルが変わります。
  • Event for domain groups

8.2.20.3. ddeployment.log

• 概要
  分散配備の履歴ログ。
  分散配備は本バージョンで未サポートとなりました。
  
  

8.2.21. rcスクリプトのログ (UNIX系OSのみ)

8.2.21.1. WOAgentSvc.log

• 概要
  WOAgentSvc実行時の標準出力、及び標準エラー出力ログ
  
  
• 出力設定
  環境変数 AS_NO_SERVICELOG を指定した場合、ログ出力を行いません。ログ出力を行う場合、環境変数を削除してください。
  
  既定では環境変数 AS_NO_SERVICELOG は存在しません。

  # export AS_NO_SERVICELOG=TRUE

  
  
• ログサイズ変更方法
  環境変数 AS_SERVICELOG_SIZE を指定することでログサイズを変更することが可能です。
  
  既定値は2000です。単位はブロックサイズ(512byte)になります。

  # export AS_SERVICELOG_SIZE=2000

  
  
• ログ出力先の変更方法
  ログ出力ディレクトリを変更する場合、環境変数 AS_SERVICELOG_PATH を設定し、ログファイル名を変更する場合、AS_SERVICELOG_NAMEを指定することで、出力先を変更可能です。
  
  AS_SERVICELOG_PATHの既定値は/opt/WebOTX/logs、AS_SERVICELOG_NAMEの既定値は WOAgentSvc.logになります。

  # export AS_SERVICELOG_PATH=/opt/WebOTX/logs
  # export AS_SERVICELOG_NAME=WOAgentSvc.log

  
  
• 設定ファイルによる指定
  環境変数以外に、下記のように設定ファイルを配置することでログファイルに対する設定を反映することが可能です。
  
  ${INSTALL_ROOT}/config/woasinfo.conf

  export AS_SERVICELOG_SIZE=2000
  export AS_SERVICELOG_PATH=/opt/WebOTX/logs
  export AS_SERVICELOG_NAME=WOAgentSvc.log

  このとき、woasinfo.confファイルは実行権限が必要となります。

8.2.22. WebOTX AS Agent Service のログ (Windowsのみ)

8.2.22.1. WOAgentSvc_start.log/WOAgentSvc_stop.log

• 概要
  WebOTX AS Agent Service起動/停止時の標準出力、及び標準エラー出力ログ
  
  
• 出力設定
  既定ではログを出力します。ログ出力を停止したい場合は、次の手順を実行してください。
  
  
  1. <WebOTXインストールディレクトリ>\bin\WOAgentSvc.batをエディタで開きます。
  2. 16行目あたりの「set AS_NO_SERVICELOG=false」という記述を、「set AS_NO_SERVICELOG=true」に変更します。
  
  
• ログサイズ変更方法
  既定値は1M(1048576)です。次の手順により変更できます。
  
  
  1. <WebOTXインストールディレクトリ>\bin\WOAgentSvc.batをエディタで開きます。
  2. 15行目あたりの「set AS_SERVICELOG_SIZE=1048576」という記述を、「set AS_SERVICELOG_SIZE=<設定したいサイズ(バイト)>」に変更します。
  
  
• ローテーション設定方法
  指定されたログサイズを超えた場合、.oldという拡張子をつけて1世代分退避されます。世代数は変更できません。

8.2.23. JPA

8.2.23.1. webotx_jpa.log

• 概要
  JPA モジュールに関するログ。
  
  
• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  モジュールログレベルの以下の属性を変更することでレベルが変わります。
  • JPA

8.2.24. DataGrid

8.2.24. webotx_datagrid.log

• 概要
  Data Grid モジュールに関するログ。
  
  
• ログサイズ変更方法
  変更方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログファイルの最大サイズの変更」を参照してください。
  
  
• ローテーション設定方法
  設定方法とデフォルト値は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログの世代数の変更」を参照してください。
  
  
• ログレベル変更方法
  変更方法は[ 8.3. その他 > 8.3.5. ログの設定方法 ]にて記載している「ログレベルの変更」を参照してください。
  モジュールログレベルの以下の属性を変更することでレベルが変わります。
  • Webotx Cache Implementation
  • Coherence
  • Infinispan

8.3. その他

8.3.1. 連続運用時のディスクフルについて

WebOTXでは多くのログファイルについて、既定でファイルサイズによるローテーションの設定を行っています。
しかし、長期間連続運用を行っている環境やディスク容量に合ったローテーションサイズのチューニングが行われていない環境の場合、 ログファイルの容量増加に伴いディスクフルが発生する危険があります。ご利用になるシステムのディスク要件に合わせたチューニングを行ってください。
以下では、既定でローテーションの設定を行っておらず、ディスクフルの危険性があるログファイルについて表にまとめています。

8.3.2. rotatelogsを利用したログローテーション

8.3.2.1. Webサーバのログのログローテーション

Webサーバが出力するログのローテーション方法については、マニュアルの以下の章を参照してください。

• ドメイン構築・基本設定ガイド > 7. WebOTXの内部サービス > 7.6. WebOTX Webサーバ > 7.6.4. 運用 > 7.6.4.6. アクセスログファイルのローテーション

8.3.2.2. mod_jkのログのローテーション

WebサーバとWebコンテナとの連携モジュールであるmod_jkが出力するログファイルのローテーション方法について説明します。

はじめに、mod_jkの設定ファイル名について説明します。mod_jkの設定ファイルは使用するWebサーバとWebOTXの動作モードによって以下のように変わります。設定ファイルは${INSTANCE_ROOT}/config/WebCont以下にあります。

WebOTX 統合運用管理ツールや運用管理コマンドからmod_jkのログのローテーションの設定を行うことができます。この場合、手動で参照する設定ファイルを変更する必要はありません。ただし、WebサーバとWebコンテナが別マシン構成の環境では、以下の条件を満たしていない場合、統合運用管理ツールや運用管理コマンドから設定を行えないため、手動で設定を行う必要があります。

• Webサーバの入っているマシンにWebOTXがインストールされている
• 両方のマシンに入っているWebOTXのWebコンテナの動作モードが同じ

本手順を行うと、mod_jk_om-22.log.<数字>というファイル名でログが出力されます。数字が小さいものは過去ログとなりますので、削除することができます。

Web版統合運用管理コンソールでの設定方法

コマンドでの設定方法

• ローテーションの有効化

  ローテーションを有効化するには以下のコマンドを実行してください。

  otxadmin > set server.web-container.plugin-config.log-rotate-enable=true

• ローテート時間の指定

  ログをローテートする間隔を秒単位で指定します。デフォルトは 86400 秒(1日)です。
  

  otxadmin > set server.web-container.plugin-config.log-rotate-interval=86400

  また、末尾に"M"を指定することでファイルサイズ（メガバイト単位）でのローテーションも可能です。以下は10MB単位でローテーションされる場合の設定です。

  otxadmin > set server.web-container.plugin-config.log-rotate-interval=10M

手動での設定方法

ここではWebOTXインストールするフォルダは既定値(C:/WebOTX)、ドメイン名はdomain1、WebOTX Webサーバ2.2とアドバンスドモードの組み合わせを例に手順を説明いたします。組み合わせがことなる場合も手順は同じですので、ファイル名、パス名を適宜読み替えてください。

以下の手順を、ドメインが停止した状態で行ってください。

1. mod_jk設定ファイルのリネーム
   
   mod_jk_om-22.conf-autoをコピーし、mod_jk_om-22.conf-loadを作成します。
   
   
2. mod_jk_om-22.conf-loadの編集
   
   以下の例では、一日(86400秒)ごとにローテーションさせます。適宜数値は変更してください。また、ファイルサイズでローテーションさせる場合は、数値の後にMをつけることで実現することができます。
   例えば、10MB単位にローテーションさせる場合は10Mと記述します。
   
   • Windowsの場合
     
     ・変更前
     JkLogFile "C:/WebOTX/domains/domain1/logs/web/mod_jk_om-22.log"
     
     ・変更後
     JkLogFile "||C:/WebOTX/WebServer22/bin/rotatelogs.exe  C:/WebOTX/domains/domain1/logs/web/mod_jk_om-22.log 86400"
     
     
   • UNIX系OSの場合
     
     ・変更前
     JkLogFile "/opt/WebOTX/domains/domain1/logs/web/mod_jk_om-22.log"
     
     ・変更後
     JkLogFile "||/opt/WebOTX/WebServer22/bin/rotatelogs /opt/WebOTX/domains/domain1/logs/web/mod_jk_om-22.log 86400"
   
   
3. httpd.confの編集
   
   ${INSTANCE_ROOT}/config/WebServer/httpd.confを編集し、2で作成したmod_jk_om-22.conf-loadを読み込むように編集します。
   
   • Windowsの場合
     
     ・変更前
     include "C:/WebOTX/domains/domain1/config/WebCont/mod_jk_om-22.conf-auto"
     
     ・変更後
     include "C:/WebOTX/domains/domain1/config/WebCont/mod_jk_om-22.conf-load"
     
     
   • UNIX系OSの場合
     
     ・変更前
     include "/opt/WebOTX/domains/domain1/config/WebCont/mod_jk_om-22.conf-auto"
     
     ・変更後
     include "/opt/WebOTX/domains/domain1/config/WebCont/mod_jk_om-22.conf-load"
   
   

8.3.3. Standard/Enterprise上のアプリケーションのログ出力

Standard/Enterpriseにおけるサーバアプリケーションに関するログについて説明します。サーバアプリケーションの動作に問題がある場合に参照すべきログについて説明します。

WebOTXにはシステムやプロセスの稼動状況を示すために様々なトレースファイルが存在します。 何か異常が起こったときは以下に説明するファイルを参照してください。

この表の上位4つのファイルで、ほとんどの場合に対処可能です。トレースレベルを最大にすると通常運用に支障が出る場合もあります。最大よりは１ないし２つほど下げて運用してください。デバッグ時は常に最大にしてください。これらのファイルについてはファイルの読み方とエラー番号一覧 (別のセクションにあるものもあります)を示します。

また、下位2つは上位4つでも判らない時に採取するログです。通常運用には耐えられないほどのログが出ますので、デバッグ時や開発元からの依頼があった時のみ採取願います。下位 2つのファイルに関しては採取方法のみ示します。

8.3.3.1. サーバアプリケーショントレース採取

サーバアプリケーションのログについて説明します。

8.3.3.2. トレースの読み方(Java)

サーバアプリケーションログは以下のような形式になっています。

yyyy 西暦 mm 月 dd 日

HH 時(00〜23) MM 分(00〜59) SS 秒(00〜59) sss ミリ秒

xxxxxxxx:エラーID(無い場合もあります) TTT:論理スレッド番号 メッセージ:メッセージ本文

WebOTXのサーバアプリケーションが出力するログの中にErrorが出力される場合は何か異常が起きています。主に初期化時にエラーが出るため、ここでは初期化時に発生しうるエラー一覧を載せますが、他のエラーが出ている場合は開発元に連絡してください。

8.3.3.3. トレースの読み方(C++)

サーバアプリケーションログは以下のような形式になっています。

yyyy 西暦 mm 月 dd 日

HH 時(00〜23) MM 分(00〜59) SS 秒(00〜59) sss ミリ秒

xxxxxxxx:エラーID(無い場合もあります) TTT:論理スレッド番号 メッセージ:メッセージ本文

WebOTXのサーバアプリケーションが出力するログの中にErrorが出力される場合は何か異常が起きています。主に初期化時にエラーが出ることが多いため、ここでは初期化時に発生するエラー一覧を載せますが、他のエラーが出ている場合は開発元に連絡してください。

8.3.3.4. サーバアプリケーション内部トレースの採取方法

サーバアプリケーショントレース(Java)および サーバアプリケーショントレース(C++)では主にオブジェクト管理部分のトレースを出力します。

これより低レベルの情報(スレッド管理、メッセージ管理、プロセス監視など)を表示する方法があります。かなりの量のトレースを出力するため、プロセスが起動しないときや、明らかに動作がおかしいとき、開発元に調査依頼を行う時などのみ採取すべきです。

以下にサーバアプリケーション内部トレースの採取方法を示します。

• 統合運用管理ツールでプロセスグループを選択します。
  
  
• [コマンドライン引数]タブを選択して、以下のように入力します。
  
  -OltpTplibTrace
  
  
• 次に、${INSTANCE_ROOT}/config/tpsystem/プロセスグループ名.ped (環境定義ファイル)をnotepadやviなどのエディタで開きます。
  
  
• 先ほど統合運用管理ツールで入力した-OltpTplibTraceを探してください(ARGS -OltpTplibTraceという行があるはずです)。この行の次に以下の二行を追加してください。この例では、に内部トレースを出力するため設定です。WindowsではC:\temp\servertrc.txt などに置き換えてください。
  
  OUTPUTDEV /tmp/servertrc.txt
  ERRORDEV /tmp/servertrc.txt

この設定により、内部ログの初めの部分が/tmp/servertrc.txtに出力され、続きがサーバアプリケーショントレースに出力されます。ファイルに情報が出力されていることを確認し、開発元に送付してください。

ファイルの採取が終わりましたら、環境定義ファイルを元に戻してください。コマンドライン引数の-OltpTplibTraceも削除してください。

8.3.3.5. IIOPリスナ内部トレースの採取方法

IIOPリスナは普段はクライアントからの要求を適切なサーバアプリケーションに振り分ける処理を行います。もし、クライアントからの通信が行えなかったり、サーバアプリケーションに正しく要求が届かなかったりする場合は、IIOPリスナのトレースを採取して開発元に送付してください。

この設定は大量のトレースを出力し、性能に影響を及ぼすため、通常時は採取しないようにしてください。

IIOPリスナは二つのトレースファイルから構成されます。一つは通信管理部分で、もう一つは振り分け部分になります。

通信管理部分のトレース

以下のコマンドでログを出力することができます。

otxadmin > set tpsystem.IIOPListener.collectIiopManagementLog=true

このログは開発環境での障害発生時に採取を依頼する場合があります。通常の運用ではユーザは意識する必要はありません。

振り分け部分のトレース

以下のコマンドでログを出力することができます。

otxadmin > set tpsystem.IIOPListener.collectIiopControlLog=true

このログは障害発生時に採取を依頼する場合があります。通常の運用ではユーザは意識する必要はありません。
ログファイルのサイズが32KBを超えると新しいログファイルが作成されます。古いログファイルは<ログファイル名.bak>として保存されます。ログは2世代で、世代数の変更はできません。

以上の設定を行い、該当するTPシステムを再起動してください。上記ファイルにファイルに情報が出力されていることを確認し、開発元に送付してください。

ファイルの採取が完了した後は、上記の変更を全て元に戻してください。

8.3.3.6. AJPリスナ内部トレースの採取方法

AJPリスナは普段はWebサーバからの要求を適切なサーバアプリケーションに振り分ける処理を行います。もし、Webサーバからの通信が行えなかったり、サーバアプリケーションに正しく要求が届かなかったりする場合は、AJPリスナのトレースを採取して開発元に送付してください。

この設定は大量のトレースを出力し、性能に影響を及ぼすため、通常時は採取しないようにしてください。

AJPリスナは二つのトレースファイルから構成されます。一つは通信管理部分で、もう一つは振り分け部分になります。

通信管理部分のトレース

以下のコマンドでログを出力することができます。

otxadmin > set tpsystem.AJPListener.collectAjpManagementLog=true

このログは開発環境での障害発生時に採取を依頼する場合があります。通常の運用ではユーザは意識する必要はありません。

振り分け部分のトレース

以下のコマンドでログを出力することができます。

otxadmin > set tpsystem.AJPListener.collectAjpControlLog=true

このログは障害発生時に採取を依頼する場合があります。通常の運用ではユーザは意識する必要はありません。
ログファイルのサイズが32KBを超えると新しいログファイルが作成されます。古いログファイルは<ログファイル名.bak>として保存されます。ログは2世代で、世代数の変更はできません。

以上の設定を行い、該当するTPシステムを再起動してください。上記ファイルにファイルに情報が出力されていることを確認し、開発元に送付してください。

ファイルの採取が完了した後は、上記の変更を全て元に戻してください。

8.3.4. 業務アプリケーションがLog4Jを利用する場合の注意点

WebOTX上で動作するJavaアプリケーションにおいて、Log4Jを利用する場合の注意点について説明します。

8.3.4.1. アドバンスドモードで業務アプリケーションのログ出力を行う場合

Standard、Enterpriseをアドバンスドモードで動作させる場合のWebアプリケーションのログ出力の手順について説明します。
アドバンスドモードで実行する場合、WebAPはプロセスグループ上で動作します。プロセスグループは、多重度を設定することができるため、ファイルにログ出力を行う場合、複数のプロセスが同じファイルに書き込みを行い、メッセージの欠損やローテート失敗によるメッセージの全損等の問題が発生する可能性があります。そのため、以下のいずれかの手順で問題を回避する必要があります。

Webアプリケーションのログをプロセスグループのログに出力する場合

アプリケーションのログをプロセスグループのログに出力するには、標準出力を利用します。プロセスグループ上で標準出力を行うと、プロセスグループのログファイルに出力されます。ログファイルは以下に出力されます。
${INSTANCE_ROOT}/logs/tpsystem/${APGNAME}/${PGNAME}/${PGNAME}.${PID}.log

Webアプリケーションのログを個別のファイルに出力する場合

Webアプリケーションのログを個別のファイルに出力する場合、出力するログファイル名に、Webアプリケーションが動作するプロセスのプロセスIDを付与することで、多重度を設定した場合でもプロセス単位にログを出力することができます。

(注意) ログ定義ファイルについて
プロセスグループ上でWebAPを動作させる場合、Webアプリケーションが利用するログ定義ファイルを、同一プロセスグループ上に配備されたアプリケーションごとに分けて利用することはできません。プロセスグループで同一のLog4J定義ファイルを使用してください。

8.3.4.2. Log4Jで利用できるJavaシステムプロパティ

Standard、Enterpriseを利用している場合は、次のJavaシステムプロパティが利用できます。

これらのJavaシステムプロパティをLog4Jのプロパティに指定することにより、プロセスIDの取得等が可能になります。

（注意） 上記のJavaシステムプロパティに指定する値は変更できません。変更した場合の動作は保証できません。

（*1） 本プロパティはプロセスグループ作成時にCORBAシステムを選択された場合、そのプロセスグループ上では使用できません。

8.3.5. ログの設定方法

エージェントプロセス内で動作するコンポーネントはコンポーネント単位にログレベルを設定することが可能です。ログレベルの変更はエージェントが起動中でも反映することができます。これらの設定は、統合運用管理ツールから変更が可能です。

タブ毎に以下のコンポーネント毎のログレベル設定が可能です。

ログレベルの変更

• 統合運用管理ツールからログレベルを変更する場合

  統合運用管理ツールから以下の手順で変更を行います。

  1. 統合運用管理ツールを起動しドメインと接続します。
  2. 管理ツリーより、WebOTXAdmin→<ドメイン名>→アプリケーションサーバ→ログサービス→モジュールログレベルを選択します。
  3. 各コンポーネントのログレベルを変更し更新ボタンにより設定を反映させます。
     
     
     
• 運用管理コマンドからログレベルを変更する場合

  運用管理コマンドを起動しsetコマンドによりログレベルを変更します。例えば以下のようなコマンドになります。

  otxadmin> get server.log-service.module-log-levels.*

     (現在のログレベル設定内容が表示されます。)

  otxadmin> set server.log-service.module-log-levels.admin=DEBUG

  server.log-service.module-log-levels.admin = DEBUG

なお、ログレベルに設定する値を以下に示します。

JavaEEプロセスグループのログレベルの一括変更

Standard/Enterpriseエディションをご利用の場合、Java EE プロセスグループのログレベルをアプリケーショングループ単位で一括変更することができます。設定方法は以下のとおりです。

• 統合運用管理ツールから変更する場合

  統合運用管理ツールから対象のアプリケーショングループを選択し、以下のオペレーションを実行してください。

  
  図8.3.5-1

  対象のモジュールのログレベルを変更し、「実行」を押してください。モジュール項目はカテゴリ別にタブで分類されているので、タブを切り替えてモジュールごとにログレベルを選択します。ただし、変更の必要がないモジュールは「No Change」が選択されている状態にしてください。

  
  図8.3.5-2

• 運用管理コマンドから変更する場合

  運用管理コマンドを起動しinvokeコマンドによりログレベルを変更します。

  otxadmin> invoke tpsystem.applicationGroups.<アプリケーショングループ名>.changeModuleLogLevels <モジュールログレベル名>=<ログレベル>

   複数のログレベルを変更する場合は以下のようなコマンドになります。

  otxadmin> invoke tpsystem.applicationGroups.<アプリケーショングループ名>.changeModuleLogLevels <モジュールログレベル名>=<ログレベル>,<モジュールログレベル名>=<ログレベル>,<モジュールログレベル名>=<ログレベル>

ログファイルの最大サイズの変更

• 運用管理ツールから行う場合

  統合運用管理ツールから以下の手順で変更を行います。

  1. 統合運用管理ツールを起動しドメインと接続します。
  2. WebOTXAdmin→<ドメイン名>→アプリケーションサーバ→ログサービス→ログファイル構成をクリックし、「ファイルサイズ」タブを選択します。
  3. 変更するファイルのファイルサイズを入力し、更新ボタンを押してください

  ファイルサイズに使用できる単位は、単位なし(バイト)、KB(キロバイト)、MB(メガバイト)、GB(ギガバイト)のいずれかになります。

• 運用管理コマンドから行う場合

  otxadmin > login --user admin --password adminadmin --host localhost --port 6212

  otxadmin > set server.log-service.log-file-config.<属性名>=<ログサイズ>

設定の変更を反映するためには、ドメインの再起動が必要になります。

属性名と運用管理ツール表示、ファイル名の対応は以下の表になります。

ログの世代数の変更

• 運用管理ツールから行う場合

  統合運用管理ツールから以下の手順で変更を行います。

  1. 統合運用管理ツールを起動しドメインと接続します。
  2. WebOTXAdmin→<ドメイン名>→アプリケーションサーバ→ログサービス→ログファイル構成をクリックし、「世代数」タブを選択します。
  3. 変更するファイルの世代数を入力し、更新ボタンを押してください

  世代数には0以上の整数を入力してください。

• 運用管理コマンドから行う場合

  otxadmin > login --user admin --password adminadmin --host localhost --port 6212

  otxadmin > set server.log-service.log-file-config.<属性名>=<世代数>

設定の変更を反映するためには、ドメインの再起動が必要になります。

属性名と運用管理ツール表示、ファイル名の対応は以下の表になります。

ロガー名称

WebOTXがデフォルトで設定しているロガーの名称について説明します。コンポーネント別に独自のファイルアペンダを用意しています。

アペンダ

WebOTXがデフォルトで設定しているアペンダについて説明します。

CONSLOG

コンソールに出力するためのアペンダです。通常は使用しません。

(※) レイアウトパターンの%X{module}はWebOTX内部コンポーネントのモジュール名に置換されます。

EVENTLOG(Windows環境のみ有効)

イベントログに出力するためのアペンダです。EVENTLOGアペンダに付いてはSLOGINFOレベル以上のメッセージしか出力されません。

(※) レイアウトパターンの%X{module}はWebOTX内部コンポーネントのモジュール名に、%X{domain}はドメイン名に置換されます。

SYSLOG(UNIX系OS環境のみ有効)

syslogに出力するためのアペンダです。SYSLOGアペンダに付いてはSLOGINFOレベル以上のメッセージしか出力されません。
なおアペンダSYSLOGはネットワークを経由してsyslogに出力しているため、Linux環境においてはsyslog出力を有効にするためにはsyslogdに’-r’オプションをつけてください。’-r’オプションがないと出力されません。出力先はデフォルトでlocalhostです。変更するにはSyslogHostを変更してください。

(※) レイアウトパターンの%X{module}はWebOTX内部コンポーネントのモジュール名に、%X{domain}はドメイン名に置換されます。

NOTIFICATIONLOG

重要ログメッセージをJMX Notificationとして通知を行なうためのアペンダです。この通知は統合運用管理ツールのイベントビューに表示されます。SYSLOGアペンダに付いてはSLOGINFOレベル以上のメッセージしか出力されません。

XXXXFILELOG

ログファイルに出力するためのアペンダです。

(※) レイアウトパターンの%X{module}はWebOTX内部コンポーネントのモジュール名に置換されます。

JMXREMOTEACCESSLOG

リモートアクセスログを出力するためのアペンダです。この通知は${INSTANCE_ROOT}/logs/にagent_operation.logとして出力されます。

(※) レイアウトパターンの%X{module}はWebOTX内部コンポーネントのモジュール名に置換されます。

各アペンダに対応するファイル名一覧

ログレベル

各アペンダにて出力レベルを変更することが可能ですが設定できるログレベルについて説明します。

thresholdの設定には次のレベルを指定することができ、イベントログ、syslogとのマッピングも次のとおりです。なおイベントログ、syslogにはSLOGINFO以上の情報しか出力しませんのでthresholdにはSLOGINFO以上を指定するようにしてください。

補足：(*)の付いたレベルはWebOTX独自のレベルです。

Log4Jについては ”com.nec.webotx.logging.OTXLogLevel” クラスで拡張

8.3.6. 運用操作履歴ログ

運用操作履歴ログでは、ユーザ接続情報ログと操作詳細ログの２つをagent_operation.logに出力します。
以下にログレベルごとの出力内容の概要、各々の説明とログフォーマットを記します。

ログレベル別出力内容

ユーザ接続情報ログ (ログレベルINFO)

ユーザからの接続要求に対する結果を表示します。
ユーザ接続情報ログは以下のフォーマットで出力されます。

<アクセス時刻><ログレベル><モジュール名><ユーザ名:グループ名><ホスト名><操作名><実行完了結果><スレッド情報>

例：

2014-01-10 14:12:25,695 INFO     JMXREMOTE - admin:otxadmin 127.0.0.1 login SUCCESS [RMI TCP Connection(1823)-127.0.0.1]

操作ログ (ログレベルCONFIG)

ユーザが発行した操作の詳細を表示します。操作詳細ログでは１つの操作に対し開始時と完了時にログを出力します。
操作詳細ログは以下のフォーマットで出力されます。

<アクセス時刻><ログレベル><モジュール名><管理対象名(Type:名前)><操作名:操作対象><実行完了結果><スレッド情報>

例: 運用管理ツールからモジュールログレベルの admin のログレベルを変更した場合

2014-01-10 14:43:32,226 CONFIG   JMXREMOTE -  [module-log-levels:-] set : admin START [RMI TCP Connection(1922)-127.0.0.1]
2014-01-10 14:43:32,344 CONFIG   JMXREMOTE -  [module-log-levels:-] set : admin DONE 118 msec. [RMI TCP Connection(1922)-127.0.0.1]

実行完了結果項目に関して、以下に詳細を記します。

getコマンド実行時のログ (ログレベルDEBUG)

出力されるログの形式はCONFIGレベルのものと同じになります。

運用操作実行時に入力される情報 (ログレベルDETAIL,TRACE)

運用操作実行時に入力される引数の内容を出力します。

出力されるログのフォーマットは以下になります。

<アクセス時刻><ログレベル><モジュール名><引数><スレッド情報>

引数が複数ある場合は、[・・・][・・・]のように大括弧で区切られて表示されます。

例：create-jdbc-datasourceコマンドを実行した場合

2014-01-10 15:33:47,239 DETAIL   JMXREMOTE - [{DEFAULT=jdbc/DB1, useJTA=true, report-type=hk2-agent, jdbcPassword=f8c2dc3eada47982, jdbcMajorVersion=3, <<COMMAND>>=create-jdbc-datasource, dataSourceName=jdbc:derby://localhost/MyDB, maxPoolSize=96, minPoolSize=32, dataSourceType=JDBC, jdbcUserName=scott}] [RMI TCP Connection(2083)-127.0.0.1]

8.3.7. IIS連携時のログローテーション

IIS とWebコンテナを連携している場合に出力するログファイルのローテーション方法について説明します。

設定ファイル

• IISと連携している場合
    ${INSTANCE_ROOT}/config/WebCont/isapi_redirect.properties に以下のように設定を追加します。
  設定を反映させるために、IISを再起動する必要があります。
  
      log_rotate=2
      rotate_interval=86400
  
  上記の設定では、1日(86400秒)以上経過しログを出力するとローテーションが行われ、2世代までログを保存します。
  
  

8.3.8. ログメッセージの保持およびダンプ機能

WebOTX内部コンポーネントが出力するログメッセージおよび標準出力・標準エラー出力に出力されるログメッセージについて、ログレベルに関わらずメモリ内に一定量保持したログメッセージを、 ログレベルを基準とした出力条件との合致または運用管理ツールから操作を契機に、ログファイルにダンプする機能の操作方法について説明します。

ログメッセージの保持機能

[運用管理コマンドから行う場合]

• 機能の有効化

  otxadmin > set server.log-service.keep-logmessage-enabled=true

• ログメッセージ保持数変更

  otxadmin > set server.log-service.keep-logmessage-size=<サイズ数>

• ログレベルを基準とした出力条件の設定

  otxadmin > set server.log-service.logmessage-dump-condition=<ログレベル>

[統合運用管理ツールから行う場合]

• 機能の有効化

  統合運用管理ツールからログサービスを選択し、「ログメッセージの保持」にチェックを入れてください。

  
  図8.3.8-1

• ログメッセージ保持数変更

  統合運用管理ツールからログサービスを選択し、「保持するログメッセージ数」に値を入力してください。

  
  図8.3.8-2

• ログレベルを基準とした出力条件の設定

  統合運用管理ツールからログサービスを選択し、「保持したログメッセージの出力条件」の値を選択してください。

  
  図8.3.8-3

ダンプ機能

[運用管理コマンドから行う場合]

• ダンプ採取

  otxadmin > invoke server.log-service.logDump

• 出力先ファイルの変更

  otxadmin > set server.log-service.property.logdump-file-path="${com.nec.webotx.instanceRoot}/logs/logdump/logdump.log"

  (※)ファイルパスの既定値は "${com.nec.webotx.instanceRoot}/logs/logdump/logdump.log" です。

[統合運用管理ツールから行う場合]

• ダンプ採取

  統合運用管理ツールからログサービスを右クリックし、「ログメッセージダンプ」を実行してください。

  
  図8.3.8-4

• 出力先ファイルの変更

  統合運用管理ツールからログサービスを右クリックし、「プロパティの設定」から「logdump-file-path=<ファイルパス>」の形式で値を設定してください。

  (※)ファイルパスの既定値は "${com.nec.webotx.instanceRoot}/logs/logdump/logdump.log" です。

  
  図8.3.8-5

8.3.9. syslogのバージョン番号出力設定

WebOTXがsyslogに出力するログには、メッセージの出力元を特定するための情報が各ログの末尾に出力されます。この情報はインストール直後の既定の設定では、ドメイン名のみが表示されます。 例えば、domain1を起動した場合には以下の様なログがsyslogに出力されます。

otxadmin > start-domain domain1

Mar 21 03:12:01 localhost WebOTX_AS_Agent: OTX01205158: アプリケーションサーバ [domain1:server] を起動します。 [domain1]
Mar 21 03:12:06 localhost WebOTX_AS_Agent: OTX02050031: Starting Web Container. [domain1]
Mar 21 03:12:09 localhost WebOTX_AS_Agent: OTX02050032: Started Web Container. [domain1]
Mar 21 03:12:11 localhost WebOTX_AS_Agent: OTX06020002: Namesv の起動が正常終了しました [domain1]
Mar 21 03:12:11 localhost ObjectSpinner[2339]: Information: NameService start.
...

また、複数バージョンをインストールする環境向けにsyslogの末尾に出力する情報にドメイン名だけでなく、バージョン番号情報を追加することも可能です

syslogの末尾に出力する情報にはドメイン名だけでなく、情報のバージョン番号を追加することも可能です。この設定はWebOTXを複数バージョンインストールしている場合に有用です。 設定手順を以下に示します。

1. 動作している全てのドメインを停止します

   otxadmin> stop-domain domain_name

2. 設定ファイル ${INSTALL_ROOT}/config/productunit.properties をエディタで開き、oslog.id_enabled の値を true に変更します。

   編集前

   oslog.id_enabled=false
   oslog.id=V9.4

   編集後

   oslog.id_enabled=true
   oslog.id=V9.4

   Caution
   

   • productunit.propertiesファイルにはASCII文字のみ使用可能です
   • oslog.id属性に設定した値がバージョン番号としてsyslogに出力されます。ただしoslog.id属性の文字列が32バイトを超える場合、33バイト目以降は出力されません。
   • productunit.propertiesファイルについて以下のエラーがある場合は、syslogにバージョン番号を出力しません。
     • productunit.propertiesファイルが存在しない
     • productunit.propertiesファイルの読み込み時に例外が発生した
     • oslog.id_enabledの値がtrueもしくはfalseではない
3. 停止していたドメインを起動します

   otxadmin> start-domain domain_name

この設定を行うことによりsyslogの出力にドメイン名と共に製品バージョンが出力されるようになります。

otxadmin > start-domain domain1

Mar 21 03:26:34 localhost WebOTX_AS_Agent: OTX01205158: アプリケーションサーバ [domain1:server] を起動します。 [V9.4-domain1]
Mar 21 03:26:40 localhost WebOTX_AS_Agent: OTX02050031: Starting Web Container. [V9.4-domain1]
Mar 21 03:26:42 localhost WebOTX_AS_Agent: OTX02050032: Started Web Container. [V9.4-domain1]
Mar 21 03:26:44 localhost ObjectSpinner[3584]: Information: NameService start.
Mar 21 03:26:44 localhost WebOTX_AS_Agent: OTX06020002: Namesv の起動が正常終了しました [V9.4-domain1]
...

また、TPモニタサービス や CORBAアプリケーション からのsyslog出力は次のようになります。

Mar 21 03:12:11 localhost OTXM:: I:1:TPS15-02040 tpmonitor start. [2342]
...
Mar 21 03:14:00 localhost OTXM:OTX07900001[2345]: 利用者が定義する文字列
...

Mar 21 03:26:45 localhost OTXM:: I:1:TPS15-02040 tpmonitor start. [3628] [V9.4]
...
Mar 21 03:28:00 localhost OTXM:OTX07900001[3658]: 利用者が定義する文字列 [V9.4]
...