9.3. ソースによる設定

以下の表は、同等の server.xmlbootstrap.properties、および環境変数の設定と簡単な説明を示しています。詳細な設定に関するドキュメントは、logging 要素の config reference で利用できます。

サーバー XML 属性ブートストラッププロパティーenv var説明

hideMessage

com.ibm.ws.logging.hideMessage

 

この属性を使用して、Console.log ファイルおよび messages .log ファイルから非表示にする必要のある メッセージキーを設定できます。メッセージを非表示にするように設定されている場合は、trace.log ファイルにリダイレクトされます。

logDirectory

com.ibm.ws.logging.log.directory

LOG_DIR

この属性を使用して、console.log ファイルを除くすべてのログ ファイルのディレクトリーを設定できますが、FFDC も含むことができます。デフォルトは WLP _OUTPUT_DIR/serverName/logs です。logDirectory を server.xml に設定する こと は推奨されません。これは、server.xml を読み取る前に一部のログデータがデフォルトの場所に書き込ま れる ためです。

コンソールログ設定

consoleFormat

com.ibm.ws.logging.console.format

WLP_LOGGING_CONSOLE_FORMAT

コンソールに必要な形式。有効な値は basic または json 形式です。デフォルトでは、consoleFormat basic に設定されます。

consoleLogLevel

com.ibm.ws.logging.console.log.level

WLP_LOGGING_CONSOLE_LOGLEVEL

このフィルターは、コンソールに送信されるメッセージの粒度を制御します。有効な値は INFO、AUDIT、WARNING、ERROR、OFF です。デフォルトは AUDIT です。Eclipse 開発者ツールを使用する場合は、これをデフォルトに設定する必要があります。

consoleSource

com.ibm.ws.logging.console.source

WLP_LOGGING_CONSOLE_SOURCE

コンソールにルーティングするカンマ区切りのソースの一覧。このプロパティーは、consoleFormat ="json" の場合にのみ適用され ます。有効な値は messagetraceaccessLogffdc、および audit です。デフォルトで、consoleSource message に設定されます。監査 ソースを使用するには、Liberty audit-1.0 機能を有効にします。accessLog ソース を使用するには、httpAccessLogging を設定する必要があり ます

copySystemStreams

com.ibm.ws.logging.copy.system.streams

 

true の場合、System.out および System.err ストリームに書き込まれるメッセージはプロセス stdout および stderr にコピーされ、console.log に表示されます。false の場合、これらのメッセージは messages.log、trace .log などの設定されたログに書き込まれますが、 stdout および stderr にコピーされず、console.log には表示されません。デフォルト値は true です。

Message Log Config

 

com.ibm.ws.logging.newLogsOnStart

 

Liberty の開始時に true に設定すると、既存の messages.log または trace.log ファイルがロールアウトされ、新しい message .log または trace.log ファイルへの書き込みがロギングされます。false messages.log または trace.log ファイルを設定すると、maxFileSize に到達した場合にのみ更新され ます。デフォルトは true です。この設定は、サーバーのブートストラップ時にのみ処理されるため、server.xmllogging 要素を使用して提供できません。

isoDateFormat

com.ibm.ws.logging.isoDateFormat

 

ログファイルで ISO-8601 形式の日付を使用するかどうかを指定します。デフォルト値は false です。

true に設定すると、ISO-8601 形式が messages.log ファイル、trace.log ファイル、および FFDC ログで 使用されます。形式は yyyy-MM-dd'T'HH:mm:ss.SSSZ です

false の値を指定すると、システムに設定したデフォルトのロケールに従って日時がフォーマットされます。デフォルトのロケールが見つからない場合、形式は dd/MMM/yyyy HH:mm:ss:SSS z になります。

maxFiles

com.ibm.ws.logging.max.files

 

各ログファイルが保持される数。この設定は、FFDC の例外要約ログの数にも適用されます。したがって、この番号が 10 の場合、ffdc/ ディレクトリーに 10 個のメッセージログ、10 トレースログ、例外要約が 10 個ある可能 性があり ます。デフォルトでは、値は 2 です。console.log はロールを持たないため、この設定は適用されません。

maxFileSize

com.ibm.ws.logging.max.file.size

 

ログファイルが展開される前に到達できる最大サイズ(MB 単位)。値を 0 に設定すると、ログローリングが無効になります。デフォルト値は 20 です。console.log はロールを持たないため、この設定は適用されません。

messageFileName

com.ibm.ws.logging.message.file.name

 

メッセージログのデフォルト名は messages.log です。このファイルは常に存在し、System. out および System. err に加えて INFO およびその他のメッセージ(AUDIT、WARNING、ERROR、FAILURE)メッセージが含まれ ます。このログには、タイムスタンプと発行先のスレッド ID も含まれます。ログファイルがロールオーバーされると、以前のログファイルの名前の形式は messages_timestamp.logになります。

messageFormat

com.ibm.ws.logging.message.format

WLP_LOGGING_MESSAGE_FORMAT

messages.log ファイルに必要な形式。有効な値は basic または json 形式です。デフォルトでは、messageFormat basic に設定されます。

messageSource

com.ibm.ws.logging.message.source

WLP_LOGGING_MESSAGE_SOURCE

messages.log ファイルにルーティングするカンマ区切りのソースの一覧。このプロパティーは、messageFormat ="json" の場合にのみ適用され ます。有効な値は messagetraceaccessLogffdc、および audit です。デフォルトでは、messageSource message に設定されます。監査 ソースを使用するには、Liberty audit-1.0 機能を有効にします。accessLog ソース を使用するには、httpAccessLogging を設定する必要があり ます

トレース設定

suppressSensitiveTrace

  

サーバートレースは、ネットワーク接続で受信されるバイトなど、タイプのないデータを追跡すると機密データを公開できます。この属性は、true に設定すると、潜在的な機密情報がログおよびトレースファイルで公開されないようにします。デフォルト値は false です。

traceFileName

com.ibm.ws.logging.trace.file.name

 

trace.log ファイルは、追加のトレースまたは詳細なトレースが有効になっている場合にのみ作成されます。stdout は特殊な値として認識され、トレースは元の標準出力ストリームに転送されます。

traceFormat

com.ibm.ws.logging.trace.format

 

この属性は、トレースログの形式を制御します。Liberty のデフォルト形式は ENHANCED ですBASIC 形式および ADVANCED 形式を使用すること できます。

traceSpecification

com.ibm.ws.logging.trace.specification

 

trace 文字列は、トレースを選択的に有効化するために使用されます。ログレベル仕様の形式:

component = level

component は、レベルに設定するログソースを指定し、level は、以下のいずれかを使用して、出力すべきトレースの量を 指定 ます。 fatalseverewarningauditinfoconfig details、finer finerfinestall複数のログレベルを指定することで、コロンで区切ります。

コンポーネントには、ロガー名、トレースグループ、またはクラス名を指定できます。アスタリスク * はワイルドカードとして機能し、プレフィックスに基づいて複数のコンポーネントに一致するワイルドカードとして機能します。以下に例を示します。

  • * 製品システムコードやカスタマーコードなど、アプリケーションサーバーで実行されているすべての追跡可能なコードを指定します。
  • com.ibm.ws.* は、com.ibm.ws で始まるパッケージ名を持つすべてのクラスを指定します。
  • com.ibm.ws.classloading.AppClassLoader は AppClassLoader クラスのみを指定します。