11.5. 配置日志处理程序
日志处理程序定义如何记录捕获的日志消息。有关配置您需要的日志处理程序类型,请参见相应的部分。
11.5.1. 配置控制台日志处理程序
					本节介绍如何使用管理 CLI 配置控制台日志处理程序。您还可以使用管理控制台配置控制台日志处理程序,方法是导航到 Configuration 
在配置控制台日志处理程序时要执行的主要任务有:
						如果您要为日志记录配置集配置此日志处理程序,则命令的开头为 /subsystem=logging/logging-profile=LOGGING_PROFILE_NAME/ 而不是 /subsystem=logging/。
					
						此外,如果您在受管域中运行,请在命令前加上 /profile=PROFILE_NAME。
					
添加控制台日志处理程序
/subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:add
/subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:add配置控制台日志处理程序设置
根据您的需要,您可能需要设置以下一个或多个控制台日志处理程序属性:有关可用控制台日志处理程序属性及其描述的完整列表,请参阅 Console Log Handler Attributes。
- 设置日志级别。 - 为处理程序设置适当的日志级别。默认值为 - ALL。有关所有可用选项,请参阅日志级别。- /subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=level,value=LEVEL) - /subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=level,value=LEVEL)- Copy to Clipboard Copied! - Toggle word wrap Toggle overflow 
- 设置目标。 - 设置处理程序的目标,可以是 - System.out、System- .err或- console之一。默认值为- System.out。- /subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=target,value=TARGET) - /subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=target,value=TARGET)- Copy to Clipboard Copied! - Toggle word wrap Toggle overflow 
- 设置编码. - 设置处理程序的编码,如 - 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=encoding,value=ENCODING)- Copy to Clipboard Copied! - Toggle word wrap Toggle overflow 
- 设置日志格式器。 - 设置处理程序的格式字符串。例如,默认格式字符串为 - %d{HH:mm:ss,SSS} %-5p [%c](%t)%s%e%n。务必在引号中包含- FORMAT值。- /subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=formatter,value=FORMAT) - /subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=formatter,value=FORMAT)- Copy to Clipboard Copied! - Toggle word wrap Toggle overflow 注意- 如果要引用 保存的格式器,请使用 - named-formatter属性。
- 设置自动刷新. - 设置是否在每次写入后自动清空。默认值为 - true。- /subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=autoflush,value=AUTO_FLUSH) - /subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=autoflush,value=AUTO_FLUSH)- Copy to Clipboard Copied! - Toggle word wrap Toggle overflow 
- 设置过滤器表达式。 - 设置表达式,以过滤处理程序的日志消息。务必用引号转义任何逗号和引号。例如,对于过滤器表达式 - not- (match("WFLY"),需要将以下WFLY\")"。- FILTER_EXPRESSION可替换变量替换为"not(match(\"- /subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION) - /subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)- Copy to Clipboard Copied! - Toggle word wrap Toggle overflow - 有关可用过滤器表达式的更多信息,请参阅 Filter Expressions 部分。 
将控制台日志处理程序分配给日志记录器
要激活日志处理程序,您必须将其分配到日志记录器。
以下管理 CLI 命令将控制台日志处理程序分配到根日志记录器:
/subsystem=logging/root-logger=ROOT:add-handler(name=CONSOLE_HANDLER_NAME)
/subsystem=logging/root-logger=ROOT:add-handler(name=CONSOLE_HANDLER_NAME)
					以下管理 CLI 命令将控制台日志处理程序分配到其名称由 CATEGORY 指定的日志记录器:
				
/subsystem=logging/logger=CATEGORY:add-handler(name=CONSOLE_HANDLER_NAME)
/subsystem=logging/logger=CATEGORY:add-handler(name=CONSOLE_HANDLER_NAME)删除控制台日志处理程序
					可以使用 remove 操作移除日志处理程序。如果当前分配给日志记录器或异步日志处理程序,则无法移除日志处理程序。
				
/subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:remove
/subsystem=logging/console-handler=CONSOLE_HANDLER_NAME:remove