설명서AEM 6.4배포 안내서

로깅 logging

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • Developer
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. An OSGi 서비스 (logger) 로그 메시지를 기록합니다.
  2. A 로깅 로거 이 메시지를 가져와 사양에 따라 형식을 지정합니다.
  3. A 로깅 작성기 정의한 실제 파일에 이 모든 메시지를 기록합니다.

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

  • 로거(로깅 로거)

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

  • 로그 파일(로깅 로거)

    로그 메시지를 저장할 물리적 파일을 정의합니다.

    로깅 작성기에 로깅 로거를 연결하는 데 사용됩니다. 연결을 만들려면 값이 로깅 작성기 구성에서 동일한 매개 변수와 동일해야 합니다.

  • 로그 파일(로깅 작성기)

    로그 메시지가 기록될 실제 파일을 정의합니다.

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

표준 로거 및 작가 standard-loggers-and-writers

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

첫 번째는 두 가지를 모두 제어할 수 있는 특별한 경우입니다 request.log 및 access.log 파일:

  • 로거:

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

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

    • 요청 내용에 대한 메시지를 request.log.

  • 링크 대상:

    • Apache Sling Request Logger

      (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 Logging Logger 구성(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 로깅 로거 구성.

    1. 로그 파일을 지정합니다.
    2. 로거를 지정합니다.
    3. 필요에 따라 다른 매개 변수를 구성합니다.

  2. 출하 시 구성의 새 인스턴스 생성 Apache Sling 로깅 작성기 구성.

    1. 로그 파일을 지정합니다. 이 파일은 로거에 지정된 파일과 일치해야 합니다.
    2. 필요에 따라 다른 매개 변수를 구성합니다.
NOTE
특정 상황에서 사용자 지정 로그 파일.
recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56