로그는 AEMas 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은 사용자 정의 로그 파일을 지원하지 않지만 사용자 정의 로깅을 지원합니다.
Java 로그를 AEM에서 as a Cloud Service으로 사용 가능(를 통해) 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 Author 및 Publish 서비스는 모두 AEM 런타임 서버 로그를 제공합니다.
aemerror
는 Java 오류 로그입니다( 다음에서 찾을 수 있음). /crx-quickstart/logs/error.log
(AEM SDK 로컬 빠른 시작). 다음은 권장 로그 수준 환경 유형별 사용자 지정 로거의 경우:
DEBUG
WARN
ERROR
aemaccess
세부 정보와 함께 AEM 서비스에 대한 HTTP 요청을 나열합니다.aemrequest
AEM 서비스에 대한 HTTP 요청과 해당 HTTP 응답을 나열합니다.AEM Publish Dispatcher만 Apache 웹 서버 및 Dispatcher 로그를 제공합니다. 이러한 측면은 AEM 게시 계층에만 있고 AEM 작성자 계층에는 없으므로 AEM Publish 계층에는 없습니다.
httpdaccess
AEM 서비스의 Apache 웹 서버/Dispatcher에 대한 HTTP 요청을 나열합니다.httperror
apache 웹 서버의 로그 메시지를 나열하고 다음과 같이 지원되는 Apache 모듈 디버깅에 대한 도움말을 봅니다. mod_rewrite
.
DEBUG
WARN
ERROR
aemdispatcher
은 캐시 메시지에서 필터링 및 제공 등 Dispatcher 모듈의 로그 메시지를 나열합니다.
DEBUG
WARN
ERROR
Adobe Cloud Manager를 사용하면 환경의 로그 다운로드 작업을 통해 일별로 로그를 다운로드할 수 있습니다.
이러한 로그는 모든 로그 분석 도구를 통해 다운로드 및 검사할 수 있습니다.
Adobe Cloud Manager는 를 통해 AEM as a Cloud Service 로그에 액세스를 지원합니다. 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는 AEMas a Cloud Service 에서 테일 로그 명령입니다. 테일링은 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는 AEMas a Cloud Service 에서 로그를 다운로드하는 기능을 제공합니다. download-log) 명령입니다. 이렇게 하면 Cloud Manager 웹 UI에서 로그를 다운로드하는 것과 동일한 최종 결과를 제공하며 차이점은 다음과 같습니다. download-logs
명령은 요청한 일 수에 따라 여러 날에 걸쳐 로그를 통합합니다.
$ aio config:set cloudmanager_programid <PROGRAM ID>
$ aio cloudmanager:download-logs <ENVIRONMENT> <SERVICE> <NAME> <DAYS>
AEMas 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의 일반적인 지침은 다음과 같습니다.
DEBUG
DEBUG
WARN
ERROR
각 환경 유형에 가장 적합한 로그 수준을 설정하는 것은 AEM as a Cloud Service을 사용하는 것이며, 로그 수준은 코드에서 유지됩니다
…따라서 변경하려면 배포가 필요합니다.
각 환경에 대해 잘 알려진 정적 Java 로그 수준을 설정하는 대신 AEM을 Cloud Service으로 사용합니다. 환경별 변수 를 통해 값을 동적으로 변경할 수 있도록 로그 수준을 매개 변수화합니다. Cloud Manager 플러그인으로 CLI Adobe I/O.
이렇게 하려면 환경별 변수 자리 표시자를 사용하도록 로깅 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]"
...
}
이 접근 방식에는 다음과 같은 단점이 있습니다.
Apache 웹 서버 또는 Dispatcher 로그 구성은 OSGi 구성을 통해 구성되지 않으므로 환경별 변수가 작동하지 않습니다.