12.4. 配置日志条目
本节介绍如何使用管理 CLI 配置日志类别。您还可以通过从 Configuration 选项卡导航到 Logging 子系统并选择 Log Categories 选项卡,来使用管理控制台配置日志类别。
配置日志类别需要执行的主要任务有:
如果您要为日志记录配置集配置此日志类别,命令的启动将是 /subsystem=logging/logging-profile=LOGGING_PROFILE_NAME/
而不是 /subsystem=logging/
。
另外,如果您在受管域中运行,请在命令前使用 /profile=PROFILE_NAME
。
添加日志类别
日志类别名称由 origin 的 Java 软件包定义。来自该软件包中的类的消息将被捕获,只要它们遵循其他设置,例如日志级别。
/subsystem=logging/logger=LOG_CATEGORY:add
配置日志类别设置
根据您的需要,您可能需要设置以下一个或多个日志类别属性。有关可用日志类别属性及其描述的完整列表,请参阅 日志类别属性。
设置日志级别。
为日志类别设置适当的日志级别。默认值为
ALL
。有关所有可用选项 的日志级别,请参阅日志级别。/subsystem=logging/logger=LOG_CATEGORY:write-attribute(name=level,value=LEVEL)
设置此类别是否应该使用根日志记录器的日志处理程序。
默认情况下,日志类别除了自己的外,还将使用根日志记录器的处理程序。如果日志类别应使用其分配的处理程序,则将
use-parent-handlers
属性设置为false
。/subsystem=logging/logger=LOG_CATEGORY:write-attribute(name=use-parent-handlers,value=USE_PARENT_HANDLERS)
设置过滤器表达式。
设置过滤日志类别的日志消息的表达式。务必转义任何逗号和引号,并用引号括起来。例如,以下
FILTER_EXPRESSION
可替换变量需要替换为"not (match (\"WFLY\")) ",
用于不匹配("WFLY"))的过滤器表达式
。/subsystem=logging/logger=LOG_CATEGORY:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)
有关可用过滤器表达式的更多信息,请参阅 Filter Expressions 部分。
分配处理程序
为日志类别分配日志处理程序。
/subsystem=logging/logger=LOG_CATEGORY:add-handler(name=LOG_HANDLER_NAME)
删除日志类别
可以通过 remove
操作删除日志类别。
/subsystem=logging/logger=LOG_CATEGORY:remove