<< Click to Display Table of Contents >>

log.properties

로그의 기록 형태와 방법을 설정합니다.

서버 에러, 서버 동작 상황, 트랜잭션 정보 뿐만 아니라 HTTP 스토어 데이터 셋, XML 스토어를 바인딩하는 중 발생한 에러에 대해서도 로그를 기록할 수 있습니다.

로그는 콘솔과 파일 형태로 기록할 수 있으며, 윈도우 NT 이벤트와 유닉스 시스템 로그 및 메일로 전송할 수 있습니다.

Note

아래 옵션을 이용하지 않고 별도의 로그 라이브러리(log4j2, logback) 파일의 설정 값에 따라 로그를 기록하려면 log.properties 파일에 LogPropertyType=LibraryFile을 추가하시기 바랍니다.(오즈 자바 서버에서만 지원함)

General Option

Priority

로그 레벨을 설정합니다.

로그 레벨을 낮은 단계에서 높은 단계로 정렬하면 DEBUG, INFO, WARN, ERROR 순서입니다.

Value

Description

DEBUG

실제 에러, 서버의 트랜잭션 정보 뿐만 아니라 전반적인 서버 동작 상황을 로그에 기록

ERROR

실제 에러 상황에서만 로그에 기록

INFO

실제 에러와 서버의 트랜잭션 정보를 로그에 기록

WARN

실제 에러와 경고 수준의 에러를 로그에 기록

CONSOLE Option

자바 서버만 지원합니다.

CONSOLE.Type

실행 타입을 설정합니다.

Value

Description

Stdout

로그를 표준 입출력 장치에 출력

RollingFile

로그를 파일에 출력

CONSOLE.Layout

로그의 표시 형태를 설정합니다.

Value

Description

c

오즈 서버 카테고리 이름을 출력합니다.

카테고리 이름은 계층 구조로, %c{2}처럼 출력 단계를 지정할 수 있습니다.

d

날짜를 출력합니다.

패턴 문자를 조합하여 직접 설정하거나 Log4j의 패턴 문자(ABSOLUTE, DATE, ISO8601)를 이용할 수 있습니다.

m

로그 메시지를 발생시키는 오즈 서버 내부적으로 정해진 이벤트 이름을 출력합니다.

n

개행 문자를 출력합니다.

p

로그 레벨을 출력합니다.

%p 앞에 숫자 값을 입력하여 칸 수를 설정할 수 있습니다.

r

오즈 서버가 구동 중인 시간을 출력합니다.(단위: millisecond)

t

쓰레드 이름을 출력합니다.

%

% 기호를 출력합니다.

CONSOLE.Async

버퍼링 여부를 설정합니다.

CONSOLE.File

로그를 파일에 출력할 때 파일의 경로와 이름을 설정합니다.

ROLLING_FILE Option

ROLLING_FILE.Type

로그 파일의 생성 타입을 설정합니다.

Value

Description

DailyRollingFile

ROLLING_FILE.DatePattern 옵션에 설정한 대로 로그 파일 생성

RollingFile

ROLLING_FILE.File 옵션에서 설정한 파일 이름으로 로그 파일 생성

ROLLING_FILE.DatePattern

로그 파일 이름의 날짜 패턴을 설정합니다.

Value

Description

yyyy-MM

매달 초

yyyy-ww

매주 초

yyyy-MM-dd

매일 자정

yyyy-MM-dd-HH

매 시 정각

yyyy-MM-ddt

12시간

yyyy-MM-dd-HH-mm

매분

ROLLING_FILE.Layout

로그의 표시 형태를 설정합니다.

표시 형태에 설정할 수 있는 문자는 "CONSOLE.Layout" 부분을 참고하시기 바랍니다.

ROLLING_FILE.File

로그 파일의 경로와 이름을 설정합니다.

서버의 호스트 이름을 경로에 설정하려면 %HOST_NAME%으로 설정하시기 바랍니다.(오즈 자바 서버에서만 지원함)

ROLLING_FILE.Append

로그 이어쓰기 여부를 설정합니다.

서버가 재시작될 때 ROLLING_FILE.File 옵션에 설정한 파일에 새로운 로그를 기록할 때 ROLLING_FILE.File의 기존 내용에 이어서 기록할 때에는 true로, 기존 내용을 지우고 기록할 때에는 false로 설정하시기 바랍니다.

ROLLING_FILE.MaxBackupIndex

백업되는 로그 파일의 일련 번호 최대 값을 설정합니다.

백업 파일의 일련 번호가 최대 값을 넘길 경우 가장 오래된 파일이 삭제됩니다.

ROLLING_FILE.MaxFilesize

로그 파일의 최대 크기를 설정합니다.

로그 파일의 크기가 최대 크기를 넘길 경우 현재 파일은 일련 번호를 추가하여 다른 이름으로 변경하고, 다시 로그를 기록합니다.

예를 들어, 로그 파일 이름이 server.log인 경우 server.log.1로 파일 이름을 변경하고 server.log 파일을 새로 만들어 로그를 기록합니다.

ROLLING_FILE.MaxHistory

로그 파일의 최대 보관 일수을 설정합니다.

0보다 큰 값으로 설정할 경우 최대 보관 일수보다 이전 날짜에 생성된 로그 파일은 자동으로 삭제됩니다.

최대 보관 일수는 1000까지 설정할 수 있습니다.

0 또는 음수 값으로 설정할 경우 로그 파일을 삭제하지 않습니다.

ROLLING_FILE.ImmediateFlush

버퍼에 있는 로그를 로그 파일에 바로 추가할지 여부를 설정합니다.

NT_EVENT Option

자바 서버만 지원합니다.

NT_EVENT.Type

실행 타입을 설정합니다.

해당 기능을 사용하려면 오즈 서버의 lib 폴더에 있는 NTEventLogAppender.dll 파일을 윈도우 시스템 폴더로 이동시키기 바랍니다.

NT_EVENT.Layout

로그의 표시 형태를 설정합니다.

표시 형태에 설정할 수 있는 문자는 "CONSOLE.Layout" 부분을 참고하시기 바랍니다.

NT_EVENT.Threshold

윈도우 NT 이벤트로 보낼 로그 레벨을 설정합니다.

Priority 옵션에서 설정한 값보다 높은 단계의 라벨로 설정하시기 바랍니다.

SYSLOG Option

자바 서버만 지원합니다.

SYSLOG.Type

실행 타입을 설정합니다.

SYSLOG.Layout

로그의 표시 형태를 설정합니다.

표시 형태에 설정할 수 있는 문자는 "CONSOLE.Layout" 부분을 참고하시기 바랍니다.

SYSLOG.Threshold

유닉스 시스템 로그로 전송할 로그 레벨을 설정합니다.

Priority 옵션에서 설정한 값보다 높은 단계의 라벨로 설정하시기 바랍니다.

SYSLOG.SyslogHost

유닉스 호스트 IP를 설정합니다.

SYSLOG.Facility

해당 메시지가 발생하는 Facility를 설정합니다.

SYSLOG.FacilityPrinting

로그에 Facility 추가 여부를 설정합니다.

HTTPSTORE_LOG_FILE Option

HTTPSTORE_LOG_FILE

ODI에 추가된 HTTP 스토어의 데이터 셋을 바인딩하는 중 발생한 에러에 대한 로그 기록 옵션을 설정합니다.

Value

Description

AUTO

모든 HTTP 스토어 데이터 셋에 대해 로그를 기록

데이터 셋 디자인 시 서버 로그 파일 이름을 설정하지 않은 데이터 셋은 "OZ_HTTPSTATMENT.LOG.#" 형태로 로그 파일을 생성(#은 1부터 시작되는 일련 번호)

MANUAL

HTTP 스토어 데이터 셋 중 서버 로그 파일 이름이 설정된 데이터 셋만 로그를 기록

NONE

HTTP 스토어 데이터 셋에 대한 로그를 기록 안 함

HTTPSTORE_LOG_FILE.LOCATION

로그 파일의 저장 경로를 설정합니다.

XMLSTORE_LOG_FILE Option

XMLSTORE_LOG_FILE

ODI에 추가된 XML 스토어에서 XML 주소가 http:// 또는 https://일 때 파싱 에러에 대한 로그 기록 옵션을 설정합니다.

Value

Description

AUTO

XML 주소가 http:// 또는 https://인 모든 XML 스토어에 대해 로그를 기록

스토어 디자인 시 서버 로그 파일 이름을 설정하지 않은 스토어는 "OZHTTP_XPATH.LOG.#" 형태로 로그 파일을 생성(#은 1부터 시작되는 일련 번호)

MANUAL

XML 주소가 http:// 또는 https://인 XML 스토어 중 서버 로그 파일 이름이 설정된 스토어만 로그를 기록

NONE

XML 스토어에 대한 로그를 기록 안 함

XMLSTORE_LOG_FILE.MAXCOUNT

백업되는 로그 파일의 최대 개수를 설정합니다.

XMLSTORE_LOG_FILE.LOCATION

로그 파일의 저장 경로를 설정합니다.

VIEWER_DEBUG_FILE Option

VIEWER_DEBUG_FILE

VIEWER_DEBUG_FILE은 오즈 서버가 서블릿 형태로 실행된 경우에만 설정 가능합니다.

Value

Description

VIEWER_DEBUG_FILE.LOCATION

뷰어 디버그 로그 파일을 저장할 경로를 설정

뷰어 디버그 로그 파일 이름은 global.processorid 파라미터 값으로 적용됩니다.

VIEWER_DEBUG_FILE.MAXCOUNT

백업되는 뷰어 디버그 로그 파일의 최대 개수를 설정

최대 보관 개수는 4000까지 설정할 수 있습니다.

VIEWER_DEBUG_FILE.VALIDDAYS

뷰어 디버그 로그 파일의 보관 일수를 설정

보관 일수는 30까지 설정할 수 있습니다.

BUILTIN_LOGGING OPTION

자바 서버만 지원합니다.

BUILTIN_LOGGING은 오즈 서버 로그 처리를 위해 자체 개발한 로깅 엔진입니다. 고객 사이트의 특정 상황에 의해 오즈 서버에서 Log4j 방식으로 로그를 남길 수 없는 경우 BUILTIN_LOGGING 방식으로 사용하시기 바랍니다.

USE_BUILTIN_LOGGING_ENGINE

BUILTIN_LOGGING 방식의 사용 여부를 설정합니다.

BUILTIN_LOGGING_CONSOLE

로그를 콘솔에 출력할지 여부를 설정합니다.

BUILTIN_LOGGING_CONSOLE.CharSet

콘솔에 출력될 로그 내용의 문자 셋을 설정합니다.

값을 설정하지 않을 경우 시스템에 설정된 문자 셋으로 적용됩니다.

BUILTIN_LOGGING_FILE

로그를 파일로 출력할지 여부를 설정합니다.

BUILTIN_LOGGING_FILE.TYPE

로그 파일의 생성 타입을 설정합니다.

Value

Description

DailyRollingFile

BUILTIN_LOGGING_FILE.DatePattern 옵션에 설정한 대로 로그 파일 생성

RollingFile

BUILTIN_LOGGING_FILE.LOCATION 옵션에서 설정한 파일 이름으로 로그 파일 생성

BUILTIN_LOGGING_FILE.DatePattern

로그 파일 이름의 날짜 패턴을 설정합니다.

날짜 패턴에 설정할 수 있는 문자는 "ROLLING_FILE.DatePattern" 부분을 참고하시기 바랍니다.

BUILTIN_LOGGING_FILE.CharSet

콘솔에 출력될 로그 내용의 문자 셋을 설정합니다.

값을 설정하지 않을 경우 시스템에 설정된 문자 셋으로 적용됩니다.

BUILTIN_LOGGING_FILE.Append

로그가 생길 때마다 로그 파일에 추가할지 여부를 설정합니다.

BUILTIN_LOGGING_FILE.MaxBackupIndex

백업되는 로그 파일의 일련 번호 최대 값을 설정합니다.

백업 파일의 일련 번호가 최대 값을 넘길 경우 가장 오래된 파일이 삭제됩니다.

BUILTIN_LOGGING_FILE.MaxFileSize

로그 파일의 최대 크기를 설정합니다.

로그 파일의 크기가 최대 크기를 넘길 경우 현재 파일은 일련 번호를 추가하여 다른 이름으로 변경하고, 다시 로그를 기록합니다.

예를 들어, 로그 파일 이름이 server_oz.log인 경우 server_oz.log.1로 파일 이름을 변경하고  server_oz.log 파일을 새로 만들어 로그를 기록합니다.

BUILTIN_LOGGING_FILE.MaxHistory

로그 파일의 최대 보관 일수을 설정합니다.

0보다 큰 값으로 설정할 경우 최대 보관 일수보다 이전 날짜에 생성된 로그 파일은 자동으로 삭제됩니다.

최대 보관 일수는 1000까지 설정할 수 있습니다.

0 또는 음수 값으로 설정할 경우 로그 파일을 삭제하지 않습니다.

BUILTIN_LOGGING_FILE.ImmediateFlush

버퍼에 있는 로그를 로그 파일에 바로 추가할지 여부를 설정합니다.

BUILTIN_LOGGING_FILE.LOCATION

로그 파일의 경로와 이름을 설정합니다.

Mail Option

Mail.alias

mail.properties에서 설정한 앨리어스 이름을 설정합니다.

메일 정보를 log.properties에서 설정하지 않고, mail.properties에서 설정한 값으로 적용할 때 사용합니다.

Mail.active

서버 시작, 서버 종료, 에러 발생 시 해당 로그를 메일로 전송할지 여부를 설정합니다.

Mail.fromSend

보낸 사람 메일 주소를 설정합니다.

Mail.toSend

받는 사람 메일 주소를 설정합니다.

Mail.SMTPServer

보내는 메일 서버(SMTP) 주소를 설정합니다.

Mail.SMTPServerPort

보내는 메일 서버(SMTP) 포트를 설정합니다.

Mail.SMTPUserID

보내는 메일 서버(SMTP)의 인증이 필요할 때 사용자 이름을 설정합니다.

Mail.SMTPUserPassword

보내는 메일 서버(SMTP)의 인증이 필요할 때 사용자 암호를 설정합니다.

Mail.SMTPUserID_encrypted

보내는 메일 서버(SMTP)의 인증이 필요할 때 암호화된 사용자 이름을 설정합니다.

암호화된 사용자 이름을 설정할 경우 Mail.SMTPUserID에서 설정한 값은 무시됩니다.

Mail.SMTPUserPassword_encrypted

보내는 메일 서버(SMTP)의 인증이 필요할 때 암호화된 사용자 암호를 설정합니다.

암호화된 사용자 암호를 설정할 경우 Mail.SMTPUserPassword에서 설정한 값은 무시됩니다.

Mail.SendRetryCount

메일 전송을 실패했을 때 재전송할 횟수를 설정합니다.

Mail.SendRetryPeriodTime

메일 전송을 실패했을 때 재전송할 주기를 설정합니다.(단위: 초)

Mail.PrefixSubjectMessage

메일 제목 접두어를 설정합니다.

접두어를 설정할 경우 메일 제목은 "[접두어] 에러 메시지" 형태로 설정됩니다.

Mail.FilterType

Mail.FilterServiceCode에서 설정한 서비스 코드의 필터링 규칙을 설정합니다.

Value

Description

negative

Mail.FilterServiceCode에서 설정한 서비스 코드에서 에러 발생 시 메일 전송 안 함. 그 외 경우에는 메일 전송함

positive

Mail.FilterServiceCode에서 설정한 서비스 코드에서 에러 발생 시에만 메일 전송함. 그 외 경우에는 메일 전송 안 함

Mail.FilterServiceCode

서비스 코드를 설정합니다.

설정할 수 있는 서비스 코드는 monitor.properties 부분을 참고하시기 바랍니다.

REQUEST-URI Option

REQUEST_URI.LOCATION

REQUEST-URI 정보를 저장하는 파일의 경로를 설정합니다.

단, 파일 이름은 request_uri.log 파일로 생성됩니다.