로그를 사용하여 AEM as a Cloud Service 디버깅

로그는 AEM as a Cloud Service에서 AEM 응용 프로그램을 디버깅하기 위해 최전방 역할을 하지만 배포된 AEM 응용 프로그램의 적절한 로깅에 의존합니다.

지정된 환경의 AEM 서비스(작성자, 게시/게시 Dispatcher)에 대한 모든 로그 활동은 해당 서비스 내에서 다른 pod가 로그 문을 생성하더라도 단일 로그 파일에 통합됩니다.

Pod Id는 각 로그 문에 제공되며 로그 문을 필터링하거나 수집할 수 있습니다. Pod Id의 형식은 다음과 같습니다.

  • cm-p<PROGRAM ID>-e<ENVIRONMENT ID>-aem-<author|publish>-<POD NAME>
  • 예제: cm-p12345-e56789-aem-author-abcdefabde-98765

사용자 지정 로그 파일

AEM as a Cloud Services은 사용자 지정 로그 파일을 지원하지 않지만 사용자 지정 로깅을 지원합니다.

AEM as a Cloud Service에서 사용할 수 있는 Java 로그의 ( Cloud Manager 또는 Adobe I/O CLI), 사용자 지정 로그 문을 작성해야 합니다. error.log. 사용자 지정 명명된 로그(예: )에 작성된 로그 example.log은 AEM as a Cloud Service에서 액세스할 수 없습니다.

로그를 error.log sling LogManager OSGi 구성 속성을 사용하여 응용 프로그램의 org.apache.sling.commons.log.LogManager.factory.config~example.cfg.json 파일.

{
   ...
   "org.apache.sling.commons.log.file": "logs/error.log"
   ...
}

AEM 작성자 및 게시 서비스 로그

AEM 작성자 및 게시 서비스 모두 AEM 런타임 서버 로그를 제공합니다.

  • aemerror 는 Java 오류 로그( /crx-quickstart/logs/error.log 설정(AEM SDK 로컬 빠른 시작)을 참조하십시오. 다음은 다음과 같습니다 권장 로그 수준 환경 유형별 사용자 지정 로거:
    • 개발: DEBUG
    • 단계: WARN
    • 프로덕션: ERROR
  • aemaccess 세부 정보와 함께 AEM 서비스에 대한 HTTP 요청 나열
  • aemrequest AEM 서비스에 대한 HTTP 요청 및 해당 HTTP 응답을 나열합니다

AEM Publish Dispatcher 로그

이러한 측면이 AEM 게시 계층에만 있고 AEM 작성 계층에는 존재하지 않으므로 AEM 게시 디스패처만 Apache 웹 서버 및 Dispatcher 로그를 제공합니다.

  • httpdaccess AEM 서비스의 Apache 웹 서버/Dispatcher에 대한 HTTP 요청을 나열합니다.
  • httperror 에서는 Apache 웹 서버의 로그 메시지를 나열하고, 지원되는 Apache 모듈(예: mod_rewrite.
    • 개발: DEBUG
    • 단계: WARN
    • 프로덕션: ERROR
  • aemdispatcher 캐시 메시지에서 필터링 및 서비스를 포함하여 Dispatcher 모듈의 로그 메시지를 나열합니다.
    • 개발: DEBUG
    • 단계: WARN
    • 프로덕션: ERROR

Cloud Manager

Adobe Cloud Manager에서는 환경의 다운로드 로그 작업을 통해 일별로 로그를 다운로드할 수 있습니다.

Cloud Manager - 다운로드 로그

모든 로그 분석 도구를 통해 이러한 로그를 다운로드하여 검사할 수 있습니다.

Cloud Manager 플러그인이 있는 Adobe I/O CLI

Adobe Cloud Manager는 Adobe I/O CLI 사용 Adobe I/O CLI용 Cloud Manager 플러그인.

먼저, Cloud Manager 플러그인을 사용하여 Adobe I/O 설정.

관련 프로그램 ID 및 환경 ID가 식별되었는지 확인하고 list-available-log-options 에 사용되는 로그 옵션을 나열하려면 테일 또는 다운로드 로그.

$ aio cloudmanager:list-programs
Program Id Name      Enabled
14304      Program 1 true
11454      Program 2 true
11502      Program 3 true

$ aio config:set cloudmanager_programid <PROGRAM ID>

$ aio cloudmanager:list-environments
Environment Id Name            Type  Description
22295          program-3-dev   dev
22310          program-3-prod  prod
22294          program-3-stage stage

$ aio cloudmanager:list-available-log-options <ENVIRONMENT ID>
Environment Id Service    Name
22295          author     aemaccess
22295          author     aemerror
22295          author     aemrequest
22295          publish    aemaccess
22295          publish    aemerror
22295          publish    aemrequest
22295          dispatcher httpdaccess
22295          dispatcher httpderror
22295          dispatcher aemdispatcher

로그 지우기

Adobe I/O CLI는 AEM as a Cloud Service에서 실시간으로 로그를 추적할 수 있는 기능을 제공합니다 테일 로그 명령. Tailing은 AEM as a Cloud Service 환경에서 작업이 수행되므로 실시간 로그 활동을 보는 데 유용합니다.

$ aio config:set cloudmanager_programid <PROGRAM ID>
$ aio cloudmanager:tail-logs <ENVIRONMENT ID> <SERVICE> <NAME>

기타 명령줄 도구(예: ) grep 와 함께 사용할 수 있습니다. tail-logs 예를 들어, 다음과 같이 로그 문을 분리할 수 있습니다.

$ aio cloudmanager:tail-logs 12345 author | grep com.example.MySlingModel

…은(는) com.example.MySlingModel 또는 여기에 해당 문자열을 포함합니다.

로그 다운로드

Adobe I/O CLI는 AEM as a Cloud Service에서 로그를 다운로드할 수 있는 기능을 제공합니다 다운로드 로그) 명령을 실행합니다. 이렇게 하면 Cloud Manager 웹 UI에서 로그를 다운로드하는 것과 동일한 종료 결과가 제공되며, 차이점은 다음과 같습니다 download-logs 명령은 요청한 로그 일수를 기준으로 일 간에 로그를 통합합니다.

$ aio config:set cloudmanager_programid <PROGRAM ID>
$ aio cloudmanager:download-logs <ENVIRONMENT> <SERVICE> <NAME> <DAYS>

로그 이해

AEM에 로그인하면 as a Cloud Service으로 로그 명령문을 작성하는 여러 pod가 있습니다. 여러 AEM 인스턴스가 동일한 로그 파일에 쓰기 때문에 디버깅하는 동안 분석을 이해하고 노이즈를 줄이는 방법을 이해하는 것이 중요합니다. 설명하기 위해 다음을 수행합니다 aemerror 로그 코드 조각 사용:

01.01.2020 12:00:00.000 [cm-p12345-e56789-aem-author-abcdefg-1111] *DEBUG* [qtp2078364989-269] com.example.components.impl.ExampleModelImpl Preparing to collect resources
01.01.2020 12:00:01.002 [cm-p12345-e56789-aem-author-abcdefg-2222] *WARN*  [qtp40782847611-87] com.example.services.impl.ExampleServiceImpl Unable to resolve resource [ /content/example ] to a resource. Aborting.
01.01.2020 12:00:02.003 [cm-p12345-e56789-aem-author-abcdefg-1111] *ERROR* [qtp2078364989-269] com.example.components.impl.ExampleModelImpl Unable to collect any resources

Pod Id를 사용하여 날짜 및 시간 후의 데이터 포인트를 사용하여 로그를 Pod 또는 서비스 내의 AEM 인스턴스에 의해 수집할 수 있으므로 코드 실행을 쉽게 추적하고 이해할 수 있습니다.

Pod cm-p12345-e56789-aem-author-abcdefg-1111

01.01.2020 12:00:00.000 [cm-p12345-e56789-aem-author-abcdefg-1111] *DEBUG* [qtp2078364989-269] com.example.components.impl.ExampleModelImpl Preparing to collect resources
01.01.2020 12:00:02.003 [cm-p12345-e56789-aem-author-abcdefg-1111] *ERROR* [qtp2078364989-269] com.example.components.impl.ExampleModelImpl Unable to collect any resources

Pod cm-p12345-e56789-aem-author-abcdefg-2222

01.01.2020 12:00:01.002 [cm-p12345-e56789-aem-author-abcdefg-2222] *WARN*  [qtp2078364989-269] com.example.services.impl.ExampleServiceImpl Unable to resolve resource [ /content/example ] to a resource. Aborting.

권장 로그 수준

AEM as a Cloud Service 환경당 로그 수준에 대한 Adobe의 일반적인 지침은 다음과 같습니다.

  • 로컬 개발(AEM SDK): DEBUG
  • 개발: DEBUG
  • 단계: WARN
  • 프로덕션: ERROR

각 환경 유형에 가장 적합한 로그 수준을 설정하는 것은 AEM as a Cloud Service으로 설정되어 있으며, 로그 수준은 코드에서 유지됩니다

  • Java 로그 구성은 OSGi 구성에서 유지됩니다
  • Dispatcher 프로젝트의 Apache 웹 서버 및 Dispatcher 로그 수준

…따라서 배포를 변경해야 합니다.

Java 로그 수준을 설정할 환경별 변수

각 환경에 대해 정적 잘 알려진 Java 로그 수준을 설정하는 대신, AEM을 Cloud Service으로 사용하는 것이 좋습니다 환경별 변수 로그 레벨을 매개 변수화하여 값을 Cloud Manager 플러그인이 있는 Adobe I/O CLI.

따라서 환경별 변수 자리 표시자를 사용하려면 로깅 OSGi 구성을 업데이트해야 합니다. 기본값 의 경우 로그 수준은 Adobe 권장 사항. 예:

/apps/example/config/org.apache.sling.commons.log.LogManager.factory.config~example.cfg.json

{
    ...
    "org.apache.sling.commons.log.names": ["com.example"],
    "org.apache.sling.commons.log.level": "$[env:LOG_LEVEL;default=DEBUG]"
    ...
}

이 접근 방식은 다음과 같은 사항을 고려해야 합니다.

  • 제한된 수의 환경 변수가 허용됩니다및 로그 수준을 관리하기 위해 변수를 만들면 로그 수준이 사용됩니다.
  • 환경 변수는 Adobe I/O CLI 또는 Cloud Manager HTTP API.
  • 환경 변수에 대한 변경 사항은 지원되는 도구에 의해 수동으로 재설정되어야 합니다. 프로덕션과 같은 높은 트래픽 환경을 더 적은 세부 로그 수준으로 재설정하지 않도록 하면 로그가 붓고 AEM 성능에 영향을 줄 수 있습니다.

Apache 웹 서버 또는 Dispatcher 로그 구성에서는 OSGi 구성을 통해 구성되지 않으므로 환경별 변수가 작동하지 않습니다.

이 페이지에서는