付録A.1 トレースの設定項目
トレース情報を出力するためには,システムプロパティまたは設定ファイルでトレースの情報を設定する必要があります。システムプロパティと設定ファイルとの両方でトレースの情報を設定した場合は,システムプロパティの設定が優先されます。ここでは,トレースに設定できる内容,および設定値について説明します。
(1) 設定内容
-
トレースファイルに出力する情報のレベルを指定します。出力レベルには,次に示す6段階のレベルがあります。推奨する出力レベルは,WARNです。
-
トレースファイルを出力するディレクトリを絶対パスで指定します。推奨する出力先を次に示します。
- 推奨するトレースファイルの出力先(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.設定名」とします。
設定項目 |
設定名 |
デフォルト値 |
---|---|---|
OFF |
||
${user.dir}※1 |
||
csmxsec_trace※2 |
||
1048576 |
||
4 |
- 注意事項
-
XML Security - Coreを使用してアプリケーションを実行する場合は,トレースファイルおよびトレースファイルが出力されるディレクトリに対するアクセス権が必要です。トレースファイルまたはトレースファイルが出力されるディレクトリに対してアクセス権がない場合,エラーが発生してアプリケーションを実行できません。