설명서AEM 6.5사용 안내서

HTML 5 양식에 대한 로깅 활성화 enable-logging-for-html-forms

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 주제:

작성 대상:

  • 관리자
  • 사용자
  • 개발자

HTML 5 양식에 대한 로그 작성을 시작하도록 로거 유틸리티를 구성할 수 있습니다. 로거 유틸리티에는 다양한 수준이 있으므로 요구 사항에 따라 수준을 설정할 수 있습니다. HTML 5 forms에는 서버 및 클라이언트 구성 요소가 있습니다. 두 구성 요소에 대해 로그를 구성할 수 있습니다.

서버측 로깅 구성 configuring-server-side-logging

서버측 로그를 구성하려면 다음 단계를 수행하십시오.

  1. https://'[server]:[port]'/system/console/configMgr(으)로 이동합니다. Apace Sling 로깅 로거 구성 옵션을 찾아 엽니다. 대화 상자가 나타납니다.

    Api Sling 로깅 로거 구성 옵션 대화 상자

    Api Sling 로깅 로거 구성 옵션

  2. 로그 수준 ​을 디버그(으)로 변경합니다.

  3. 로그 파일 ​의 이름과 경로를 지정하십시오.

    note note
    NOTE
    HTML5 양식 로그 디렉터리에 로그를 생성하려면 파일 이름 앞에 …/logs/를 추가합니다.

  4. 로거 ​을(를) HTMLFormsPerfLogger(으)로 변경합니다. 저장 ​을 클릭합니다.

클라이언트 로깅 구성 configuring-client-logging

다음 방법을 사용하여 HTML5 양식에서 클라이언트측 로깅을 활성화할 수 있습니다.

  • 이름이 log인 요청 매개 변수 사용
  • CQ 구성 관리자 사용

요청 매개 변수를 사용하여 로깅 활성화 enabling-logging-using-request-parameter

이 방법을 사용하면 특정 요청에 대한 로그를 생성할 수 있습니다. 요청 매개 변수의 이름은 log입니다. 로그 URL은 다음과 같습니다.

https://<server>:<port>/content/xfaforms/profiles/test.html?contentRoot=<path of the folder containing form xdp>&template=<name of the xdp>&log=<log configuration>.

로그 구성은 로그 수준 및 로거 범주로 구성됩니다.

로그 대상 log-destination

로그 대상
설명
1
로그가 브라우저 콘솔(으)로 이동되었습니다.
2
로그는 클라이언트측의 JavaScript 개체에 수집되며 Server 에 게시할 수 있습니다.
3
위의 두 옵션

로그 수준 log-levels

로그 수준
설명
0
꺼짐
1
치명적
2
오류
3
경고
4
정보
5
디버그
6
TRACE
7
모두

로거 범주 logger-categories

로그 범주
설명
a
xfa(스크립팅 엔진 관련 로그)
b
xfaView(레이아웃 엔진 관련 로그)
c
xfaPerf(성능 관련 로그)

로그 구성 log-configuration

로그 URL에서 로그 구성 쿼리 문자열 매개 변수는 다음과 같이 정의됩니다.

{destination}-{a level}-{b level}-{c level}

예:

로그 구성
설명
2-a4-b5-c6
대상: 서버
xfa 수준: INFO
xfaView 수준: DEBUG
xfaPerf 수준: TRACE
NOTE
각 로그 범주 a(xfa), b(xfaView) 및 c(xfaPerf)의 기본 로그 수준은 2(ERROR)입니다. 따라서 로그 구성: 2-b6의 경우 다른 범주에 대한 로그 수준은 다음과 같습니다.
a(xfa): 2(기본 수준 오류)
b(xfaView): 6(사용자 지정 TRACE)
a(xfaPerf): 2(기본 수준 오류)

Configuration Manager를 사용하여 로깅 활성화 enabling-logging-using-configuration-manager

로깅을 활성화하기 위해 Configuration Manager를 사용하는 경우 로깅을 다시 비활성화할 때까지 모든 렌더링 요청에 대해 로그가 생성됩니다.

  1. https://'[server]:[port]'/system/console/configMgr의 CQ 구성 관리자에 로그인하고 관리자 자격 증명으로 로그인합니다.

  2. 모바일 Forms 구성 ​을 검색하고 클릭합니다.

  3. 디버그 옵션 텍스트 상자에 이전 섹션에 설명된 대로 로그 구성을 입력합니다(예: 2-a4-b5-c6).

    Forms 구성

    양식 구성

로그 업로드 중 uploading-logs

대상이 1로 설정되면 모든 클라이언트 스크립트 로그 메시지가 콘솔로 전달됩니다. 관리자가 이러한 로그를 서버 로그와 함께 필요로 하는 경우 대상 수준을 2로 설정하십시오. 이 수준에서 모든 로그는 클라이언트측의 JS 개체에 수집되며, 기본 프로필로 양식이 렌더링되는 경우 도구 모음의 기존 필드 강조 단추 왼쪽에 로그 보내기 단추가 나타납니다. 사용자가 링크를 클릭하면 수집된 모든 로그가 서버에 게시되고 서버에 구성된 오류 로그 파일에 기록됩니다.

기본적으로 모든 정보는 /crx-repository/logs/ 디렉토리에 있는 error.log 파일에 추가됩니다.

로그 파일의 위치 및 이름을 변경하려면 다음을 수행합니다.

  1. 관리자로 Configuration Manager에 로그인합니다. 구성 관리자의 기본 URL은 https://'[server]:[port]'/system/console/configMgr입니다.

  2. Apache Sling 로깅 로거 구성 ​을 클릭합니다. 대화 상자가 나타납니다.

    logconfig-1

  3. 로그 수준 ​을 디버그로 변경합니다.

  4. 로그 파일 ​의 경로와 이름을 지정하십시오.

    note note
    NOTE
    다른 로그 파일이 보관된 동일한 디렉터리에 로그를 만들려면 로그 파일 속성에 …/logs/<filename>을 지정합니다.

  5. 로거 ​을(를) HTMLFormsPerfLogger(으)로 변경하고 저장 ​을(를) 클릭합니다.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2