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


Expand
表 A.23. 控制台日志处理程序属性
属性描述

Autoflush

如果设置为 true,则在接收后立即将日志消息发送到分配的处理程序。

enabled

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

编码

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

filter

定义一个简单的过滤器类型。弃用了 filter-spec

filter-spec

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

formatter

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

level

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

name

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

named-formatter

处理程序中使用的定义的 formatter 的名称。

target

日志处理程序的输出所发生的系统输出流。这可以是 system.err 或 System.out 用于系统错误流或标准流。

Expand
表 A.24. 文件日志处理程序属性
属性描述

附加

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

Autoflush

如果设置为 true,则在接收后立即将日志消息发送到分配的处理程序。

enabled

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

编码

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

file

代表此日志处理程序输出写入到的文件的对象。它有两个配置属性,即 relative-topath

filter

定义一个简单的过滤器类型。弃用了 filter-spec

filter-spec

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

formatter

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

level

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

name

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

named-formatter

处理程序中使用的定义的 formatter 的名称。

Expand
表 A.25. 定期日志处理程序属性
属性描述

附加

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

Autoflush

如果设置为 true,则在接收后立即将日志消息发送到分配的处理程序。

enabled

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

编码

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

file

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

filter

定义一个简单的过滤器类型。弃用了 filter-spec

filter-spec

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

formatter

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

level

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

name

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

named-formatter

处理程序中使用的定义的 formatter 的名称。

suffix

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

Expand
表 A.26. 大小日志处理程序属性
属性描述

附加

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

Autoflush

如果设置为 true,则日志消息将在接收后立即发送到分配的处理程序。

enabled

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

编码

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

file

代表此日志处理程序输出写入到的文件的对象。它有两个配置属性,即 relative-topath

filter

定义一个简单的过滤器类型。弃用了 filter-spec

filter-spec

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

formatter

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

level

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

max-backup-index

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

如果使用 suffix 属性,则轮转日志文件的后缀包含在轮转算法中。当轮转日志文件时,名称以 名称+后缀 开头的最旧的文件会被删除,其余的轮转日志文件会递增其数字后缀,并且新轮转的日志文件被授予数字后缀 1

name

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

named-formatter

处理程序中使用的定义的 formatter 的名称。

rotate-on-boot

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

rotate-size

日志文件在轮转前可以达到的最大大小。附加到数字中的单个字符表示大小单位: b 表示字节,k 表示 KB,m 表示 MB,g 表示 GB。例如,50MB 为 50m

suffix

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

Expand
表 A.27. 定期大小日志处理程序属性
属性描述

附加

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

Autoflush

如果设置为 true,则在接收后立即将日志消息发送到分配的处理程序。

enabled

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

编码

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

file

代表此日志处理程序输出写入到的文件的对象。它有两个配置属性,即 relative-topath

filter-spec

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

formatter

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

level

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

max-backup-index

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

如果使用 suffix 属性,则轮转日志文件的后缀包含在轮转算法中。当轮转日志文件时,名称以 名称+后缀 开头的最旧的文件会被删除,其余的轮转日志文件会递增其数字后缀,并且新轮转的日志文件被授予数字后缀 1

name

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

named-formatter

处理程序中使用的定义的 formatter 的名称。

rotate-on-boot

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

rotate-size

日志文件在轮转前可以达到的最大大小。附加到数字中的单个字符表示大小单位: b 表示字节,k 表示 KB,m 表示 MB,g 表示 GB。例如,50MB 为 50m

suffix

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

Expand
表 A.28. syslog Handler 属性
属性描述

app-name

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

enabled

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

facility

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

hostname

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

level

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

port

syslog 服务器侦听的端口。

server-address

syslog 服务器的地址。

syslog-format

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

Expand
表 A.29. 自定义日志处理程序属性
属性描述

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

enabled

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

编码

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

filter

定义一个简单的过滤器类型。弃用了 filter-spec

filter-spec

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

formatter

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

level

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

module

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

name

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

named-formatter

处理程序中使用的定义的 formatter 的名称。

属性

日志处理程序使用的属性。

Expand
表 A.30. async 日志处理程序属性
属性描述

enabled

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

filter

定义一个简单的过滤器类型。弃用了 filter-spec

filter-spec

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

level

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

name

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

overflow-action

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

queue-length

在等待子处理程序响应时,此处理程序将保留的最大日志消息数。

subhandlers

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

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat