記錄

AEM可讓您設定：

• 中央記錄服務的全局參數
• 要求資料記錄；要求資訊的專用記錄設定
• 個別服務的特定設定；例如，日誌消息的單個日誌檔案和格式

這些都是OSGi配置。

全局日誌記錄

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

• 記錄級別
• 中央日誌檔案的位置
• 要保留的版本數
• 版本輪換；最大大小或時間間隔
• 寫入日誌消息時要使用的格式

個人服務的記錄器和寫入器

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

• 特定記錄級別
• 個別記錄檔的位置
• 要保留的版本數
• 版本輪換；最大大小或時間間隔
• 寫入日誌消息時要使用的格式
• 記錄器（提供記錄消息的OSGi服務）

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

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

1. OSGi服務（記錄器）寫入日誌消息。
2. 日誌記錄器​獲取此消息，並根據您的規範對其進行格式化。
3. 記錄寫入器​將所有這些消息寫入您已定義的物理檔案。

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

• 記錄器（記錄器）

  定義產生訊息的服務。

• 記錄檔（記錄檔）

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

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

• 日誌檔案（日誌寫入器）

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

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

標準記錄器和寫入器

標準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。

• 不連結到特定寫入程式，因此將建立並使用帶有預設配置的隱式寫入程式（每日日誌輪轉）。

建立自己的記錄器和寫入器

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

1. 建立Factory Configuration Apache Sling Logging Logger Configuration的新例項。

   1. 指定日誌檔案。
   2. 指定記錄器。
   3. 視需要設定其他參數。

2. 建立工廠配置Apache Sling Logging Writer Configuration的新實例。

   1. 指定日誌檔案 — 此檔案必須與為記錄器指定的檔案匹配。
   2. 視需要設定其他參數。