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

注意

这些表中的属性名称会在管理模型中出现时列出,例如使用管理 CLI 时。请参阅位于 EAP_HOME/docs/schema/jboss-as-logging_6_0.xsd 的架构定义文件,以查看 XML 中出现的元素,因为管理模型可能有所不同。

表 A.31. 控制台日志处理程序属性

属性描述

Autoflush

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

enabled

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

编码

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

filter

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

filter-spec

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

格式器

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

level

日志消息记录的最低日志级别。

name

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

named-formatter

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

目标

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

  • system.err :日志处理程序输出转至系统错误流。
  • system.out :日志处理程序输出转至标准输出流。
  • 控制台 :日志手输出转至 java.io.PrintWriter 类。

表 A.32. 文件日志处理程序属性

属性描述

附加

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

Autoflush

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

enabled

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

编码

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

file

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

filter

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

filter-spec

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

格式器

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

level

日志消息记录的最低日志级别。

name

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

named-formatter

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

表 A.33. 定期日志处理程序属性

属性描述

附加

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

Autoflush

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

enabled

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

编码

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

file

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

filter

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

filter-spec

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

格式器

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

level

日志消息记录的最低日志级别。

name

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

named-formatter

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

suffix

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

表 A.34. 日志处理程序属性大小

属性描述

附加

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

Autoflush

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

enabled

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

编码

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

file

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

filter

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

filter-spec

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

格式器

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

level

日志消息记录的最低日志级别。

max-backup-index

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

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

name

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

named-formatter

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

rotate-on-boot

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

rotate-size

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

suffix

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

表 A.35. 定期大小日志处理程序属性

属性描述

附加

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

Autoflush

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

enabled

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

编码

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

file

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

filter-spec

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

格式器

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

level

日志消息记录的最低日志级别。

max-backup-index

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

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

name

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

named-formatter

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

rotate-on-boot

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

rotate-size

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

suffix

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

表 A.36. 系统日志处理程序属性

属性描述

app-name

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

enabled

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

功能

RFC-5424 和 RFC-3164 定义的功能。

hostname

发送邮件的主机的名称。例如,运行应用服务器的主机的名称:

level

日志消息记录的最低日志级别。

port

syslog 服务器正在侦听的端口。

server-address

syslog 服务器的地址。

syslog-format

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

named-formatter

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

表 A.37. 套接字日志处理程序属性

属性描述

Autoflush

每次写入后是否自动刷新.

block-on-reconnect

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

enabled

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

编码

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

filter-spec

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

level

日志消息记录的最低日志级别。

named-formatter

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

outbound-socket-binding-ref

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

协议

套接字应通过该协议进行通信的协议。允许的值有 TCPUDPSSL_TCP

ssl-context

对定义的 SSL 上下文的引用。仅当 协议 设置为 SSL_TCP 时,才使用它。

表 A.38. 自定义日志处理程序属性

属性描述

class

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

enabled

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

编码

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

filter

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

filter-spec

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

格式器

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

level

日志消息记录的最低日志级别。

module

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

name

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

named-formatter

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

属性

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

表 A.39. Async 日志处理程序属性

属性描述

enabled

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

filter

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

filter-spec

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

level

日志消息记录的最低日志级别。

name

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

overflow-action

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

queue-length

此处理程序在等待子处理程序响应期间保存的日志消息的最大数量。

subhandlers

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