설명서Experience Cloud KCS

사용자 지정 AEM 로그가 Cloud Manager에 표시되지 않음

마지막 업데이트: 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 기본 사항

문제/증상

  • 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