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.*")）`
formatter	此日志处理程序使用的日志格式器。
level	日志消息记录的最低日志级别。
name	日志处理程序的名称。弃用，因为处理程序的地址包含名称。
named-formatter	处理程序上要使用的已定义格式器名称。
目标	发送日志处理程序输出的系统输出流。可以是以下之一： `system.err` ：日志处理程序输出转至系统错误流。 `system.out` ：日志处理程序输出转至标准输出流。 `控制台` ：日志手输出转至 `java.io.PrintWriter` 类。

表 A.32. 文件日志处理程序属性
属性	描述
附加	如果设置为 `true，则` 此处理程序编写的所有消息都会附加到文件（如果它已存在）。如果设置为 `false`，则每次应用服务器启动时都会创建一个新文件。
autoflush	如果设为 `true`，则日志消息会在收到后立即发送到分配的处理程序。
enabled	如果设为 `true`，处理程序将正常启用并正常运行。如果设置为 `false`，则处理日志消息时会忽略处理程序。
编码	用于输出的字符编码方案。
file	代表将此日志处理程序的输出写入的文件的对象。它有两个配置属性： `relative-to` 和 `path`。
filter	定义简单的过滤器类型。弃用了 `filter-spec`。
filter-spec	定义过滤器的表达式值。以下表达式定义了一个不匹配模式的过滤器：not `（match("WFLY.*")）`
formatter	此日志处理程序使用的日志格式器。
level	日志消息记录的最低日志级别。
name	日志处理程序的名称。弃用，因为处理程序的地址包含名称。
named-formatter	处理程序上要使用的已定义格式器名称。

表 A.33. 定期日志处理程序属性
属性	描述
附加	如果设置为 `true，则` 此处理程序编写的所有消息都会附加到文件（如果它已存在）。如果设置为 `false`，则每次应用服务器启动时都会创建一个新文件。
autoflush	如果设为 `true`，则日志消息会在收到后立即发送到分配的处理程序。
enabled	如果设为 `true`，处理程序将正常启用并正常运行。如果设置为 `false`，则处理日志消息时会忽略处理程序。
编码	用于输出的字符编码方案。
file	代表此日志处理程序输出所写入的文件的对象。它有两个配置属性： `relative-to` 和 `path`。
filter	定义简单的过滤器类型。弃用了 `filter-spec`。
filter-spec	定义过滤器的表达式值。以下表达式定义了一个不匹配模式的过滤器：not `（match("WFLY.*")`。
formatter	此日志处理程序使用的日志格式器。
level	日志消息记录的最低日志级别。
name	日志处理程序的名称。弃用，因为处理程序的地址包含名称。
named-formatter	处理程序上要使用的已定义格式器名称。
suffix	此字符串包含在附加到轮转日志的后缀中。`后缀` 的格式是点(`.`)，后跟一个日期字符串，它可以被 `SimpleDateFormat` 类解析。

表 A.34. 日志处理程序属性大小
属性	描述
附加	如果设置为 `true，则` 此处理程序编写的所有消息都会附加到文件（如果它已存在）。如果设置为 `false`，则每次应用服务器启动时都会创建一个新文件。
autoflush	如果设为 `true`，则日志消息将在收到后立即发送到分配的处理程序。
enabled	如果设为 `true`，处理程序将正常启用并正常运行。如果设置为 `false`，则处理日志消息时会忽略处理程序。
编码	用于输出的字符编码方案。
file	代表写入此日志处理程序的输出的文件的对象。它有两个配置属性： `relative-to` 和 `path`。
filter	定义简单的过滤器类型。弃用了 `filter-spec`。
filter-spec	定义过滤器的表达式值。以下表达式定义了一个不匹配模式的过滤器：not `（match("WFLY.*")）`
formatter	此日志处理程序使用的日志格式器。
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-to` 和 `path`。
filter-spec	定义过滤器的表达式值。以下表达式定义了一个不匹配模式的过滤器：not `（match("WFLY.*")）`
formatter	此日志处理程序使用的日志格式器。
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. Syslog Handler Attributes
属性	描述
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	对套接字连接的出站套接字绑定的引用。
协议	套接字应通过该协议进行通信的协议。允许的值有 `TCP`、`UDP` 或 `SSL_TCP`。
ssl-context	对定义的 SSL 上下文的引用。仅当 `协议` 设置为 `SSL_TCP` 时，才使用它。

表 A.38. 自定义日志处理程序属性
属性	描述
class	要使用的日志记录处理程序类。
enabled	如果设为 `true`，处理程序将正常启用并正常运行。如果设置为 `false`，则处理日志消息时会忽略处理程序。
编码	用于输出的字符编码方案。
filter	定义简单的过滤器类型。弃用了 `filter-spec`。
filter-spec	定义过滤器的表达式值。以下表达式定义了一个不匹配模式的过滤器：not `（match("WFLY.*")）`
formatter	此日志处理程序使用的日志格式器。
level	日志消息记录的最低日志级别。
module	日志记录处理程序所依赖的模块。
name	日志处理程序的名称。弃用，因为处理程序的地址包含名称。
named-formatter	处理程序上要使用的已定义格式器名称。
属性	用于日志记录处理程序的属性。

表 A.39. Async 日志处理程序属性
属性	描述
enabled	如果设为 `true`，处理程序将正常启用并正常运行。如果设置为 `false`，则处理日志消息时会忽略处理程序。
filter	定义简单的过滤器类型。弃用了 `filter-spec`。
filter-spec	定义过滤器的表达式值。以下表达式定义了一个不匹配模式的过滤器：not `（match("WFLY.*")）`
level	日志消息记录的最低日志级别。
name	日志处理程序的名称。弃用，因为处理程序的地址包含名称。
overflow-action	此处理程序在超出其队列长度时如何响应。这可以设置为 `BLOCK` 或 `DISCARD`。`BLOCK` 使日志记录应用等待直到队列中存在可用空间。这与非同步日志处理程序的行为相同。`DISCARD` 允许日志记录应用继续，但日志消息已被删除。
queue-length	此处理程序在等待子处理程序响应期间保存的日志消息的最大数量。
subhandlers	此异步处理程序传递其日志消息的日志处理程序列表。

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

© 2024 Red Hat, Inc.