記錄 logging

CAUTION
AEM 6.4已結束延伸支援,本檔案不再更新。 如需詳細資訊,請參閱 技術支援期. 尋找支援的版本 此處.

AEM可讓您設定:

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

這些都是 OSGi配置.

NOTE
登入AEM是根據Sling原則。 請參閱 Sling記錄 以取得更多資訊。

全域記錄 global-logging

Apache Sling記錄設定 用於配置根記錄器。 這會定義登入AEM的全域設定:

  • 記錄級別
  • 中央日誌檔案的位置
  • 要保留的版本數
  • 版本輪換;最大大小或時間間隔
  • 寫入日誌消息時要使用的格式
NOTE
知識庫文章 說明如何旋轉request.log和access.log檔案。

個人服務的記錄器和撰寫器 loggers-and-writers-for-individual-services

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

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

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

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

  1. OSGi服務 (記錄器)寫入日誌消息。
  2. A 記錄器 根據您的規範擷取此訊息並格式化。
  3. A 記錄寫入程式 將所有這些消息寫入已定義的物理檔案。

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

  • 記錄器(記錄器)

    定義產生訊息的服務。

  • 記錄檔(記錄檔)

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

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

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

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

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

標準記錄器和撰寫器 standard-loggers-and-writers

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

    • 寫入 Warning 訊息 ../logs/error.log 服務 org.apache.pdfbox.

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

建立您自己的記錄器和作者 creating-your-own-loggers-and-writers

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

  1. 建立工廠配置的新實例 Apache Sling Logging Logger Configuration.

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

    1. 指定日誌檔案 — 此檔案必須與為記錄器指定的檔案匹配。
    2. 視需要設定其他參數。
NOTE
在特定情況下,您可能想要建立 自訂記錄檔.
recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56