記錄 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 Customized Request Data Logger
(org.apache.sling.engine.impl.log.RequestLoggerService)
-
將有關請求內容的消息寫入
request.log.
-
-
連結至：
-
Apache Sling Request Logger
(org.apache.sling.engine.impl.log.RequestLogger)
-
將消息寫入
request.log或access.log.
-
雖然標準配置適用於大多數安裝，但您仍可視需要自定義這些配置。
其他配對會遵循標準設定：
-
記錄器：
-
Apache Sling Logging Logger Configuration
(org.apache.sling.commons.log.LogManager.factory.config)
-
寫入
Information訊息logs/error.log.
-
-
Writer連結：
-
Apache Sling Logging Writer設定
(org.apache.sling.commons.log.LogManager.factory.writer)
-
-
記錄器：
-
Apache Sling Logging Logger Configuration(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 Logging Logger Configuration.
- 指定日誌檔案。
- 指定記錄器。
- 視需要設定其他參數。
-
建立工廠配置的新實例 Apache Sling Logging Writer設定.
- 指定日誌檔案 — 此檔案必須與為記錄器指定的檔案匹配。
- 視需要設定其他參數。