10.5. ログハンドラーの設定

手順

1. 以下のコマンドを使用して Console ログハンドラーを追加します。

   /subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:add

2. 必要に応じて、以下の Console ログハンドラー属性を 1 つ以上設定できます。

   • 次のコマンドを使用して、ハンドラーのログレベルを設定します。

     /subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=level,value=LEVEL)

     デフォルトは ALL です。

   • 以下のコマンドを使用してハンドラーのターゲットを設定します。

     /subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=target,value=TARGET)

     ターゲットは、System.out、System.err、console のいずれかです。デフォルト System.out です。

   • 次のコマンドを使用して、utf-8 など、ハンドラーのエンコーディングを設定します。

     /subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=encoding,value=ENCODING)

   • 以下のコマンドを使用してハンドラーのフォーマッター文字列を設定します。

     /subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=formatter,value=FORMAT)

     たとえば、デフォルトの書式設定文字列は %d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%e%n です。FORMAT の値は引用符で囲みます。

     注記

     保存されたフォーマッターを参照する場合は named-formatter 属性を使用します。

   • 次のコマンドを使用して、自動フラッシュを設定します。

     /subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=autoflush,value=AUTO_FLUSH)

     毎回書き込みの後に自動的にフラッシュするかどうかを指定します。デフォルト値は true です。

   • 次のコマンドを使用してフィルター式を設定します。

     /subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)

     ハンドラーのログメッセージをフィルターする式の指定コンマと引用符をエスケープし、式を引用符で囲みます。たとえば、FILTER_EXPRESSION 変数を "not (match (\"WFLY\")) " に置き換え、not (match ("WFLY")) のフィルター式を作成します。

3. 以下のコマンドを使用して Console ログハンドラーをロガーに割り当てます。

   /subsystem=logging/root-logger=ROOT:add-handler(name=CONSOLE_HANDLER_NAME)

   ログハンドラーを有効にするには、Console ログハンドラーをルートロガーまたはその他のロガーに割り当てます。

4. 必要に応じて、以下のコマンドで remove 操作を使用してログハンドラーを削除できます。

   /subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:remove

   注記

   ロギング設定にログハンドラーが必要なくなったら、ログハンドラーを削除できます。ただし、ログハンドラーが現在ロガーまたは Async ログハンドラーに割り当てられている場合は削除できません。

手順

1. 以下のコマンドを使用して File ログハンドラーを追加します。

   /subsystem=logging/file-handler=FILE_HANDLER_NAME:add(file={path=FILE_PATH,relative-to=RELATIVE_TO_PATH})

   注記

   File ログハンドラーを追加する場合、path および relative-to 属性で設定される file 属性を使用して ファイル パス を指定します。path 属性を使用して、ファイル名を含むログファイルのパスを設定します（例： my-log.log ）。必要に応じて、relative-to 属性を使用して、パスが jboss.server.log.dir などの名前付きパスと相対的であることを示します。

2. 必要に応じて、以下の File ログハンドラー属性を 1 つ以上設定できます。

   • 次のコマンドを使用して、ハンドラーのログレベルを設定します。

     /subsystem=logging/file-handler=FILE_HANDLER_NAME:write-attribute(name=level,value=LEVEL)

     デフォルトは ALL です。

   • 次のコマンドを使用して、ハンドラーの追加動作を設定します。

     /subsystem=logging/file-handler=FILE_HANDLER_NAME:write-attribute(name=append,value=APPEND)

     サーバーの再起動時にファイルを上書きするには、append 属性を false に設定します。デフォルトでは、サーバーの再起動時に JBoss EAP はログメッセージを同じファイルに追加します。

   • 次のコマンドを使用して、utf-8 など、ハンドラーのエンコーディングを設定します。

     /subsystem=logging/file-handler=FILE_HANDLER_NAME:write-attribute(name=encoding,value=ENCODING)

   • 以下のコマンドを使用してハンドラーのフォーマッター文字列を設定します。

     /subsystem=logging/file-handler=FILE_HANDLER_NAME:write-attribute(name=formatter,value=FORMAT)

     たとえば、デフォルトの書式設定文字列は %d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%e%n です。FORMAT の値は引用符で囲みます。

     注記

     保存されたフォーマッターを参照する場合は named-formatter 属性を使用します。

   • 次のコマンドを使用して、自動フラッシュを設定します。

     /subsystem=logging/file-handler=FILE_HANDLER_NAME:write-attribute(name=autoflush,value=AUTO_FLUSH)

     毎回書き込みの後に自動的にフラッシュするかどうかを指定します。デフォルト値は true です。

   • 次のコマンドを使用してフィルター式を設定します。

     /subsystem=logging/file-handler=FILE_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)

     ハンドラーのログメッセージをフィルターする式の指定コンマと引用符をエスケープし、式を引用符で囲みます。たとえば、FILTER_EXPRESSION 変数を "not (match (\"WFLY\")) " に置き換え、not (match ("WFLY")) のフィルター式を作成します。

3. 以下のコマンドを使用して、File ログハンドラーをロガーに割り当てます。

   /subsystem=logging/root-logger=ROOT:add-handler(name=FILE_HANDLER_NAME)

   ログハンドラーを有効にするには、File ログハンドラーをルートロガーまたはその他のロガーに割り当てます。

4. 次のコマンドを使用して、File ログハンドラーを CATEGORY という名前の特定のロガーに割り当てます。

   /subsystem=logging/logger=CATEGORY:add-handler(name=FILE_HANDLER_NAME)

   CATEGORY は、ファイルログハンドラーを割り当てるロガーの名前に置き換えます。

5. 必要に応じて、以下のコマンドで remove 操作を使用してログハンドラーを削除できます。

   /subsystem=logging/file-handler=FILE_HANDLER_NAME:remove

   注記

   ロギング設定にログハンドラーが必要なくなったら、ログハンドラーを削除できます。ただし、ログハンドラーが現在ロガーまたは Async ログハンドラーに割り当てられている場合は削除できません。

手順

1. 以下のコマンドを使用して Periodic rotating ログハンドラーを追加します。

   /subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:add(file={path=FILE_PATH,relative-to=RELATIVE_TO_PATH},suffix=SUFFIX)

   注記

   Periodic rotating ログハンドラーを追加する場合、path および relative-to 属性で設定される file 属性を使用して ファイル パス を指定します。path 属性を使用して、ファイル名を含むログファイルのパスを設定します（例： my-log.log ）。必要に応じて、relative-to 属性を使用して、パスが jboss.server.log.dir などの名前付きパスと相対的であることを示します。

   suffix 属性を使用してローテーションログの接尾辞を設定する必要があります。接尾辞は、.yyyy-MM-dd-HH のように java.text.SimpleDateFormat が理解できる形式に従う必要があります。ローテーション期間はこの接尾辞を基に自動的に算出されます。

2. 必要に応じて、以下の Periodic rotating ログハンドラー属性を 1 つ以上設定できます。

   • 次のコマンドを使用して、ハンドラーのログレベルを設定します。

     /subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:write-attribute(name=level,value=LEVEL)

     デフォルトは ALL です。

   • 次のコマンドを使用して、ハンドラーの追加動作を設定します。

     /subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:write-attribute(name=append,value=APPEND)

     サーバーの再起動時にファイルを上書きするには、append 属性を false に設定します。デフォルトでは、サーバーの再起動時に JBoss EAP はログメッセージを同じファイルに追加します。

   • 次のコマンドを使用して、utf-8 など、ハンドラーのエンコーディングを設定します。

     /subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:write-attribute(name=encoding,value=ENCODING)

   • 以下のコマンドを使用してハンドラーのフォーマッター文字列を設定します。

     /subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:write-attribute(name=formatter,value=FORMAT)

     たとえば、デフォルトの書式設定文字列は %d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%e%n です。FORMAT の値は引用符で囲みます。

     注記

     保存されたフォーマッターを参照する場合は named-formatter 属性を使用します。

   • 次のコマンドを使用して、自動フラッシュを設定します。

     /subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:write-attribute(name=autoflush,value=AUTO_FLUSH)

     毎回書き込みの後に自動的にフラッシュするかどうかを指定します。デフォルト値は true です。

   • 次のコマンドを使用してフィルター式を設定します。

     /subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)

     ハンドラーのログメッセージをフィルターする式の指定コンマと引用符をエスケープし、式を引用符で囲みます。たとえば、FILTER_EXPRESSION 変数を "not (match (\"WFLY\")) " に置き換え、not (match ("WFLY")) のフィルター式を作成します。

3. 以下のコマンドを使用して、Periodic rotating ログハンドラーをロガーに割り当てます。

   /subsystem=logging/root-logger=ROOT:add-handler(name=PERIODIC_HANDLER_NAME)

   ログハンドラーを有効にするには、Periodic rotating ログハンドラーをルートロガーまたはその他のロガーに割り当てます。

4. 必要に応じて、以下のコマンドで remove 操作を使用してログハンドラーを削除できます。

   /subsystem=logging/periodic-rotating-file-handler=PERIODIC_HANDLER_NAME:remove

   注記

   ロギング設定にログハンドラーが必要なくなったら、ログハンドラーを削除できます。ただし、ログハンドラーが現在ロガーまたは Async ログハンドラーに割り当てられている場合は削除できません。

手順

1. 以下のコマンドを使用して Size ログハンドラーを追加します。

   /subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:add(file={path=FILE_PATH,relative-to=RELATIVE_TO_PATH})

   注記

   Size ログハンドラーを追加する場合、path および relative-to 属性で設定される file 属性を使用して ファイル パス を指定します。path 属性を使用して、ファイル名を含むログファイルのパスを設定します（例： my-log.log ）。必要に応じて、relative-to 属性を使用して、パスが jboss.server.log.dir などの名前付きパスと相対的であることを示します。

2. 必要に応じて、以下の Size ログハンドラー属性を 1 つ以上設定できます。

   • 次のコマンドを使用して、ハンドラーのログレベルを設定します。

     /subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=level,value=LEVEL)

     デフォルトは ALL です。

   • 次のコマンドを使用して、ローテーションログの接尾辞を設定します。

     /subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=suffix, value=SUFFIX)

     注記

     指定されている場合、接尾辞は .yyyy-MM-dd-HH のように java.text.SimpleDateFormat が理解できる形式に従う必要があります。接尾辞は size-rotating-file-handler はオプションです。これは、ローテーション期間自体ではなく、ファイルがローテーションされたタイミングを示します。

   • 次のコマンドを使用して、utf-8 など、ハンドラーのエンコーディングを設定します。

     /subsystem=logging/size-rotating-file-handler=PERIODIC_HANDLER_NAME:write-attribute(name=encoding,value=ENCODING)

   • 次のコマンドを使用してローテーションサイズを設定します。

     /subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=rotate-size, value=ROTATE_SIZE)

     ローテーション前の最大ファイルサイズを設定します。デフォルトは 2 メガバイトを意味する 2m です。

   • 次のコマンドを使用して、保持するバックアップログの最大数を設定します。

     /subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=max-backup-index, value=MAX_BACKUPS)

     保持するバックアップの数を指定します。デフォルト値は 1 です。

     注記

     ローテーションは、接尾辞ではなく、サイズ制限に基づいて行われます。接尾辞が定義されている場合、ローテーションされたファイルに追加されますが、これらのファイルは削除されません。サイズ制限に達したファイルのみがローテーション時に削除されます。

   • 次のコマンドを使用して、起動時にログをローテーションするかどうかを設定します。

     /subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=rotate-on-boot, value=ROTATE_ON_BOOT)

     デフォルトでは、サーバーの再起動時に新しいログファイルは作成されません。サーバーの再起動時にログをローテーションするには、これを true に設定します。

   • 次のコマンドを使用して、ハンドラーの追加動作を設定します。

     /subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=append,value=APPEND)

     サーバーの再起動時にファイルを上書きするには、append 属性を false に設定します。デフォルトでは、サーバーの再起動時に JBoss EAP はログメッセージを同じファイルに追加します。

   • 次のコマンドを使用して、utf-8 など、ハンドラーのエンコーディングを設定します。

     /subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=encoding,value=ENCODING)

   • 以下のコマンドを使用してハンドラーのフォーマッター文字列を設定します。

     /subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=formatter,value=FORMAT)

     たとえば、デフォルトの書式設定文字列は %d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%e%n です。FORMAT の値は引用符で囲みます。

     注記

     保存されたフォーマッターを参照する場合は named-formatter 属性を使用します。

   • 次のコマンドを使用して、自動フラッシュを設定します。

     /subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=autoflush,value=AUTO_FLUSH)

     毎回書き込みの後に自動的にフラッシュするかどうかを指定します。デフォルト値は true です。

   • 次のコマンドを使用してフィルター式を設定します。

     /subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)

     ハンドラーのログメッセージをフィルターする式の指定コンマと引用符をエスケープし、式を引用符で囲みます。たとえば、FILTER_EXPRESSION 変数を "not (match (\"WFLY\")) " に置き換え、not (match ("WFLY")) のフィルター式を作成します。

3. 以下のコマンドを使用して Size ログハンドラーをロガーに割り当てます。

   /subsystem=logging/root-logger=ROOT:add-handler(name=SIZE_HANDLER_NAME)

   ログハンドラーを有効にするには、Size ログハンドラーをルートロガーまたはその他のロガーに割り当てます。

4. 必要に応じて、以下のコマンドで remove 操作を使用してログハンドラーを削除できます。

   /subsystem=logging/size-rotating-file-handler=SIZE_HANDLER_NAME:remove

   注記

   ロギング設定にログハンドラーが必要なくなったら、ログハンドラーを削除できます。ただし、ログハンドラーが現在ロガーまたは Async ログハンドラーに割り当てられている場合は削除できません。

手順

1. 以下のコマンドを使用して Periodic Size ログハンドラーを追加します。

   /subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:add(file={path=FILE_PATH,relative-to=RELATIVE_TO_PATH},suffix=SUFFIX)

   注記

   Periodic Size ログハンドラーを追加する場合、path および relative-to 属性で設定される file 属性を使用して ファイル パス を指定します。path 属性を使用して、ファイル名を含むログファイルのパスを設定します（例： my-log.log ）。必要に応じて、relative-to 属性を使用して、パスが jboss.server.log.dir などの名前付きパスと相対的であることを示します。

   suffix 属性を使用してローテーションログの接尾辞を設定する必要があります。接尾辞は、.yyyy-MM-dd-HH のように java.text.SimpleDateFormat が理解できる形式に従う必要があります。ローテーション期間はこの接尾辞を基に自動的に算出されます。

2. 必要に応じて、以下の Periodic Size ログハンドラー属性を 1 つ以上設定できます。

   • 次のコマンドを使用して、ハンドラーのログレベルを設定します。

     /subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=level,value=LEVEL)

     デフォルトは ALL です。

   • 次のコマンドを使用してローテーションサイズを設定します。

     /subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=rotate-size, value=ROTATE_SIZE)

     ローテーション前の最大ファイルサイズを設定します。デフォルトは 2 メガバイトを意味する 2m です。

   • 次のコマンドを使用して、保持するバックアップログの最大数を設定します。

     /subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=max-backup-index, value=MAX_BACKUPS)

     保持するバックアップの数を指定します。デフォルト値は 1 です。

     注記

     接尾辞でローテーションされる場合、ローテーションされたファイルは削除されません。ローテーションがローテーション時に削除される場合、サイズ制限に達したファイルのみ。

   • 次のコマンドを使用して、起動時にログをローテーションするかどうかを設定します。

     /subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=rotate-on-boot, value=ROTATE_ON_BOOT)

     デフォルトでは、サーバーの再起動時に新しいログファイルは作成されません。サーバーの再起動時にログをローテーションするには、これを true に設定します。

   • 次のコマンドを使用して、ハンドラーの追加動作を設定します。

     /subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=append,value=APPEND)

     サーバーの再起動時にファイルを上書きするには、append 属性を false に設定します。デフォルトでは、サーバーの再起動時に JBoss EAP はログメッセージを同じファイルに追加します。

   • 次のコマンドを使用して、utf-8 など、ハンドラーのエンコーディングを設定します。

     /subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=encoding,value=ENCODING)

   • 以下のコマンドを使用してハンドラーのフォーマッター文字列を設定します。

     /subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=formatter,value=FORMAT)

     たとえば、デフォルトの書式設定文字列は %d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%e%n です。FORMAT の値は引用符で囲みます。

     注記

     保存されたフォーマッターを参照する場合は named-formatter 属性を使用します。

   • 次のコマンドを使用して、自動フラッシュを設定します。

     /subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=autoflush,value=AUTO_FLUSH)

     毎回書き込みの後に自動的にフラッシュするかどうかを指定します。デフォルト値は true です。

   • 次のコマンドを使用してフィルター式を設定します。

     /subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)

     ハンドラーのログメッセージをフィルターする式の指定コンマと引用符をエスケープし、式を引用符で囲みます。たとえば、FILTER_EXPRESSION 変数を "not (match (\"WFLY\")) " に置き換え、not (match ("WFLY")) のフィルター式を作成します。

3. 以下のコマンドを使用して Periodic Size ログハンドラーをロガーに割り当てます。

   /subsystem=logging/root-logger=ROOT:add-handler(name=PERIODIC_SIZE_HANDLER_NAME)

   ログハンドラーを有効にするには、Periodic Size ログハンドラーをルートロガーまたはその他のロガーに割り当てます。

4. 必要に応じて、以下のコマンドで remove 操作を使用してログハンドラーを削除できます。

   /subsystem=logging/periodic-size-rotating-file-handler=PERIODIC_SIZE_HANDLER_NAME:remove

   注記

   ロギング設定にログハンドラーが必要なくなったら、ログハンドラーを削除できます。ただし、ログハンドラーが現在ロガーまたは Async ログハンドラーに割り当てられている場合は削除できません。

手順

1. 以下のコマンドを使用して Syslog ハンドラーを追加します。

   /subsystem=logging/syslog-handler=SYSLOG_HANDLER_NAME:add

2. 必要に応じて、以下の Syslog ハンドラー属性を 1 つ以上設定できます。

   • 次のコマンドを使用して、ハンドラーのログレベルを設定します。

     /subsystem=logging/syslog-handler=SYSLOG_HANDLER_NAME:write-attribute(name=level,value=LEVEL)

     デフォルトは ALL です。

   • 次のコマンドを使用して、ログのアプリケーション名を設定します。

     /subsystem=logging/syslog-handler=SYSLOG_HANDLER_NAME:write-attribute(name=app-name,value=APP_NAME)

     デフォルトのアプリケーション名は java です。

   • 以下のコマンドを使用して syslog サーバーのアドレスを設定します。

     /subsystem=logging/syslog-handler=SYSLOG_HANDLER_NAME:write-attribute(name=server-address,value=SERVER_ADDRESS)

     デフォルトのアドレスは localhost です。

   • 以下のコマンドを使用して syslog サーバーのポートを設定します。

     /subsystem=logging/syslog-handler=SYSLOG_HANDLER_NAME:write-attribute(name=port,value=PORT)

     デフォルトのポートは 514 です。

   • 以下のコマンドを使用して、RFC 仕様に従って syslog 形式を設定します。

     /subsystem=logging/syslog-handler=SYSLOG_HANDLER_NAME:write-attribute(name=syslog-format,value=SYSLOG_FORMAT)

     デフォルトの形式は RFC5424 です。

   • 以下のコマンドを使用して、syslog ペイロードメッセージをフォーマットするために named-formatter 属性を指定します。

     /subsystem=logging/syslog-handler=SYSLOG_HANDLER_NAME:write-attribute(name=named-formatter, value=FORMATTER_NAME)

3. 以下のコマンドを使用して Syslog ハンドラーをロガーに割り当てます。

   /subsystem=logging/root-logger=ROOT:add-handler(name=SYSLOG_HANDLER_NAME)

   ログハンドラーをアクティブにするには、syslog ハンドラーをルートロガーまたはその他のロガーに割り当てます。

4. 必要に応じて、以下のコマンドで remove 操作を使用してログハンドラーを削除できます。

   /subsystem=logging/syslog-handler=SYSLOG_HANDLER_NAME:remove

   注記

   ロギング設定にログハンドラーが必要なくなったら、ログハンドラーを削除できます。ただし、ログハンドラーが現在ロガーまたは Async ログハンドラーに割り当てられている場合は削除できません。

手順

1. 以下のコマンドを使用してソケットバインディングを追加します。

   /socket-binding-group=SOCKET_BINDING_GROUP/remote-destination-outbound-socket-binding=SOCKET_BINDING_NAME:add(host=HOST, port=PORT)

   注記

   remote-destination-outbound-socket-binding または local-destination-outbound-socket-binding を使用するソケットバインディングとして定義できます。???

2. 以下のコマンドを使用して、JSON フォーマッターなど、使用する ログ フォーマッターを追加します。

   /subsystem=logging/json-formatter=FORMATTER:add

3. 以下のコマンドを使用して、ソケットバインディングとフォーマッターを指定して、Socket ログハンドラーを追加します。

   /subsystem=logging/socket-handler=SOCKET_HANDLER_NAME:add(outbound-socket-binding-ref=SOCKET_BINDING_NAME,named-formatter=FORMATTER)

4. 必要に応じて、以下の Socket ログハンドラー属性を 1 つ以上設定できます。

   • 次のコマンドを使用してプロトコルを設定します。

     /subsystem=logging/socket-handler=SOCKET_HANDLER_NAME:write-attribute(name=protocol,value=PROTOCOL)

     デフォルトのプロトコルは TCP です。

   • 次のコマンドを使用して、ハンドラーのログレベルを設定します。

     /subsystem=logging/socket-handler=SOCKET_HANDLER_NAME:write-attribute(name=level,value=LEVEL)

     デフォルトは ALL です。

     注記

     サーバーの起動中、Socket ログハンドラーによって処理されるログメッセージは、ソケットバインディングが設定され、logging サブシステムが初期化されるまでキューに置かれます。ログレベルが低く設定されている場合( TRACE や DEBUG など)、起動時に大量のメモリーが消費される可能性があります。

   • 次のコマンドを使用して、utf-8 など、ハンドラーのエンコーディングを設定します。

     /subsystem=logging/socket-handler=SOCKET_HANDLER_NAME:write-attribute(name=encoding,value=ENCODING)

   • 次のコマンドを使用して、自動フラッシュを設定します。

     /subsystem=logging/socket-handler=SOCKET_HANDLER_NAME:write-attribute(name=autoflush,value=AUTO_FLUSH)

     毎回書き込みの後に自動的にフラッシュするかどうかを指定します。デフォルト値は true です。

   • 次のコマンドを使用してフィルター式を設定します。

     /subsystem=logging/socket-handler=SOCKET_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)

     ハンドラーのログメッセージをフィルターする式の指定コンマと引用符をエスケープし、式を引用符で囲みます。たとえば、FILTER_EXPRESSION 変数を "not (match (\"WFLY\")) " に置き換え、not (match ("WFLY")) のフィルター式を作成します。

5. 以下のコマンドを使用して Socket ログハンドラーをロガーに割り当てます。

   /subsystem=logging/root-logger=ROOT:add-handler(name=SOCKET_HANDLER_NAME)

   ログハンドラーをアクティブにするには、Socket ログハンドラーをルートロガーまたはその他のロガーに割り当てます。

6. 必要に応じて、以下のコマンドで remove 操作を使用して Socket ログハンドラーを削除できます。

   /subsystem=logging/socket-handler=SOCKET_HANDLER_NAME:remove

   注記

   ロギング設定にログハンドラーが必要なくなったら、ログハンドラーを削除できます。ただし、ログハンドラーが現在ロガーまたは Async ログハンドラーに割り当てられている場合は削除できません。

手順

1. 以下のコマンドを使用してカスタムログハンドラーを追加します。

   /subsystem=logging/custom-handler=CUSTOM_HANDLER_NAME:add(class=CLASS_NAME,module=MODULE_NAME)

   注記

   カスタムログハンドラーを追加するとき、ハンドラーの Java クラスとハンドラーを含む JBoss EAP モジュールを指定します。クラスは java.util.logging.Handler を拡張する必要があります。

   カスタムロガーが含まれる モジュールを作成していることを確認してください。作成されていないと、このコマンドの実行 に失敗します。

2. 必要に応じて、以下のカスタムログハンドラー属性を 1 つ以上設定できます。

   • 次のコマンドを使用して、ハンドラーのログレベルを設定します。

     /subsystem=logging/custom-handler=CUSTOM_HANDLER_NAME:write-attribute(name=level,value=LEVEL)

     デフォルトは ALL です。

   • 以下のコマンドを使用してログハンドラーのプロパティーを設定します。

     /subsystem=logging/custom-handler=CUSTOM_HANDLER_NAME:write-attribute(name=properties.PROPERTY_NAME,value=PROPERTY_VALUE)

     setter メソッドを使用してプロパティーにアクセスできなければなりません。

   • 次のコマンドを使用して、utf-8 など、ハンドラーのエンコーディングを設定します。

     /subsystem=logging/custom-handler=CUSTOM_HANDLER_NAME:write-attribute(name=encoding,value=ENCODING)

   • 以下のコマンドを使用してハンドラーのフォーマッター文字列を設定します。

     /subsystem=logging/custom-handler=CUSTOM_HANDLER_NAME:write-attribute(name=formatter,value=FORMAT)

     たとえば、デフォルトの書式設定文字列は %d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%e%n です。FORMAT の値は引用符で囲みます。

     注記

     保存されたフォーマッターを参照する場合は named-formatter 属性を使用します。

   • 次のコマンドを使用してフィルター式を設定します。

     /subsystem=logging/custom-handler=CUSTOM_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)

     ハンドラーのログメッセージをフィルターする式の指定コンマと引用符をエスケープし、式を引用符で囲みます。たとえば、FILTER_EXPRESSION 変数を "not (match (\"WFLY\")) " に置き換え、not (match ("WFLY")) のフィルター式を作成します。

3. 以下のコマンドを使用してカスタムログハンドラーをロガーに割り当てます。

   /subsystem=logging/root-logger=ROOT:add-handler(name=CUSTOM_HANDLER_NAME)

   ログハンドラーを有効にするには、ハンドラーをルートロガーまたはその他のロガーに割り当てます。

4. 以下のコマンドを使用して、カスタムログハンドラーを CATEGORY という名前の特定のロガーに割り当てます。

   /subsystem=logging/logger=CATEGORY:add-handler(name=CUSTOM_HANDLER_NAME)

   CATEGORY は、カスタムログハンドラーを割り当てるロガーの名前に置き換えます。

5. 必要に応じて、以下のコマンドで remove 操作を使用してカスタムログハンドラーを削除できます。

   /subsystem=logging/custom-handler=CUSTOM_HANDLER_NAME:remove

   注記

   ロギング設定にログハンドラーが必要なくなったら、ログハンドラーを削除できます。ただし、ログハンドラーが現在ロガーまたは Async ログハンドラーに割り当てられている場合は削除できません。

手順

1. 以下のコマンドを使用して Async ログハンドラーを追加します。

   /subsystem=logging/async-handler=ASYNC_HANDLER_NAME:add(queue-length=QUEUE_LENGTH)

   注記

   Async ログハンドラーを追加する場合、キューの長さを指定します。これは、いつでもキューに保持できるログリクエストの最大数です。

2. 次のコマンドを使用してサブハンドラーを追加します。

   /subsystem=logging/async-handler=ASYNC_HANDLER_NAME:add-handler(name=HANDLER_NAME)

   注記

   1 つ以上のハンドラーを Async ログハンドラーのサブハンドラーとして追加できます。ハンドラーは設定にすでに存在している必要があります。存在しない場合、このコマンドは失敗します。

3. 必要に応じて、以下の Async ログハンドラー属性を 1 つ以上設定できます。

   • 次のコマンドを使用して、ハンドラーのログレベルを設定します。

     /subsystem=logging/async-handler=ASYNC_HANDLER_NAME:write-attribute(name=level,value=LEVEL)

     デフォルトは ALL です。

   • 次のコマンドを使用してオーバーフローアクションを設定します。

     /subsystem=logging/async-handler=ASYNC_HANDLER_NAME:write-attribute(name=overflow-action,value=OVERFLOW_ACTION)

     デフォルトの値は BLOCK で、キューがいっぱいになるとスレッドがブロックされます。この値を DISCARD に変更すると、最も古いログメッセージが削除され、キューが満杯になった場合に新しいメッセージに対応します。

   • 次のコマンドを使用してフィルター式を設定します。

     /subsystem=logging/async-handler=ASYNC_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)

     ハンドラーのログメッセージをフィルターする式の指定コンマと引用符をエスケープし、式を引用符で囲みます。たとえば、FILTER_EXPRESSION 変数を "not (match (\"WFLY\")) " に置き換え、not (match ("WFLY")) のフィルター式を作成します。

4. 以下のコマンドを使用して Async ログハンドラーをロガーに割り当てます。

   /subsystem=logging/root-logger=ROOT:add-handler(name=ASYNC_HANDLER_NAME)

   ログハンドラーを有効にするには、Async ログハンドラーをルートロガーまたはその他のロガーに割り当てます。

5. 必要に応じて、以下のコマンドで remove 操作を使用すると非同期ログハンドラーを削除できます。

   /subsystem=logging/async-handler=ASYNC_HANDLER_NAME:remove

   注記

   ロギング設定にログハンドラーが必要なくなったら、ログハンドラーを削除できます。ただし、ログハンドラーが現在ロガーに割り当てられている場合は削除できません。