11.8.2. 日志记录配置集

日志记录配置集是独立的日志配置集合，可以分配给已部署的应用。与常规的 logging 子系统一样，日志记录配置文件可以定义处理程序、类别和根日志记录器，但它不能引用其他配置文件或主要 日志记录 子系统中的配置。日志配置文件的设计模仿 logging 子系统以方便配置。

通过日志记录配置文件，管理员可以创建专用于一个或多个应用的日志记录配置，而不影响任何其他日志配置。由于每个配置集都在服务器配置中定义，因此可以更改日志记录配置，而无需重新部署受影响的应用。

每个日志记录配置集都可以有：

  • 唯一的名称。此值是必需的。
  • 任意数量的日志处理程序.
  • 任何数量的日志类别。
  • 最多一个根日志记录器.

应用可以使用 Logging-Profile 属性在其 MANIFEST.MF 文件中指定要使用的日志记录配置文件。

11.8.2.1. 配置日志记录配置集

日志记录配置文件可以使用日志处理程序、类别和根日志记录器进行配置。配置日志记录配置集使用与配置 日志记录 子系统相同的语法，但以下不同之处除外：

  • 根配置路径为 /subsystem=logging/logging-profile=NAME。
  • 日志配置集无法包含其他日志配置集。

  • logging 子系统具有以下无法用于日志记录配置集的属性：

    • add-logging-api-dependencies
    • use-deployment-logging-config
创建和配置日志配置集

以下流程使用管理 CLI 创建日志记录配置集并设置文件处理程序和日志记录器类别。也可以使用管理控制台配置日志记录配置集，方法是导航到 Configuration → Subsystems → Logging → Logging Profiles。

  1. 创建日志记录配置文件。 

    /subsystem=logging/logging-profile=PROFILE_NAME:add

  2. 创建 文件处理程序。 

    /subsystem=logging/logging-profile=PROFILE_NAME/file-handler=FILE_HANDLER_NAME:add(file={path=>"LOG_NAME.log", "relative-to"=>"jboss.server.log.dir"})
    /subsystem=logging/logging-profile=PROFILE_NAME/file-handler=FILE_HANDLER_NAME:write-attribute(name="level", value="DEBUG")

    有关文件处理程序属性列表，请参阅文件日志处理程序属性列表。

  3. 创建日志记录器类别。 

    /subsystem=logging/logging-profile=PROFILE_NAME/logger=CATEGORY_NAME:add(level=TRACE)

    有关日志类别属性列表，请参阅 Log Category Attributes。

  4. 将文件处理程序分配到该类别。 

    /subsystem=logging/logging-profile=PROFILE_NAME/logger=CATEGORY_NAME:add-handler(name="FILE_HANDLER_NAME")

然后，您可以将日志记录配置集设置为由应用在其 MANIFEST.MF 文件中使用。如需更多信息，请参阅《JBoss EAP 开发指南 》中的应用指定日志配置文件。