4.4. 日志记录配置集
日志记录配置集是独立的日志配置集合,可以分配给已部署的应用。与常规的 logging
子系统一样,日志记录配置文件可以定义处理程序、类别和根日志记录器,但它不能引用其他配置文件或主要 日志记录
子系统中的配置。日志配置文件的设计模仿 logging
子系统以方便配置。
通过日志记录配置文件,管理员可以创建专用于一个或多个应用的日志记录配置,而不影响任何其他日志配置。由于每个配置集都在服务器配置中定义,因此可以更改日志记录配置,而无需重新部署受影响的应用。
如需更多信息,请参阅 JBoss EAP 配置 指南中的配置日志配置文件。
每个日志记录配置集都可以有:
- 唯一的名称。此值是必需的。
- 任意数量的日志处理程序.
- 任何数量的日志类别。
- 最多一个根日志记录器.
应用可以使用 Logging-Profile
属性在其 MANIFEST.MF
文件中指定要使用的日志记录配置文件。
4.4.1. 在应用程序中指定日志配置集
应用指定要在其 MANIFEST.MF
文件中使用的日志配置集。
您必须知道服务器上设置的日志配置集的名称,供这个应用程序使用。
若要添加日志配置文件到应用,可编辑 MANIFEST.MF
文件。
如果您的应用程序没有
MANIFEST.MF
文件,请使用以下内容创建一个文件来指定日志记录配置文件名称:Manifest-Version: 1.0 Logging-Profile: LOGGING_PROFILE_NAME
如果您的应用程序已有
MANIFEST.MF
文件,请添加以下行来指定日志配置文件名称:Logging-Profile: LOGGING_PROFILE_NAME
如果您使用 Maven 和 maven-war-plugin
,请将 MANIFEST.MF
文件放在 src/main/resources/META-INF/
中,并将以下配置添加到 pom.xml
文件中:
<plugin> <artifactId>maven-war-plugin</artifactId> <configuration> <archive> <manifestFile>src/main/resources/META-INF/MANIFEST.MF</manifestFile> </archive> </configuration> </plugin>
部署应用时,它将将指定的日志记录配置文件中的配置用于其日志消息。
有关如何使用它配置日志配置文件和应用的示例,请参阅 JBoss EAP 配置指南中的日志配置文件配置示例 。