아파치 모듈 mod_log_config

가능한 언어: en | + ja | + ko | + tr

이 문서는 최신판 번역이 아닙니다. + 최근에 변경된 내용은 영어 문서를 참고하세요.

+ + + +

설명:	서버로의 요청을 로그에 기록한다
상태:	Base
모듈명:	log_config_module
소스파일:	mod_log_config.c

요약

+ +

이 모듈은 클라이언트의 요청을 로그에 자유롭게 기록한다. + 자신이 원하는 형식으로 로그를 기록할 수 있고, 파일이나 외부 + 프로그램에 직접 로그를 보낼 수도 있다. 조건적 로그를 사용하면 + 요청의 성격에 따라 요청을 로그에 추가하거나 제외할 수 있다.

+ +

이 모듈은 세가지 지시어를 제공한다. TransferLog는 로그파일을 + 만들고, LogFormat은 + 원하는 형식을 정하고, CustomLog는 한번에 로그파일과 + 형식을 모두 지정한다. TransferLog와 + CustomLog 지시어를 여러번 사용하면 + 요청을 여러 파일에 기록할 수 있다.

로그 형식 지정하기

+ +

LogFormat과 + CustomLog + 지시어의 형식 아규먼트는 문자열이다. 이 문자열에 따라 요청을 + 로그파일에 기록한다. 문자열에는 로그파일에 그대로 복사되는 + 문자와 행바꿈과 탭을 나타내는 C의 "\n"과 "\t" 제어문자를 + 사용할 수 있다. 로그파일에 따옴표나 백슬래쉬를 쓰려면 앞에 + 반드시 백슬래쉬를 적어줘야 한다.

+ +

요청의 특징은 형식 문자열에 "%" 지시어를 + 사용하여 기록한다. 이 지시어는 로그파일에서 다음과 같이 + 변경된다.

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

형식 문자열 설명

%% 퍼센트 기호 (아파치 2.0.44 이후)

%...a 원격 IP-주소

%...A (서버) IP-주소

%...B HTTP 헤더를 제외한 전송 바이트수.

%...b HTTP 헤더를 제외한 전송 바이트수. CLF 형식과 같이 + 전송한 내용이 없는 경우 0 대신 '-'가 나온다.

%...{Foobar}C 서버가 수신한 요청에서 Foobar 쿠키의 + 내용.

%...D 요청을 처리하는데 걸린 시간 (마이크로초 단위).

%...{FOOBAR}e 환경변수 FOOBAR의 내용

%...f 파일명

%...h 원격 호스트

%...H 요청 프로토콜

%...{Foobar}i 서버가 수신한 요청에서 Foobar: + 헤더의 내용.

%...l (있다면 identd가 제공한) 원격 로그인명. + IdentityCheck가 + On이 아니면 빼기기호를 기록한다.

%...m 요청 메써드

%...{Foobar}n 다른 모듈이 기록한 Foobar 노트(note) + 내용.

%...{Foobar}o 응답의 Foobar: 헤더 내용.

%...p 요청을 서비스하는 서버의 정규 포트

%...P 요청을 서비스하는 자식의 프로세스 ID.

%...{format}P 요청을 서비스하는 자식의 프로세스 ID 혹은 쓰레드 + ID. format에는 pid와 tid가 + 가능하다. (아파치 2.0.46 이후) +

%...q 질의문자열 (질의문자열이 있다면 앞에 ?를 + 붙이고, 없다면 빈 문자열)

%...r 요청의 첫번째 줄

%...s 상태(status). 내부 리다이렉션된 요청의 경우 *원래* + 요청의 상태이다. 최종 요청의 상태는 %...>s.

%...t common log format 시간 형식(표준 영어 형식)의 시간

%...{format}t strftime(3) 형식 format의 시간. (지역시간일 + 수 있음)

%...T 요청을 처리하는데 걸린 시간 (초 단위).

%...u 원격 사용자 (auth가 제공하며, 상태(%s)가 + 401인 경우 이상한 값을 나올 수 있음)

%...U 질의문자열을 제외한 요청 URL 경로.

%...v 요청을 서비스한 서버의 정규 ServerName.

%...V UseCanonicalName + 설정에 따른 서버명.

%...X

응답을 마쳤을때 연결 상태. + + + + + + + + + +

`X` =	응답을 마치기 전에 연결이 끊어졌다.
`+` =	응답을 보낸후에도 연결이 살아있다(keep alive).
`-` =	응답을 보낸후 연결이 끊어졌다.

+ +

(아파치 1.3 후반 버전에서 이 지시어는 + %...c였지만, 전통적인 ssl + %...{var}c 문법과 겹쳐서 + 변경했다.)

%...I 요청과 헤더를 포함한 수신 바이트수로 0일 수 없다. + 이를 사용하려면 mod_logio가 필요하다.

%...O 헤더를 포함한 송신 바이트수로 0일 수 없다. 이를 + 사용하려면 mod_logio가 필요하다.

+ +

"..."에는 (예를 들어, + "%h %u %r %s %b") 아무것도 없거나, 항목을 포함할 + 조건이 나온다 (조건을 만족하지 않으면 자리에 "-"를 기록한다). + 조건은 앞에 "!"를 붙이거나 안붙인 HTTP 상태코드 목록으로 + 작성한다. 예를 들어, "%400,501{User-agent}i"는 400 (Bad + Request) 오류와 501 (Not Implemented) 오류일때만 + User-agent:를 로그에 남기고, + "%!200,304,302{Referer}i"는 정상적인 상태가 아닌 + 모든 요청에 대해 Referer:를 로그에 남긴다.

+ +

수정자 "<"와 ">"는 내부 리다이렉션된 요청에서 각각 + 처음 요청을 말할지 마지막 요청을 말할지 선택한다. 기본적으로 + %s, %U, %T, %D, %r은 처음 요청을 보고, 나머지 + % 지시어는 마지막 요청을 본다. 그래서 + %>s는 요청의 마지막 상태(status)를 기록하고, + %<u는 인증으로 보호하지 않는 자원으로 내부 + 라다이렉션된 경우에도 처음에 인증한 사용자를 기록한다.

+ +

2.0.46 이전의 httpd 2.0 버전은 %...r, + %...i, %...o의 결과 문자열을 그대로 + 두었다. 이유는 Common Log Format의 요구사항을 따르기위해서였다. + 즉, 클라이언트가 제어문자를 로그에 집어넣을 수 있기때문에 + 로그파일을 그대로 다룰 때는 조심해야 한다.

+ +

보안상 이유로 2.0.46부터 출력할 수 없는 문자나 다른 특수문자를 + \xhh로 표현한다. 여기서 hh는 + 해당 바이트의 16진수 표현을 나타낸다. 이 규칙의 예외는 백슬래쉬를 + 앞에 붙이는 "와 \, 그리고 C언어 + 형식의 공백문자들(\n, \t 등)이다.

+ +

일반적으로 많이 사용하는 로그 형식은 다음과 같다.

+ +

Common Log Format (CLF): "%h %l %u %t \"%r\" %>s %b"
가상호스트 정보를 포함한 Common Log Format: "%v %h %l %u %t \"%r\" %>s %b"
NCSA extended/combined 로그 형식: "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" + \"%{User-agent}i\""
Referer 로그 형식: "%{Referer}i -> %U"
Agent (브라우저) 로그 형식: "%{User-agent}i"

+ +

요청을 서비스하는 서버의 정규 ServerName과 Listen은 각각 %v와 + %p를 사용한다. 로그분석 프로그램이 실제로 요청을 + 서비스하는 호스트를 알기위해 가상호스트 찾기 알고리즘을 + 가질 필요없도록 이들 값은 UseCanonicalName 설정과 무관하다.

보안상 고려할 점

서버를 시작하는 사용자외에 다른 사용자가 로그파일을 저장하는 + 디렉토리에 쓰기 권한을 가질때 왜 보안에 문제가 생기는지 + 보안 팁 + 문서를 참고하라.

CookieLog 지시어

+ + + + + + + +

설명:	쿠키를 로그에 남기기위해 사용할 파일명을 설정한다
문법:	`CookieLog filename`
사용장소:	주서버설정, 가상호스트
상태:	Base
모듈:	mod_log_config
지원:	이 지시어는 사용되지 않는다.

CookieLog 지시어는 쿠키를 로그에 + 남기기위해 사용할 파일명을 설정한다. 파일명은 ServerRoot에 상대경로이다. 이 + 지시어는 mod_cookies와 호환을 위해 포함했을뿐, + 실제 사용되지 않는다.

+ +

CustomLog 지시어

+ + + + + + +

설명:	로그파일 이름과 형식을 지정한다
문법:	`CustomLog file\|pipe +format\|nickname +[env=[!]environment-variable]`
사용장소:	주서버설정, 가상호스트
상태:	Base
모듈:	mod_log_config

서버가 요청을 로그에 남길때 CustomLog + 지시어를 사용한다. 로그 형식을 지정하고, 환경변수를 사용하여 + 요청의 특징에 따라 선택적으로 로그를 남길 수도 있다.

+ +

로그를 기록할 장소를 지정하는 첫번째 아규먼트에는 다음 + 둘중 하나를 사용한다.

+ +

file: ServerRoot에 + 상대적인 파일명.
pipe: 파이프문자 "|"뒤에 로그 정보를 표준입력으로 + 받을 프로그램 경로를 적는다. + +
보안:
+
프로그램을 사용한다면 프로그램은 웹서버를 시작한 사용자 + 권한으로 실행된다. 서버를 root로 시작한다면 프로그램도 + root로 실행하므로 프로그램이 안전한지 확인하라.
+
+
주의
+
유닉스가 아닌 플래폼에서 파일경로를 입력할때 플래폼이 + 백슬래쉬를 사용하더라도 반드시 슬래쉬를 사용해야 한다. + 일반적으로 설정파일에서는 항상 슬래쉬를 사용하는 것이 + 좋다.
+

+ +

두번째 아규먼트는 로그파일에 기록할 내용을 지정한다. + 전에 LogFormat으로 + 정의한 nickname을 사용하거나 직접 로그 형식 절에서 설명한 format + 문자열을 사용할 수 있다.

+ +

예를 들어, 다음 두 지시어는 똑같은 일을 한다.

+ +

+ # 형식 별칭을 사용한 CustomLog + LogFormat "%h %l %u %t \"%r\" %>s %b" common + CustomLog logs/access_log common + + # 직접 형식 문자열을 사용한 CustomLog + CustomLog logs/access_log "%h %l %u %t \"%r\" %>s %b" +

+ +

세번째 아규먼트는 없어도 되며, 특정 서버 환경변수 유무에 + 따라 요청을 로그에 기록할지 여부를 결정한다. 요청에 지정한 + 환경변수가 정의되있다면 (혹은 + 'env=!name'를 사용한 경우 없다면) + 요청을 로그에 기록한다.

+ +

mod_setenvif나 mod_rewrite + 모듈을 사용하여 요청별로 환경변수를 설정할 수 있다. 예를 + 들어, 서버가 GIF 그림에 대한 모든 요청을 주서버 로그가 아닌 + 다른 로그파일에 기록하려면,

+ +

+ SetEnvIf Request_URI \.gif$ gif-image + CustomLog gif-requests.log common env=gif-image + CustomLog nongif-requests.log common env=!gif-image +

+ +

LogFormat 지시어

+ + + + + + + +

설명:	로그파일에 사용할 형식을 기술한다
문법:	`LogFormat format\|nickname +[nickname]`
기본값:	`LogFormat "%h %l %u %t \"%r\" %>s %b"`
사용장소:	주서버설정, 가상호스트
상태:	Base
모듈:	mod_log_config

이 지시어는 접근 로그파일의 형식을 지정한다.

+ +

LogFormat 지시어는 두가지 형식으로 + 사용한다. 첫번째 형식은 아규먼트를 한개만 사용하여 다음 + TransferLog 지시어들이 사용할 로그 + 형식을 지정한다. 이 아규먼트에 위의 로그 + 형식 지정하기 절에서 설명한 format을 직접 + 사용하거나, 다음에 설명할 LogFormat + 지시어로 미리 정의한 (로그 형식을 지칭하는) nickname을 + 사용할 수 있다.

+ +

LogFormat 지시어의 두번째 형식은 + format과 nickname을 연결한다. 그러면 + 뒤에서 사용하는 LogFormat이나 CustomLog 지시어에 반복해서 + 형식 문자열을 모두 입력하는 대신 nickname을 사용할 + 수 있다. 별칭을 정의하는 LogFormat + 지시어는 이 외에는 아무 기능을 하지 않는다. + 즉, 별칭만을 정의하며, 실제로 형식을 적용하거나 + 형식을 기본값으로 만들지 않는다. 그러므로 다음에 나오는 + TransferLog + 지시어에 영향을 주지 않는다. 또, + LogFormat은 별칭으로 다른 별칭을 + 정의할 수 있다. 별칭 이름에는 퍼센트 기호(%)를 + 사용할 수 없음을 주의하라.

+ +

예제

+ LogFormat "%v %h %l %u %t \"%r\" %>s %b" vhost_common +

+ +

TransferLog 지시어