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
创建日志记录配置文件。
/subsystem=logging/logging-profile=PROFILE_NAME:add创建 文件处理程序。
/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")
创建日志记录器类别。
/subsystem=logging/logging-profile=PROFILE_NAME/logger=CATEGORY_NAME:add(level=TRACE)
有关日志类别属性列表，请参阅 Log Category Attributes。
将文件处理程序分配到该类别。
/subsystem=logging/logging-profile=PROFILE_NAME/logger=CATEGORY_NAME:add-handler(name="FILE_HANDLER_NAME")
然后，您可以将日志记录配置集设置为由应用在其 MANIFEST.MF 文件中使用。如需更多信息，请参阅《JBoss EAP 开发指南 》中的应用指定日志配置文件。
