記錄

AEM提供您設定：

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

這些都是OSGi配置。

注意

登入AEM是以Sling原則為基礎。 如需詳細資訊，請參閱Sling Logging。

全局記錄

Apache Sling Logging Configurationis used to configure the root logger.這會定義登入AEM的全域設定：

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

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

個別服務的記錄員和寫入者

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

  • 特定記錄級別
  • 單個日誌檔案的位置
  • 要保存的版本數
  • 版本輪換；最大大小或時間間隔
  • 寫入日誌消息時使用的格式
  • the logger(the OSGi service suppliding the log messages)

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

AEM使用下列功能將記錄訊息寫入檔案：

  1. OSGi服務（記錄器）寫入日誌消息。
  2. Logging Logger​會擷取此訊息，並根據您的規格設定其格式。
  3. 記錄寫入器​將所有這些消息寫入已定義的物理檔案。

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

  • Logger(Logging Logger)

    定義生成消息的服務。

  • 記錄檔（記錄檔）

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

    This is used to link a Logging Logger with a Logging Writer. 該值必須與要建立的連接的記錄寫入器配置中的相同參數相同。

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

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

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

標準記錄程式和寫入程式

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

第一個是特殊情況，因為它同時控制request.log和access.log檔案：

  • The Logger:

    • 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。

如果需要，可自訂這些設定，但標準組態適合大部分安裝。

其他配對遵循標準配置：

  • The Logger:

    • Apache Sling Logging Logger Configuration

      (org.apache.sling.commons.log.LogManager.factory.config)

    • 將Information消息寫入logs/error.log。

  • Links to the Writer:

    • Apache Sling Logging Writer Configuration

      (org.apache.sling.commons.log.LogManager.factory.writer)

  • The Logger:

    • 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。

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

建立您自己的記錄程式和寫入程式

您可以定義自己的記錄器／寫入器對：

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

    1. 指定「記錄檔」。
    2. 指定記錄器。
    3. 視需要設定其他參數。

  2. 建立Factory Configuration Apache Sling Logging Writer Configuration的新例項。

    1. 指定Log File - this must match that specified for the Logger.
    2. 視需要設定其他參數。
注意

在某些情況下，您可能希望建立自定義日誌檔案。

本頁內容