11.4. 配置日志类别

本节介绍如何使用管理 CLI 配置日志类别。您还可以使用管理控制台配置日志类别,方法是导航到 ConfigurationSubsystemsLoggingConfiguration,点 View,然后选择 Categories

在配置日志类别时要执行的主要任务有:

重要

如果您要为日志记录配置集配置此日志类别,则命令的开头为 /subsystem=logging/logging-profile=LOGGING_PROFILE_NAME/ 而不是 /subsystem=logging/

此外,如果您在受管域中运行,请在命令前加上 /profile=PROFILE_NAME

添加日志类别

日志类别名称由 Java 原始软件包定义。来自该软件包中类的消息将捕获,只要它们遵循其他设置,例如日志级别。

/subsystem=logging/logger=LOG_CATEGORY:add

配置日志类别设置

根据您的需要,您可能需要设置一个或多个以下日志类别属性:有关可用日志类别属性及其描述的完整列表,请参阅 Log Category Attributes

  • 设置日志级别。

    为日志级别设置适当的日志级别。默认值为 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)
  • 设置过滤器表达式。

    设置表达式,以过滤日志类别的日志消息。务必用引号转义任何逗号和引号。例如,对于过滤器表达式 not (match("WFLY"),需要将以下 FILTER_EXPRESSION 可替换变量替换为"not(match(\" 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