A.17. 日志处理程序属性

Autoflush

如果设置为 true，则日志消息将在接收后立即发送到分配的文件。

enabled

如果设置为 true，则处理程序将启用并正常运行。如果设置为 false，则在处理日志消息时会忽略处理程序。

编码

用于输出的字符编码方案。

filter

定义一个简单的过滤器类型。已弃用，以 filter-spec 替代。

filter-spec

定义过滤器的表达式值。以下表达式定义了一个与模式不匹配的过滤器： not (match ("WFLY resolved"))

formatter

此日志处理程序使用的日志格式器。

level

日志处理程序记录的最小日志消息级别。

名称

日志处理程序的名称。已弃用，因为处理程序的地址包含名称。

named-formatter

处理程序使用的定义格式器的名称。

target

发送日志处理程序输出的系统输出流。可以是以下之一：

附加

如果设置为 true，则此处理程序编写的所有消息都将附加到 文件（如果已存在）。如果设置为 false，则每次应用服务器启动时都会创建一个新文件。

Autoflush

如果设置为 true，则日志消息将在接收后立即发送到分配的文件。

enabled

如果设置为 true，则处理程序将启用并正常运行。如果设置为 false，则在处理日志消息时会忽略处理程序。

编码

用于输出的字符编码方案。

file

代表此日志处理程序输出要写入的文件的对象。它有两个配置属性，即 relative-to 和 path。

filter

定义一个简单的过滤器类型。已弃用，以 filter-spec 替代。

filter-spec

定义过滤器的表达式值。以下表达式定义了一个与模式不匹配的过滤器： not (match ("WFLY resolved"))

formatter

此日志处理程序使用的日志格式器。

level

日志处理程序记录的最小日志消息级别。

名称

日志处理程序的名称。已弃用，因为处理程序的地址包含名称。

named-formatter

处理程序使用的定义格式器的名称。

附加

如果设置为 true，则此处理程序编写的所有消息都将附加到 文件（如果已存在）。如果设置为 false，则每次应用服务器启动时都会创建一个新文件。

Autoflush

如果设置为 true，则日志消息将在接收后立即发送到分配的文件。

enabled

如果设置为 true，则处理程序将启用并正常运行。如果设置为 false，则在处理日志消息时会忽略处理程序。

编码

用于输出的字符编码方案。

file

代表此日志处理程序输出要写入的文件的对象。它有两个配置属性，即 relative-to 和 path。

filter

定义一个简单的过滤器类型。已弃用，以 filter-spec 替代。

filter-spec

定义过滤器的表达式值。以下表达式定义了一个与模式不匹配的过滤器： not (match ("WFLY resolved"))。

formatter

此日志处理程序使用的日志格式器。

level

日志处理程序记录的最小日志消息级别。

名称

日志处理程序的名称。已弃用，因为处理程序的地址包含名称。

named-formatter

处理程序使用的定义格式器的名称。

suffix

这个字符串包含在附加到轮转日志的后缀中。后缀 的格式是句点(.)，后跟一个日期字符串，可以通过 SimpleDateFormat 类解析。

附加

如果设置为 true，则此处理程序编写的所有消息都将附加到 文件（如果已存在）。如果设置为 false，则每次应用服务器启动时都会创建一个新文件。

Autoflush

如果设置为 true，则日志消息将在接收时立即发送到分配的文件。

enabled

如果设置为 true，则处理程序将启用并正常运行。如果设置为 false，则在处理日志消息时会忽略处理程序。

编码

用于输出的字符编码方案。

file

代表此日志处理程序输出要写入的文件的对象。它有两个配置属性，即 relative-to 和 path。

filter

定义一个简单的过滤器类型。已弃用，以 filter-spec 替代。

filter-spec

定义过滤器的表达式值。以下表达式定义了一个与模式不匹配的过滤器： not (match ("WFLY resolved"))

formatter

此日志处理程序使用的日志格式器。

level

日志处理程序记录的最小日志消息级别。

max-backup-index

保留的最大轮转日志数。当达到这个数字时，会重复使用最旧的日志。默认值为 1。

如果使用 suffix 属性，轮转日志文件的后缀包含在轮转算法中。轮转日志文件时，名称以 名称+后缀 开头的最旧文件，剩余的轮转日志文件会递增，并且新轮转的日志文件指定了数字后缀 1。

名称

日志处理程序的名称。已弃用，因为处理程序的地址包含名称。

named-formatter

处理程序使用的定义格式器的名称。

rotate-on-boot

如果设置为 true，则在服务器重启时创建一个新的日志文件。默认值为 false。

rotate-size

日志文件在轮转前可以访问的最大大小。附加到数字的单个字符表示大小单位： b 表示字节，k 表示 KB，m 表示兆字节，g 表示千兆字节。例如： 50m 代表 50MB。

suffix

这个字符串包含在附加到轮转日志的后缀中。后缀 的格式是句点(.)，后跟一个日期字符串，可以通过 SimpleDateFormat 类解析。

附加

如果设置为 true，则此处理程序编写的所有消息都将附加到 文件（如果已存在）。如果设置为 false，则每次应用服务器启动时都会创建一个新文件。

Autoflush

如果设置为 true，则日志消息将在接收后立即发送到分配的文件。

enabled

如果设置为 true，则处理程序将启用并正常运行。如果设置为 false，则在处理日志消息时会忽略处理程序。

编码

用于输出的字符编码方案。

file

代表此日志处理程序输出要写入的文件的对象。它有两个配置属性，即 relative-to 和 path。

filter-spec

定义过滤器的表达式值。以下表达式定义了一个与模式不匹配的过滤器： not (match ("WFLY resolved"))

formatter

此日志处理程序使用的日志格式器。

level

日志处理程序记录的最小日志消息级别。

max-backup-index

保留的最大轮转日志数。当达到这个数字时，会重复使用最旧的日志。默认值为 1。

如果使用 suffix 属性，轮转日志文件的后缀包含在轮转算法中。轮转日志文件时，名称以 名称+后缀 开头的最旧文件，剩余的轮转日志文件会递增，并且新轮转的日志文件指定了数字后缀 1。

名称

日志处理程序的名称。已弃用，因为处理程序的地址包含名称。

named-formatter

处理程序使用的定义格式器的名称。

rotate-on-boot

如果设置为 true，则在服务器重启时创建一个新的日志文件。默认值为 false。

rotate-size

日志文件在轮转前可以访问的最大大小。附加到数字的单个字符表示大小单位： b 表示字节，k 表示 KB，m 表示兆字节，g 表示千兆字节。例如： 50m 代表 50MB。

suffix

这个字符串包含在附加到轮转日志的后缀中。后缀 的格式是句点(.)，后跟一个日期字符串，可以通过 SimpleDateFormat 类解析。

app-name

使用 RFC5424 格式格式化消息时使用的应用程序名称。默认情况下，应用名称为 java。

enabled

如果设置为 true，则处理程序将启用并正常运行。如果设置为 false，则在处理日志消息时会忽略处理程序。

facility

由 RFC-5424 和 RFC-3164 定义的工具。

hostname

发送消息的主机的名称。例如，应用服务器在其中运行的主机的名称。

level

日志处理程序记录的最小日志消息级别。

port

syslog 服务器侦听的端口。

server-address

syslog 服务器的地址。

syslog-format

根据 RFC 规格格式化日志消息。

named-formatter

格式化 syslog 有效负载的消息。使用此属性，您可以根据需要自定义消息。

Autoflush

在每次写入后是否自动清空。

block-on-reconnect

如果设置为 true，写入方法会在尝试重新连接时阻止。只有在使用异步处理程序时，才建议将其设置为 true。

enabled

如果设置为 true，则处理程序将启用并正常运行。如果设置为 false，则在处理日志消息时会忽略处理程序。

编码

此处理程序使用的字符编码

filter-spec

定义过滤器的表达式值。以下表达式定义了一个与模式不匹配的过滤器： not (match ("WFLY resolved"))

level

日志处理程序记录的最小日志消息级别。

named-formatter

处理程序使用的定义格式器的名称。

outbound-socket-binding-ref

对套接字连接的出站套接字绑定的引用。

protocol

套接字应与之通信的协议。允许的值有 TCP、UDP 或 SSL_TCP。

ssl-context

对定义的 SSL 上下文的引用。这仅在 协议 设置为 SSL_TCP 时使用。

class

要使用的日志记录处理程序类。

enabled

如果设置为 true，则处理程序将启用并正常运行。如果设置为 false，则在处理日志消息时会忽略处理程序。

编码

用于输出的字符编码方案。

filter

定义一个简单的过滤器类型。已弃用，以 filter-spec 替代。

filter-spec

定义过滤器的表达式值。以下表达式定义了一个与模式不匹配的过滤器： not (match ("WFLY resolved"))

formatter

此日志处理程序使用的日志格式器。

level

日志处理程序记录的最小日志消息级别。

module

日志记录处理程序依赖的模块。

名称

日志处理程序的名称。已弃用，因为处理程序的地址包含名称。

named-formatter

处理程序使用的定义格式器的名称。

属性

用于日志记录处理程序的属性。

enabled

如果设置为 true，则处理程序将启用并正常运行。如果设置为 false，则在处理日志消息时会忽略处理程序。

filter

定义一个简单的过滤器类型。已弃用，以 filter-spec 替代。

filter-spec

定义过滤器的表达式值。以下表达式定义了一个与模式不匹配的过滤器： not (match ("WFLY resolved"))

level

日志处理程序记录的最小日志消息级别。

名称

日志处理程序的名称。已弃用，因为处理程序的地址包含名称。

overflow-action

此处理程序在超过其队列长度时如何响应。这可以设置为 BLOCK 或 DISCARD。BLOCK 使日志记录应用等待，直到队列中存在可用空间。这与非async 日志处理程序的行为相同。DISCARD 允许日志记录应用继续，但日志消息已被删除。

queue-length

在等待子处理程序响应时此处理程序持有的最大日志消息数。

subhandlers

此 async 处理程序传递其日志消息的日志处理程序列表。