설명서Dynamic Media 이미지 제공 및 렌더링 API

액세스 로깅 access-logging

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

작성 대상:

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

액세스 로깅에 이 서버 설정을 사용합니다.

구문

TC::directory - 로그 파일 폴더 section-5d9e2168d4504bbe9868b7d6051c9d67

Platform Server에서 로그 파일을 쓰는 폴더입니다. 절대 경로이거나 install_folder ​에 상대적인 경로일 수 있습니다. 기본값은 ​ install_folder/logs입니다.

NOTE
이 설정을 변경하기 전에 새 폴더를 만들어야 합니다. 이미지 제공이 루트가 아닌 사용자 계정에서 실행되도록 설치된 경우 폴더에 올바른 읽기/쓰기 액세스 권한이 있는지 확인합니다.

TC::maxDays - 로그 파일을 보관할 일 수 section-45cbecffc5694c87b7d5c176a44a4885

로그 파일이 보존되는 일 수입니다. 매일 자정에 새 로그 파일이 만들어집니다. 이때 서버는 이미지 서버 또는 렌더링 서버에서 작성한 파일을 포함하여 지정된 일수보다 오래된 로그 파일 폴더의 모든 파일을 삭제합니다. 기본값은 10입니다.

TC::prefix - 액세스 로그 파일 이름 section-1003856323b844049632710a5a056aa7

액세스 로그 데이터가 기록되는 파일의 이름 접두사입니다. 지정한 문자열에 날짜 및 파일 접미사(​ yyyy-mm-dd.log)가 추가됩니다. 액세스 로그 파일의 이름은 추적 로그 파일의 이름과 달라야 합니다. 기본값은 " access-"입니다.

TC::pattern - 액세스 로그 패턴 section-22775ea85cee444d8a7d7336a3b1feef

Platform Server 액세스 로그 레코드에 대한 데이터 패턴을 지정합니다. 패턴 문자열은 해당 값으로 대체되는 변수를 지정합니다. 패턴 문자열의 다른 모든 문자는 문자 그대로 로그 레코드로 전송됩니다.

캐시 준비 유틸리티를 사용하려면 공백을 필드 구분 기호로 사용해야 합니다. Platform Server은(는) 필드 값의 모든 공백 및 '%' 문자를 각각 %20 및 %25(으)로 바꿉니다.

지원되는 패턴 변수는 다음과 같습니다.

패턴
설명
%a
원격 IP 주소.
%A
로컬 IP 주소.
%b
HTTP 헤더를 제외한 응답 바이트 수입니다. 0이면 ' '입니다.
%B
HTTP 헤더를 제외한 응답 바이트 수입니다.
%D
요청 처리 시간(밀리초).
%I
스레드 id(디버그/오류 로그 항목 상호 참조 시).
%G

yyyy - MM - dd HH : mm : ss 형식의 날짜 및 시간입니다. SSS 오프셋

( SSS 은(는) 밀리초, 오프셋 은(는) GMT 시간 오프셋입니다.) 응답이 클라이언트에 전송될 때 시간 값이 캡처됩니다.

%m
요청 메서드( GET , POST 등).
%O
요청 겹침(동시에 처리된 요청 수).
%p
이 요청이 수신된 로컬 포트입니다.
%q
쿼리 문자열('?' 앞에 추가됨) 존재하는 경우).
%r
요청의 첫 번째 줄(요청 메서드, URI, HTTP 버전).
%R
%r 과(와) 동일하지만 제한된 HTTP 인코딩을 URI에 적용하여 로그 구문 분석 문제를 방지합니다.
%s
HTTP 응답 상태 코드.
%S
사용자 세션 ID.
%t
일반 로그 형식의 날짜 및 시간입니다.
%u
인증된 원격 사용자(있는 경우), 그 외 ''.
%U
URI 경로.
%v
로컬 서버 이름입니다.
%T
요청 처리 시간(초).
%{CacheKey}r
Platform Server 캐시 키(캐시 파일 폴더/이름).
%{CacheUse}r
Platform Server 캐시 관리 키워드: { 재사용됨 | 생성됨 | 업데이트됨 | 원격 | REMOTE_CREATED | REMOTE_UPDATED | REMOTE_CACHE | 확인됨 | 무시됨 | 정의되지 않음 } .
%{ContentType}r
응답 MIME 유형.
%{Context}r
컨텍스트 전달이 발생하는 경우 대상 컨텍스트.
%{Digest}r
etag 응답 헤더 값(응답 데이터의 MD5 서명)입니다.
%{Exception}r
오류 메시지.
%{FetchTime}r
이미지 서버에서 캐시 항목 또는 데이터를 검색하는 데 걸린 시간입니다.
%{ParseTime}r
요청 구문 분석 및 이미지 카탈로그 조회에 걸린 시간입니다.
%{PathBasedAccess}r
이 요청이 카탈로그 시스템 외부에서 경로 기반 액세스를 시도했는지 여부를 나타냅니다.
%{PeerServer}r
CacheUse 이(가) REMOTE_CREATED 또는 REMOTE_UPDATED 이(가) 아닌 경우 캐시 항목 또는 '-'를 전달한 캐시 클러스터에 있는 피어 서버의 IP 주소입니다.
%{ProcessingStatus}r

오류 범주:

  • 0=오류 없음.

  • 1=서버에서 이미지를 찾을 수 없습니다.

  • 2=IS 프로토콜 사용 오류 또는 1 이외의 콘텐츠 오류.

  • 3=기타 서버 오류.

  • 4=임시 서버 오버로드로 인해 요청이 거부되었습니다.

%{ReqType}r
req= 의 대문자 값.
%{RootId}r
요청 기본 카탈로그의 루트 ID.
%{SendTime}r
출력 스트림에 데이터를 쓴 후 응답을 보내는 데 Platform Server이(가) 소요되는 시간입니다.
%{Size}r
%B 과(와) 유사하지만 304(수정되지 않은) 응답 값을 포함합니다.
%{TransformedUrl}r
모든 규칙 세트 변형 후의 최종 URL입니다.
%{ httpRequestHeader }i
지정된 HTTP 요청 헤더의 값입니다.
%{ httpResponseHeader }
지정된 HTTP 응답 헤더의 값입니다.

기본값은 "%G %a %s %{ProcessingStatus}r %{Size}r %D %{ParseTime}r %{FetchTime}r %O %{ReqType}r '%{RootId}r' %{CacheUse}r %R [%I] '%{Referer}i' %{Host}i %{X-Forwarded-For}i %{If-None-Match}i %{If-Match}i %{If-Modified-Since}i %{Digest}r %{ContentType}r %p %{Exception}r %{CacheKey}r %{PeerServer}" %{SendTime}r %{Context}r %{TransformedUrl}r %{PathBasedAccess}r.입니다.

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49