記錄

AEM可讓您設定：

這些都是OSGi配置。

注意

登入AEM是根據Sling原則。如需詳細資訊，請參閱Sling記錄。

全局日誌記錄

Apache Sling Logging Configuration是用來設定根記錄器。這會定義登入AEM的全域設定：

注意

本知識庫文章說明如何旋轉request.log和access.log檔案。

除了全域記錄設定外，AEM還可讓您設定個別服務的特定設定：

這可讓您將單一服務的記錄訊息通道至個別檔案。這在開發或測試時特別有用；例如，當您需要為特定服務增加日誌級別時。

AEM使用下列方式將記錄訊息寫入檔案：

這些元素會透過下列參數連結至適當的元素：

記錄器（記錄器）

定義產生訊息的服務。
記錄檔（記錄檔）

定義用於儲存日誌消息的物理檔案。

這用於將記錄器與記錄寫入器連結。該值必須與要建立連接的日誌記錄寫入器配置中的相同參數相同。
日誌檔案（日誌寫入器）

定義將寫入日誌消息的物理檔案。

這必須與記錄寫入程式配置中的相同參數相同，否則不會進行匹配。如果沒有匹配項，則將使用預設配置（每日日誌旋轉）建立隱式寫入器。

標準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)
- 為服務org.apache.pdfbox將Warning消息寫入../logs/error.log。
不連結到特定寫入程式，因此將建立並使用帶有預設配置的隱式寫入程式（每日日誌輪轉）。

您可以定義自己的記錄器/寫入器組：

建立Factory Configuration Apache Sling Logging Logger Configuration的新例項。
1. 指定日誌檔案。
2. 指定記錄器。
3. 視需要設定其他參數。
建立工廠配置Apache Sling Logging Writer Configuration的新實例。
1. 指定日誌檔案 — 此檔案必須與為記錄器指定的檔案匹配。
2. 視需要設定其他參數。

注意

在某些情況下，您可能想要建立自訂記錄檔。