记录

AEM允许您配置：

• 中央日志记录服务的全局参数
• 请求数据记录；请求信息的专用日志记录配置
• 具体设置；例如，单个日志文件和日志消息的格式

这些都是OSGi配置。

全局日志记录

Apache Sling日志记 录配置用于配置根日志记录器。这定义了登录AEM的全局设置：

• 日志记录级别
• 中央日志文件的位置
• 要保留的版本数
• 版本旋转；最大大小或时间间隔
• 写入日志消息时使用的格式

个人服务的记录器和写入器

除了全局日志记录设置之外，AEM还允许您为单个服务配置特定设置：

• 特定日志记录级别
• 单个日志文件的位置
• 要保留的版本数
• 版本旋转；最大大小或时间间隔
• 写入日志消息时使用的格式
• 日志记录器（提供日志消息的OSGi服务）

这允许您将单项服务的日志消息传送到单独的文件中。 这在开发或测试时特别有用；例如，当您需要提高特定服务的日志级别时。

AEM使用以下方法将日志消息写入文件：

1. OSGi服务（日志记录器）写入日志消息。
2. 日志记录记录器​会获取此消息并根据您的规范对其进行格式化。
3. 日志记录写入器​将所有这些消息写入您定义的物理文件。

这些元素通过相应元素的以下参数进行链接：

• 记录器（日志记录器）

  定义生成消息的服务。

• 日志文件（日志记录器）

  定义用于存储日志消息的物理文件。

  用于将日志记录器与日志记录写入器链接。 该值必须与要建立连接的日志记录写入程序配置中的相同参数相同。

• 日志文件（日志记录写入程序）

  定义将写入日志消息的物理文件。

  此参数必须与日志记录写入器配置中的相同参数相同，否则将不进行匹配。 如果没有匹配项，则将使用默认配置（每日日志旋转）创建隐式写入器。

标准记录器和写入器

标准AEM安装中包含某些记录器和写入器。

第一个是特殊情况，因为它同时控制request.log和access.log文件：

• 日志记录器：

  • Apache Sling可自定义的请求数据记录器

    (org.apache.sling.engine.impl.log.RequestLoggerService)

  • 将有关请求内容的消息写入request.log。

• 链接到：

  • Apache Sling请求记录器

    (org.apache.sling.engine.impl.log.RequestLogger)

  • 将消息写入request.log或access.log。

虽然标准配置适用于大多数安装，但如有需要，也可以自定义这些配置。

其他对遵循标准配置：

• 日志记录器：

  • Apache Sling日志记录器配置

    (org.apache.sling.commons.log.LogManager.factory.config)

  • 将Information消息写入logs/error.log。

• 指向Writer的链接：

  • Apache Sling日志记录编写器配置

    (org.apache.sling.commons.log.LogManager.factory.writer)

• 日志记录器：

  • Apache Sling日志记录器配置
    (org.apache.sling.commons.log.LogManager.factory.config.649d51b7-6425-45c9-81e6-2697a03d6be7)

  • 将Warning消息写入../logs/error.log服务org.apache.pdfbox。

• 不链接到特定的编写器，因此将创建并使用默认配置（每日日志旋转）的隐式编写器。

创建您自己的记录器和作者

您可以定义自己的日志记录器/写入器对：

1. 创建工厂配置Apache Sling日志记录器配置的新实例。

   1. 指定日志文件。
   2. 指定日志记录器。
   3. 根据需要配置其他参数。

2. 创建工厂配置Apache Sling日志记录编写器配置的新实例。

   1. 指定日志文件 — 此文件必须与为记录器指定的文件相匹配。
   2. 根据需要配置其他参数。