記錄

AEM可讓您設定:

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

這些都是OSGi配置

注意

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

全局日誌記錄

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

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

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

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

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

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

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

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

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

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

  • 記錄器(記錄器)

    定義產生訊息的服務。

  • 記錄檔(記錄檔)

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

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

  • 日誌檔案(日誌寫入器)

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

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

標準記錄器和寫入器

標準AEM安裝中包含某些記錄器和寫入程式。

第一個是特殊情況,因為它同時控制request.logaccess.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.logaccess.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.pdfboxWarning消息寫入../logs/error.log

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

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

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

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

    1. 指定日誌檔案。
    2. 指定記錄器。
    3. 視需要設定其他參數。
  2. 建立工廠配置Apache Sling Logging Writer Configuration的新實例。

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

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

本頁內容