日志记录 logging
AEM允许您配置:
- 中央日志记录服务的全局参数
- 请求数据记录;请求信息的专用日志记录配置
- 具体设置;例如,单个日志文件和日志消息的格式
这些都 OSGi配置.
全局日志记录 global-logging
Apache Sling日志记录配置 用于配置根日志记录器。 这定义了登录AEM的全局设置:
- 日志记录级别
- 中央日志文件的位置
- 要保留的版本数
- 版本旋转;最大大小或时间间隔
- 写入日志消息时使用的格式
个人服务的记者和作家 loggers-and-writers-for-individual-services
除了全局日志记录设置之外,AEM还允许您为单个服务配置特定设置:
- 特定日志记录级别
- 单个日志文件的位置
- 要保留的版本数
- 版本旋转;最大大小或时间间隔
- 写入日志消息时使用的格式
- 日志记录器(提供日志消息的OSGi服务)
这允许您将单项服务的日志消息传送到单独的文件中。 这在开发或测试时特别有用;例如,当您需要提高特定服务的日志级别时。
AEM使用以下方法将日志消息写入文件:
- 安 OSGi服务 (记录器)写入日志消息。
- A 日志记录器 根据您的规范获取并设置此消息的格式。
- A 日志记录器 将所有这些消息写入您定义的物理文件。
这些元素通过相应元素的以下参数进行链接:
-
记录器(日志记录器)
定义生成消息的服务。
-
日志文件(日志记录器)
定义用于存储日志消息的物理文件。
用于将日志记录器与日志记录写入器链接。 该值必须与要建立连接的日志记录写入程序配置中的相同参数相同。
-
日志文件(日志记录写入程序)
定义将写入日志消息的物理文件。
此参数必须与日志记录写入器配置中的相同参数相同,否则将不进行匹配。 如果没有匹配项,则将使用默认配置(每日日志旋转)创建隐式写入器。
标准记事员和作家 standard-loggers-and-writers
标准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
.
-
-
不链接到特定的编写器,因此将创建并使用默认配置(每日日志旋转)的隐式编写器。
创建您自己的记事员和作家 creating-your-own-loggers-and-writers
您可以定义自己的日志记录器/写入器对:
-
创建工厂配置的新实例 Apache Sling日志记录器配置.
- 指定日志文件。
- 指定日志记录器。
- 根据需要配置其他参数。
-
创建工厂配置的新实例 Apache Sling日志记录编写器配置.
- 指定日志文件 — 此文件必须与为记录器指定的文件相匹配。
- 根据需要配置其他参数。