付録A.1　トレースの設定項目

(1)　設定内容

トレースに設定できるトレースの情報は，次の五つです。

• 出力レベル

  トレースファイルに出力する情報のレベルを指定します。出力レベルには，次に示す6段階のレベルがあります。推奨する出力レベルは，WARNです。

  1. OFF

     トレースは出力されません。

  2. ERROR

     致命的なエラーを出力します。

  3. WARN

     警告レベルまでのエラーを出力します。

  4. CAUTION

     主要な処理情報を出力します。

  5. INFO

     CAUTIONレベルよりも詳細な処理情報を出力します。

  6. DEBUG

     INFOレベルよりも詳細な処理情報を出力します。

• 出力先

  トレースファイルを出力するディレクトリを絶対パスで指定します。推奨する出力先を次に示します。

  推奨するトレースファイルの出力先（Windowsの場合）

  Application Serverインストール先ディレクトリ/XMLSEC/logs

  推奨するトレースファイルの出力先（UNIXの場合）

  /opt/Cosminexus/XMLSEC/logs

• 出力先ファイル名のプレフィックス

  トレースファイル名のプレフィックスを指定します。プレフィックスと面番号の組み合わせたものが，トレースファイル名となります。プレフィックスが「csmxsec_trace」で面番号が「3」の場合のトレースファイル名の例を次に示します。

  csmxsec_trace3.log

• 出力サイズ

  トレースファイル1面当たりのファイルサイズをバイト単位で指定します。4,096〜2,147,483,647の間の値を指定してください。

• 出力面数

  トレースファイルを何面で循環させるかを指定します。1〜16の間の値を指定してください。

  注意事項

  CAUTIONレベル，INFOレベル，またはDEBUGレベルでトレースを出力した場合，トレースに個人情報が出力されることがあります。CAUTIONレベル，INFOレベル，またはDEBUGレベルは，障害が発生した場合にトレースを採取するときだけ使用します。

  出力レベルをCAUTION，INFO，またはDEBUGに設定すると，多くの情報が出力されるため，性能が低下するおそれがあります。トレース採取後は，必ず出力レベルをOFF，ERROR，またはWARNに変更してください。

ページの先頭へ

(2)　設定値

トレースファイルの設定項目とデフォルト値を次の表に示します。なお，システムプロパティや設定ファイルに記述するときのプロパティ名は，「com.cosminexus.xml.security.logging.設定名」とします。

表A‒1　トレースの設定項目に設定する値

設定項目	設定名	デフォルト値
出力レベル	trace_level	OFF
出力先	trace_dir	${user.dir}※1
出力先ファイル名のプレフィックス	trace_fileprefix	csmxsec_trace※2
出力サイズ	trace_filesize	1048576
出力面数	trace_filenum	4

注意事項

XML Security - Coreを使用してアプリケーションを実行する場合は，トレースファイルおよびトレースファイルが出力されるディレクトリに対するアクセス権が必要です。トレースファイルまたはトレースファイルが出力されるディレクトリに対してアクセス権がない場合，エラーが発生してアプリケーションを実行できません。

ページの先頭へ