Cosminexus アプリケーションサーバ V8 Webサービス開発の手引

[目次][用語][索引][前へ][次へ]

29.3.4 ログのフォーマット

稼働ログ,保守ログ,例外ログおよび通信ログのフォーマットについて説明します。

<この項の構成>
(1) 稼働ログと保守ログのフォーマット
(2) 例外ログと通信ログのフォーマット
(3) 通信ログの文字エンコーディング

(1) 稼働ログと保守ログのフォーマット

稼働ログおよび保守ログの出力項目と出力内容を次の表に示します。

表29-10 稼働ログと保守ログのフォーマット

項目 出力内容
番号 トレースコードの通番(4けた)です。0000から始まり,9999まで行くと,0000に戻ります。
日付 出力時の日付(yyyy/mm/dd形式)
時刻 出力時の時刻(hh:mm:ss.nnn形式)
アプリケーション名
  • WebサービスおよびWebサービスクライアントの場合:「cjw」
  • cjwsimportコマンドの場合:「cjwsimport」
  • aptコマンドの場合:「cjwapt」
  • cjwsgenコマンドの場合:「cjwsgen」
  • WS-RM 1.2機能の場合:「wsrm」
プロセス識別子 プロセス識別子(16進数)
スレッド識別子 スレッド識別子(16進数)
メッセージID メッセージID
メッセージ種別 メッセージ種別
  • ER:エラーメッセージを表示したことを表します。
  • EC:例外をキャッチしたことを表します。
  • なし:上記以外のトレース情報を表します。
メッセージテキスト メッセージの本体
CRLF レコード終端記号

(2) 例外ログと通信ログのフォーマット

例外ログと通信ログの出力項目と出力内容を次の表に示します。

表29-11 例外ログと通信ログのフォーマット

項目 出力内容
日付 出力時の日付(yyyy/mm/dd形式)
時刻 出力時の時刻(hh:mm:ss形式)
Sourceクラス名 ログを発行したクラス名
レベル ログの重要度
メッセージ メッセージの本体

通信ログの出力例を次に示します。

2008/10/14 13:09:44 com.cosminexus.xml.ws.transport.http.client.HttpTransportPipe process
情報: KDJW30011-I http client message
---[HTTP request]---
SOAPAction: ""
Content-Type: text/xml;charset="utf-8"
X-hitachi-rootAp: MTgxNDczMTYyLzE2ODgvMC84MDI=
X-hitachi-clientAp: MTgxNDczMTYyLzE2ODgvMC84MDI=
Accept: text/xml, multipart/related, text/html, image/gif, image/jpeg, *; q=.2, */*; q=.2
<?xml version="1.0" ?><S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/"><S:Body><ns2:jaxWsTest1 xmlns:ns2="http://example.com/sample"><information>Invocation test.</information><count>1003</count></ns2:jaxWsTest1></S:Body></S:Envelope>
2008/10/14 13:09:45 com.cosminexus.xml.ws.transport.http.client.HttpTransportPipe process
情報: KDJW30012-I http client message
---[HTTP response 200]---
HTTP/1.1 200 OK
Keep-alive: timeout=3, max=100
Date: Tue, 14 Oct 2008 04:09:44 GMT
Content-type: text/xml;charset=utf-8
Connection: Keep-Alive
Transfer-encoding: chunked
Server: Hitachi Web Server
<?xml version="1.0" ?><S:Envelope xmlns:S="http://schemas.xmlsoap.org/soap/envelope/"><S:Body><ns2:jaxWsTest1Response xmlns:ns2="http://example.com/sample"><return>We've got your #1003 message &quot;Invocation test.&quot;! It's 2008.10.14 13:09:45 now. See ya!</return></ns2:jaxWsTest1Response></S:Body></S:Envelope>

(3) 通信ログの文字エンコーディング

SOAPメッセージの文字エンコーディングとは関係なく,通信ログには動作定義ファイルのcom.cosminexus.jaxws.logger.runtime.transport.encodingプロパティで指定した文字エンコーディングが適用されます。デフォルトは,プラットフォーム依存のエンコーディングです。

SOAPメッセージの文字エンコーディングと通信ログの文字エンコーディングが異なる場合,組み合わせによっては通信ログ内の一部の文字が不正になるおそれがあります。例えば,SOAPメッセージの文字エンコーディングがUTF-8,通信ログの文字エンコーディングがMS932の場合,SOAPメッセージ内にMS932に存在しない文字が含まれていると,その文字は通信ログ内で不正となります。そのため,Webサービス開発時には,使用できる文字コードまたは文字セットを規定して,Webサービスクライアントの開発者(WSDLの公開先)に通知することをお勧めします。