10.4. 配置日志类别
您可以使用管理 CLI 在 JBoss EAP 中配置日志类别。或者,您可以通过管理控制台配置它们,导航到 Configuration > Subsystems > Logging > Configuration,点 View,然后选择 Categories。
您可以执行以下任务来配置日志类别:
如果您为日志记录配置集配置此日志类别,请使用 /subsystem=logging/logging-profile=LOGGING_PROFILE_NAME/
而不是 /subsystem=logging/
来启动该命令。
另外,如果您在受管域中运行,请在命令前面加上 /profile=PROFILE_NAME
。
10.4.1. 使用管理 CLI 添加和配置日志类别 复制链接链接已复制到粘贴板!
日志类别名称是原始的 Java 软件包。但是,日志记录器可以根据您的要求使用任何字符串名称。如需更多信息,请参阅 Java 日志记录 API 文档。如果来自该软件包中的类的信息符合其他设置(如日志级别),则会捕获来自该软件包的消息。
先决条件
- JBoss EAP 正在运行。
- 您可以访问管理 CLI。
流程
使用以下命令添加日志类别:
/subsystem=logging/logger=LOG_CATEGORY:add
/subsystem=logging/logger=LOG_CATEGORY:add
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 您可以根据您的需要设置一个或多个日志类别属性:
使用以下命令为日志类别设置日志级别:
/subsystem=logging/logger=LOG_CATEGORY:write-attribute(name=level,value=LEVEL)
/subsystem=logging/logger=LOG_CATEGORY:write-attribute(name=level,value=LEVEL)
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 默认值为
ALL
。使用以下命令设置此类别是否应使用根日志记录器的日志处理程序:
/subsystem=logging/logger=LOG_CATEGORY:write-attribute(name=use-parent-handlers,value=USE_PARENT_HANDLERS)
/subsystem=logging/logger=LOG_CATEGORY:write-attribute(name=use-parent-handlers,value=USE_PARENT_HANDLERS)
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 默认情况下,除了它们自己的外,日志类别还使用根日志记录器的处理程序。将
use-parent-handlers
属性设置为false
,以确保日志类别仅使用其分配的处理程序。使用以下命令设置过滤器表达式:
/subsystem=logging/logger=LOG_CATEGORY:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)
/subsystem=logging/logger=LOG_CATEGORY:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 指定表达式来过滤日志类别的日志消息。转义任何逗号和引号,并使用引号括起表达式。例如,将
FILTER_EXPRESSION
变量替换为"not (match (\"WFLY\")
) ",以设置not (match ("WFLY")的过滤器表达式
。
后续步骤
10.4.2. 分配日志处理程序并管理日志类别 复制链接链接已复制到粘贴板!
JBoss EAP 中的日志处理程序控制如何处理和记录日志消息以进行日志类别。将日志处理程序分配到特定的日志类别,以根据您的应用需求自定义日志记录行为。您也可以在不再需要时删除日志类别,保持日志记录配置组织和效率。
先决条件
- JBoss EAP 正在运行。
- 您可以访问管理 CLI。
流程
使用以下命令,为日志类别分配一个日志处理程序:
/subsystem=logging/logger=LOG_CATEGORY:add-handler(name=LOG_HANDLER_NAME)
/subsystem=logging/logger=LOG_CATEGORY:add-handler(name=LOG_HANDLER_NAME)
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 如果需要,您可以使用以下命令使用
remove
操作来删除日志类别:/subsystem=logging/logger=LOG_CATEGORY:remove
/subsystem=logging/logger=LOG_CATEGORY:remove
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注意当日志记录配置不再需要时,您可以删除日志类别。