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。

流程

  1. 使用以下命令添加日志类别:

    /subsystem=logging/logger=LOG_CATEGORY:add
    Copy to Clipboard Toggle word wrap
  2. 您可以根据您的需要设置一个或多个日志类别属性:

    • 使用以下命令为日志类别设置日志级别:

      /subsystem=logging/logger=LOG_CATEGORY:write-attribute(name=level,value=LEVEL)
      Copy to Clipboard Toggle word wrap

      默认值为 ALL

    • 使用以下命令设置此类别是否应使用根日志记录器的日志处理程序:

      /subsystem=logging/logger=LOG_CATEGORY:write-attribute(name=use-parent-handlers,value=USE_PARENT_HANDLERS)
      Copy to Clipboard Toggle word wrap

      默认情况下,除了它们自己的外,日志类别还使用根日志记录器的处理程序。将 use-parent-handlers 属性设置为 false,以确保日志类别仅使用其分配的处理程序。

    • 使用以下命令设置过滤器表达式:

      /subsystem=logging/logger=LOG_CATEGORY:write-attribute(name=filter-spec, value=FILTER_EXPRESSION)
      Copy to Clipboard Toggle word wrap

      指定表达式来过滤日志类别的日志消息。转义任何逗号和引号,并使用引号括起表达式。例如,将 FILTER_EXPRESSION 变量替换为 "not (match (\"WFLY\") ) ",以设置 not (match ("WFLY")的过滤器表达式

10.4.2. 分配日志处理程序并管理日志类别

JBoss EAP 中的日志处理程序控制如何处理和记录日志消息以进行日志类别。将日志处理程序分配到特定的日志类别,以根据您的应用需求自定义日志记录行为。您也可以在不再需要时删除日志类别,保持日志记录配置组织和效率。

先决条件

  • JBoss EAP 正在运行。
  • 您可以访问管理 CLI。

流程

  1. 使用以下命令,为日志类别分配一个日志处理程序:

    /subsystem=logging/logger=LOG_CATEGORY:add-handler(name=LOG_HANDLER_NAME)
    Copy to Clipboard Toggle word wrap
  2. 如果需要,您可以使用以下命令使用 remove 操作来删除日志类别:

    /subsystem=logging/logger=LOG_CATEGORY:remove
    Copy to Clipboard Toggle word wrap
    注意

    当日志记录配置不再需要时,您可以删除日志类别。

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2025 Red Hat