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

---

4. ログ

4.1. Expressでのログ

WebOTX ESB実行時にドメイン毎のlogsディレクトリに次のログを出力します。

• WebOTX共通のログ  ${INSTALL_ROOT}\domains\{domain名}\logs
• WebOTX ESBに関するログ ${INSTALL_ROOT}\domains\{domain名}\logs\esb

WebOTX共通のログ内容、ドメイン毎のログ設定ファイル(log4otx.xml)の設定方法については、[ ログ ] を参照してください。

4.1.1. server.log

エージェントのJava VM 上の標準出力(System.out)、標準エラー出力(System.err)に出力された内容を保持します。
追記で出力します。

4.1.2. agent.log

WebOTXドメインのエージェントでログ出力された内容を保持します。WebOTX ドメインのエージェントで動作上問題があった場合にはagent.log を参照し、ERROR やWARNING メッセージが出力されていないか確認してください。

4.1.3. webotx_esb.log

WebOTX ESBのログファイルです。同じログはagent.logにも出力されます。
SOAP BC、HTTP BC、Salesforce BCの通信内容をダンプした場合もwebotx_esb.logに出力されます。ダンプ方法については、[ リファレンス集 運用管理・設定・構成編 > 1. コンフィグレーション > 1.1. ドメインに関する設定 > 1.1.1. システム環境変数 ] を参照してください。

4.2. Expressでのログの設定方法

システムサービスとコンポーネントに対してログレベルを設定することが可能です。
コンポーネントのログレベルには[TRACE,DETAIL,DEBUG,CONFIG,INFO,WARN,ERROR,OFF]があります。デフォルトではCONFIGに設定されています。
ログレベルの変更は運用管理ツール、otxadminコマンドから行います。

運用管理ツール：
[ドメイン名]-[アプリケーションサーバ]-[ログサービス]-[モジュールログレベル]の[ESB]タブ

otxadminコマンド：
ログレベルの変更方法について説明します。ログレベルの変更はotxadmin setコマンド、ログレベルの確認はotxadmin getコマンドを利用します。set、getコマンドの利用方法は、WebOTXマニュアルの[ getコマンド、setコマンド ]を参照してください。以下のコマンドの記述はloginコマンドを実行後のものです。

現在のログレベルの確認

otxadmin> get server.log-service.module-log-levels.ESBCBREngine
server.log-service.module-log-levels.ESBCBREngine = CONFIG

ログレベルの変更
ログレベルをCONFIGからDEBUGに変更します。

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

各モジュール名とログレベルについては、[ MBean定義 ] を参照してください。

4.3. Standardでのログ

Standardの場合、各プロセスグループのログ情報および該当プロセスグループに配備されるサービスアセンブリのログ情報は下記のファイルに出力されます。

ログ出力ファイル名：

${INSTALL_ROOT}\domains\[domain名]\logs\tpsystem\アプリケーショングループ名\プロセスグループ名\プロセスグループ名.プロセスID.log

例えば、アプリケーショングループAPG001に作られたプロセスグループPG001のログ情報は下記のようになります（図7.3a）。

PG001に4つのプロセスを起動させたため、それぞれのプロセスのログファイルが生成されました。「3964」、「4698」、「5032」と「6276」はOSに割り当てられたプロセスIDで、4つのプロセスに対応します。

プロセスグループのログの詳細については、[ Standard上のアプリケーションのログ出力 ] を参照してください。

【図7.3a】ログ情報

エージェント上でのESBのログ情報はExpressと同様にドメイン毎のlogsディレクトリに出力されます。

• WebOTX共通のログ  ${INSTALL_ROOT}\domains\{domain名}\logs
• WebOTX ESBに関するログ ${INSTALL_ROOT}\domains\{domain名}\logs\esb

WebOTX共通のログ内容、ドメイン毎のログ設定ファイル(log4otx.xml)の設定方法については、[ ログ ] を参照してください。

4.3.1. プロセスグループのログ

プロセスグループでログ出力された内容を保持します。標準出力(System.out)、標準エラー出力(System.err)に出力された内容もこのログに出力されます。プロセスグループのプロセスで動作上問題があった場合にはこのログファイルを参照し、ERRORやWARNINGメッセージが出力されていないか確認してください。

ログファイルのサイズのデフォルトは1024KBです。この値は運用管理ツール、otxadminコマンドから変更できます。

運用管理ツール：

[ドメイン名]-[TPシステム]-[アプリケーショングループ]-[ アプリケーショングループ名]-[プロセスグループ]-[プロセスグループ名]-[トレース設定]-[システムトレースファイルの最大サイズ]

otxadminコマンド：

set tpsystem.applicationGroups.アプリケーショングループ名.processGroups.プロセスグループ名.traceFileMaxSize=最大サイズ

4.3.2. server.log

エージェントのJava VM 上の標準出力(System.out)、標準エラー出力(System.err)に出力された内容を保持します。

追記で出力します。

4.3.3. agent.log

WebOTXドメインのエージェントでログ出力された内容を保持します。WebOTX ドメインのエージェントで動作上問題があった場合にはagent.log を参照し、ERROR やWARNING メッセージが出力されていないか確認してください。

4.3.4. webotx_esb.log

WebOTX ESBのログファイルです。同じログはagent.logにも出力されます。
SOAP BC、HTTP BC、Salesforce BCの通信内容をダンプした場合もwebotx_esb.logに出力されます。ダンプ方法については、[ リファレンス集 運用管理・設定・構成編 > 1. コンフィグレーション > 1.1. ドメインに関する設定 > 1.1.1. システム環境変数 ] を参照してください。

4.4. Standardでのログの設定方法

Expressと同様に、システムサービスとコンポーネントに対してログレベルを設定することが可能です。
コンポーネントのログレベルには[TRACE,DETAIL,DEBUG,CONFIG,INFO,WARN,ERROR,OFF]があります。デフォルトではCONFIGに設定されています。
Standardでは、プロセスグループのログに対してログレベルを設定します。

プロセスグループのログのログレベルの変更は運用管理ツール、otxadminコマンドから行います。

運用管理ツール：
[ドメイン名]-[TPシステム]-[アプリケーショングループ]-[アプリケーショングループ名]-[プロセスグループ]-[プロセスグループ名]の[モジュールログレベル]タブ

otxadminコマンド：
ログレベルの変更はotxadmin setコマンド、ログレベルの確認はotxadmin getコマンドを利用します。set、getコマンドの利用方法は、WebOTXマニュアルの[ getコマンド、setコマンド ] を参照してください。以下のコマンドの記述はloginコマンドを実行後のものです。

現在のログレベルの確認

otxadmin> get tpsystem.applicationGroups.apg1.processGroups.pg1.ESBCBREngineLogLevel
tpsystem.applicationGroups.apg1.processGroups.pg1.ESBCBREngineLogLevel = CONFIG
(apg1がアプリケーショングループ名です、pg1はプロセスグループ名です。)

ログレベルの変更
ログレベルをCONFIGからDEBUGに変更します。

get tpsystem.applicationGroups.apg1.processGroups.pg1.ESBCBREngineLogLevel=DEBUG
tpsystem.applicationGroups.apg1.processGroups.pg1.ESBCBREngineLogLevel = DEBUG

各モジュール名とログレベルについては、[ MBean定義 ] を参照してください。

4.4.1. WebOTX ESBのログサービス

WebOTX ESBのログサービスでログレベルが設定可能なモジュールは以下の通りです。

4.4.2. FaultとErrorについて

WebOTX ESB内部のメッセージ交換における異常系メッセージとしてFaultとErrorの二種類が使用されますが、以下のような違いがあります。

・  Fault：Outboundで呼び出した外部サービスの処理でエラー発生した場合。外部サービスへの接続やメッセージ送信は正常に完了しているが、異常を示すメッセージが返信されたケースなどが相当します。ESBはメッセージ交換方式(MEP)に従って処理を継続します。

・  Error：Outboundでの外部サービス呼出でエラー発生した場合やESBの各コンポーネントの処理でエラーがあった場合。外部サービスへの接続エラーやメッセージ送信エラー、サービスユニットで存在しないプロバイダを指定、共通ハンドラの処理でエラー発生したケースなどが相当します。ESBはメッセージ交換を中止してメッセージの送信元へErrorを返します。

FaultやErrorが発生したときは前述のESBのログファイルに以下の形式で出力されます。

〔出力例〕

ESB Exception message
Message ID: 1231482699932-70044305
Date      : Fri Jan 09 15:31:41 JST 2009
Component : SOAPBinding
String    : 外部サービス呼び出しでエラーが発生しました。

各コンポーネントで発生する可能性のあるエラー(Fault/Error)に関しては [ リファレンス集 開発編（Enterprise Service Bus） > 2. 異常系メッセージ(Fault/Error) ] を参照してください。

4.5. イベントメッセージ

WebOTX ESBのイベントメッセージは、Windowsの場合はシステムのイベントログ(アプリケーション)に、UNIXの場合はsyslogに出力されます。

出力されるメッセージのフォーマット、一覧については、[ メッセージ ] を参照してください。

4.6. 集配信履歴情報ログ出力

4.6.1. 出力項目

4.6.2. 設定方法

1．[アプリケーションサーバ]-[ESB]-[サービスアセンブリ]を選択し、[ログ関連]タブを開きます。

ログレベルによって出力内容を出力するかどうかを設定します。

　　　　 (設定項目一覧)

1．配備したSAノードタブを開きます。

2．ログレベルを設定します。

4.6.3. 出力ログファイル

ログ出力ファイルのパスについて、
(Expressの場合) ドメインルート/logs/esb/delivery_history/<SAの名前>/file_delivery_history.csv。
(Standardの場合) /logs/esb/tpsystem/<アプリケーショングループ名>/<プロセスグループ名>/<プロセスID>/delivery_history/<SAの名前>/file_delivery_history.csv。