로깅

마지막 업데이트: 2025년 6월 13일
  • 적용 대상:
  • Experience Manager 6.5

작성 대상:

  • 관리자

AEM에서는 다음을 구성할 수 있습니다.

  • 중앙 로깅 서비스에 대한 전역 매개 변수
  • 요청 데이터 로깅, 요청 정보에 대한 전문 로깅 구성
  • 개별 서비스에 대한 특정 설정(예: 로그 메시지의 개별 로그 파일 및 형식)

모두 OSGi 구성입니다.

노트
AEM에서의 로그인은 Sling 원칙을 기반으로 합니다. 자세한 내용은 Sling 로깅을 참조하십시오.

글로벌 로깅

Apache Sling 로깅 구성을 사용하여 루트 로거를 구성합니다. AEM 로그인에 대한 전역 설정을 정의합니다.

  • 로깅 수준
  • 중앙 로그 파일의 위치
  • 보관할 버전 수
  • 버전 회전(최대 크기 또는 시간 간격)
  • 로그 메시지를 작성할 때 사용할 형식

개인 서비스용 로거 및 라이터

글로벌 로깅 설정 외에도 AEM을 사용하여 개별 서비스에 대한 특정 설정을 구성할 수 있습니다.

  • 특정 로깅 수준
  • 개별 로그 파일의 위치
  • 보관할 버전 수
  • 버전 회전(최대 크기 또는 시간 간격)
  • 로그 메시지를 작성할 때 사용할 형식
  • 로거(로그 메시지를 제공하는 OSGi 서비스)

이렇게 하면 단일 서비스에 대한 로그 메시지를 별도의 파일로 전달할 수 있습니다. 이 기능은 개발 또는 테스트 중(예: 특정 서비스에 대해 증가된 로그 수준이 필요한 경우) 특히 유용합니다.

AEM은 다음을 사용하여 로그 메시지를 파일에 기록합니다.

  1. OSGi 서비스(로거)가 로그 메시지를 씁니다.
  2. Logging Logger ​은(는) 이 메시지를 사용하고 사용자의 사양에 따라 형식을 지정합니다.
  3. Logging Writer ​는 사용자가 정의한 실제 파일에 이 모든 메시지를 씁니다.

이러한 요소는 적절한 요소에 대해 다음 매개 변수로 연결됩니다.

  • 로거(로거 로깅)

    메시지를 생성하는 서비스를 정의합니다.

  • 로그 파일(로깅 로거)

    로그 메시지를 저장할 실제 파일을 정의합니다.

    이 로그는 로깅 작성기에 로깅 로거를 연결하는 데 사용됩니다. 연결할 로깅 작성기 구성의 매개 변수와 값이 동일해야 합니다.

  • 로그 파일(Logging Writer)

    로그 메시지가 기록될 물리적 파일을 정의합니다.

    이것은 로깅 작성기 구성의 동일한 매개 변수와 동일해야 합니다. 그렇지 않으면 일치가 수행되지 않습니다. 일치하는 항목이 없으면 기본 구성(일별 로그 회전)을 사용하여 암시적 작성기가 만들어집니다.

표준 로거 및 작성자

특정 로거 및 작성기는 표준 AEM 설치에 포함되어 있습니다.

첫 번째는 request.log 및 access.log 파일을 모두 제어하기 때문에 특별한 경우입니다.

  • 로거:

    • Apache Sling 사용자 지정 가능 요청 데이터 로거

      (org.apache.sling.engine.impl.log.RequestLoggerService)

    • request.log에 요청 콘텐츠에 대한 메시지를 씁니다.

  • 링크 대상:

    • Apache Sling 요청 로거

      (org.apache.sling.engine.impl.log.RequestLogger)

    • 메시지를 request.log 또는 access.log에 씁니다.

표준 구성은 대부분의 설치에 적합하지만 필요한 경우 사용자 정의할 수 있습니다.

다른 쌍은 표준 구성을 따릅니다.

  • 로거:

    • Apache Sling 로깅 로거 구성

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

    • Information개의 메시지를 logs/error.log에 씁니다.

  • 작성기 링크:

    • Apache Sling 로깅 작성기 구성

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

  • 로거:

    • Apache Sling 로깅 로거 구성
      (org.apache.sling.commons.log.LogManager.factory.config.649d51b7-6425-45c9-81e6-2697a03d6be7)

    • org.apache.pdfbox 서비스에 대해 ../logs/error.log에 Warning개의 메시지를 씁니다.

  • 특정 작성기에 연결되지 않으므로 기본 구성(일별 로그 회전)을 사용하는 암시적 작성기가 작성 및 사용됩니다.