記錄 logging
AEM可讓您設定：
- 中央記錄服務的全域引數
- 請求資料記錄；請求資訊的專用記錄設定
- 個別服務的特定設定；例如，個別記錄檔和記錄訊息的格式
這些都是OSGi設定。
全域記錄 global-logging
Apache Sling記錄設定是用來設定根記錄器。 這會定義登入AEM的全域設定：
- 記錄層級
- 中央記錄檔的位置
- 要保留的版本數量
- 版本輪換；大小上限或時間間隔
- 寫入記錄訊息時要使用的格式
個別服務的記錄器與寫入器 loggers-and-writers-for-individual-services
除了全域記錄設定外，AEM還可讓您設定個別服務的特定設定：
- 特定記錄層級
- 個別記錄檔的位置
- 要保留的版本數量
- 版本輪換；大小上限或時間間隔
- 寫入記錄訊息時要使用的格式
- 記錄器（提供記錄訊息的OSGi服務）
這可讓您將單一服務的記錄訊息通道化為個別檔案。 這在開發或測試期間可能特別有用；例如，當您需要針對特定服務增加記錄層級時。
AEM會使用以下專案將記錄訊息寫入檔案：
- OSGi服務 （記錄器）寫入記錄訊息。
- 記錄記錄器 會接收此訊息，並根據您的規格設定其格式。
- 記錄寫入器 會將所有這些訊息寫入您已定義的實體檔案中。
這些元素由適當元素的下列引數連結：
-
記錄器（記錄記錄器）
定義產生訊息的服務。
-
記錄檔（記錄記錄記錄器）
定義儲存日誌訊息的實體檔案。
這可用來將記錄記錄器連結至記錄寫入器。 值必須與記錄寫入器組態中的相同引數相同，才能建立連線。
-
記錄檔（記錄寫入器）
定義將寫入日誌訊息的實體檔案。
這必須與記錄寫入器設定中的相同引數相同，否則將無法進行比對。 如果沒有相符專案，則會使用預設設定（每日記錄輪換）建立隱含的Writer。
標準記錄器與寫入器 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。
-
-
寫入器的連結：
-
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) -
將服務
org.apache.pdfbox的Warning個訊息寫入../logs/error.log。
-
-
未連結至特定寫入器，因此會建立並使用具有預設組態（每日記錄輪換）的隱含寫入器。
建立自己的記錄器和寫入器 creating-your-own-loggers-and-writers
您可以定義自己的記錄器/寫入器配對：
-
建立Factory設定Apache Sling記錄記錄器設定的執行個體。
- 指定記錄檔。
- 指定記錄器。
- 視需要設定其他引數。
-
建立Factory設定Apache Sling記錄寫入器設定的執行個體。
- 指定記錄檔 — 這必須符合為記錄器指定的記錄檔。
- 視需要設定其他引數。