WebOTX Manual V10.3 (第4版) 目次を表示

---

3.3. ログの設定方法

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

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

3.3.1. ログレベルの変更

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

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

  1. 統合運用管理ツールを起動しドメインと接続します。
  2. 管理ツリーより、admin→<ドメイン名>→アプリケーションサーバ→ログサービス→モジュールログレベルを選択します。
  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

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

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

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

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

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

  
  

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

  
  

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

3.3.4. ログの世代数の変更

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

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

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

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

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

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

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

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

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

3.3.5. ロガー名称

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

3.3.6. アペンダ

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内部コンポーネントのモジュール名に置換されます。

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

3.3.7. ログレベル

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

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

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

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