文件Experience Cloud KCS

Cloud Manager中未顯示自訂AEM記錄

最後更新： 2026年7月3日

當您的記錄器設定為寫入自訂記錄檔、OSGi原廠設定名稱錯誤，或記錄層級太嚴格時，自訂記錄陳述式不會出現在Cloud Manager中。 AEM as a Cloud Service不支援自訂記錄檔，而且只會公開標準資料流，例如aemerror，因此會忽略傳送至其他位置的輸出。 更正記錄器檔案路徑、組態檔案名稱以及記錄層級會還原預期的專案。 若要修正此問題，請將記錄器指向logs/error.log並套用有效的設定值。

說明 description

環境

  • Adobe Experience Manager as a Cloud Service
  • AEM Managed Services
  • AEM Assets Essentials

問題/症狀

  • 自訂記錄檔（例如my-custom.log或saml.log）未出現在Cloud Manager中。
  • 儘管成功執行，記錄陳述式仍不會出現在aemerror中。
  • 存取自訂記錄檔時，記錄尾指令會失敗。
  • 因為記錄層級的限制，所以未顯示INFO或DEBUG記錄專案。

原因

AEM as a Cloud Service會強制執行將所有Java記錄輸出寫入到logs/error.log的集中式記錄模型，因此會忽略定義自訂記錄檔路徑的任何設定。 不正確的OSGi記錄器設定、無效的檔案命名慣例或限制的記錄層級設定，也會使記錄陳述式無法在aemerror資料流中出現。

解決方法 resolution

請依照下列步驟解決問題

  1. 檢閱程式碼存放庫中的OSGi記錄器設定，並識別org.apache.sling.commons.log.file指定自訂記錄檔路徑而非logs/error.log的任何設定。
  2. 更新記錄器設定以使用支援的檔案，方法是將org.apache.sling.commons.log.file設定為logs/error.log並驗證所有相關屬性是否使用有效值。
  3. 驗證組態檔名稱是否遵循必要的格式org.apache.sling.commons.log.LogManager.factory.config-.cfg.json，並移除如波狀符號( )等無效的字元。
  4. 檢查記錄層級組態，並將它設為有效的小寫值，例如debug、info、warn或錯誤，確保它不會限制預期的輸出。
  5. 檢查所有記錄器設定，並移除相同套件的重複或衝突定義。
  6. 透過管道部署更新的設定，並確認記錄專案出現在Cloud Manager的aemerror記錄資料流中。

相關閱讀

recommendation-more-help
experience-cloud-kcs-help-kbarticles