| Sun Java System Application Server Enterprise Edition 8.1 관리 설명서 2005Q1 |
20장
로깅 구성이 장에서는 로깅을 구성하고 서버 로그를 조회하기 위해 관리 콘솔을 사용하는 방법에 대해 간단하게 설명합니다. 이 장은 다음 내용으로 구성되어 있습니다.
로깅 정보로그 레코드
Application Server에서는 JSR 047에 지정된 Java 2 플랫폼 로깅 API를 사용합니다. Application Server 로깅 메시지는 대개 domain_root_dir
/domain_dir/logs/server.log에 있는 서버 로그에 기록됩니다.domain_root_dir
/domain_dir/logs/디렉토리에는 서버 로그외에 다른 두 종류의 로그가 있습니다.access하위 디렉토리에는 HTTP 서비스 액세스 로그가 있고,tx하위 디렉토리에는 트랜잭션 서비스 로그가 있습니다. 이러한 로그에 대한 자세한 내용은 "HTTP 서비스 액세스 로그 구성" 및 "트랜잭션 구성"을 참조하십시오.Application Server의 구성 요소가 로깅 출력을 생성합니다. 응용 프로그램 구성 요소에서도 로깅 출력을 생성할 수 있습니다.
응용 프로그램 구성 요소에서 Apache Commons Logging Library를 사용하여 메시지를 로그할 수 있습니다. 그러나 더 좋은 로그 구성을 위해서는 플랫폼 표준 JSR 047 API를 권장합니다.
로그 레코드는 다음과 같은 일관된 형식을 따릅니다.
[#|yyyy-mm-ddThh:mm:ss.SSS-Z|Log Level|ProductName_Version|LoggerName|Key Value Pairs|Message|#]예를 들면 다음과 같습니다.
[#|2004-10-21T13:25:53.852-0400|INFO|sun-appserver-ee8.1|javax.enterprise.system.core|_ThreadID=13;|CORE5004: Resource Deployed: [cr:jms/DurableConnectionFactory].|#]이 예에서
[#및#]은 레코드의 시작과 끝을 표시합니다.- 세로 막대(
|)는 레코드 필드를 구분합니다.2004-10-21T13:25:53.852-0400은 날짜와 시간을 지정합니다.- Log Level은
INFO입니다. 이 수준은SEVERE,WARNING,INFO,CONFIG,FINE,FINER및FINEST값 중 하나일 수 있습니다.- ProductName_Version은
sun-appserver-ee8.1입니다.- LoggerName은 로그 모듈의 소스를 식별하는 계층적인 로거 이름 공간입니다. 이 경우에는
javax.enterprise.system.core입니다.- Key Value Pairs는 키 이름과 값입니다. 대개는
_ThreadID=14;같은 스레드 아이디입니다.- Message는 로그 메시지의 텍스트입니다. 모든 Application Server
SEVERE및WARNING메시지와 많은INFO메시지의 경우 모듈 코드와 숫자 값으로 구성된 메시지 아이디로 시작됩니다. 이 경우에는CORE5004입니다.앞으로의 릴리스에서 로그 레코드 형식이 변경되거나 향상될 수 있습니다.
로거 이름 공간 계층
Application Server에서는 각 모듈에 대한 로거를 제공합니다. 다음 표는 모듈 이름과 각 로거에 대한 이름 공간이 관리 콘솔의 로그 수준 페이지에 표시되는 알파벳 순서로 나열합니다. "로그 수준 구성"을 참조하십시오. 표의 마지막 세 모듈은 로그 수준 페이지에 표시되지 않습니다.
로깅을 위한 관리 콘솔 작업일반 로깅 설정 구성
- 트리 구성 요소에서 노드 에이전트나 구성 노드를 확장합니다.
- 노드 에이전트를 선택하거나 구성할 인스턴스를 선택합니다.
- 노드 에이전트의 경우 로거 설정 탭을 선택합니다. 구성의 경우 로거 설정 노드를 선택합니다.
- 로깅 설정 페이지에서 다음 필드를 사용하여 로깅을 사용자 정의합니다.
- 로그 파일: 서버 로그 파일에 대한 대체 이름이나 위치를 지정하려면 텍스트 필드에 새로운 경로 이름을 입력합니다. 기본 위치는 domain_root_dir
/domain_dir/logs/server.log입니다.- 경보: JMX 프레임워크를 통해
SEVERE및WARNING메시지를 라우팅하려면 사용 가능 확인란을 선택합니다.- 시스템 로그에 쓰기: Solaris 및 Linux 시스템의 경우 로깅 출력을 서버 로그 외에
syslog기능에 전송하려면 사용 가능 확인란을 선택합니다.- 로그 처리기:
server.log또는syslog이외의 다른 대상에 로그를 전송할 수 있도록 사용자 정의 로그 처리기를 플러그인할 수 있습니다. 사용자 정의 처리기에서 클래스java.util.logging.Handler(JSR 047 호환 API)를 확장해야 합니다. 로그 처리기 필드에서 처리기의 절대 클래스 이름을 입력합니다. 서버 시작 중에 처리기가 설치되도록 Application Server 클래스 경로에 처리기 클래스를 포함합니다. 사용자 정의 처리기의 로그 레코드 형식은 "로그 레코드"에서 설명한 것과 같습니다.- 로그 필터:
server.log,syslog같은 대상이나 사용자 정의 로그 처리기에서 정의한 대상으로 전송한 로그 레코드를 필터링할 수 있도록 사용자 정의 로그 필터를 플러그인할 수 있습니다. 사용자 정의 필터에java.util.logging.Filter인터페이스를 구현해야 합니다. 로그 필터 필드에서 필터의 절대 클래스 이름을 입력합니다. 서버 시작 중에 필터가 설치되도록 Application Server 클래스 경로에 필터 클래스도 포함합니다.- 파일 회전 제한: 서버 로그가 지정한 크기(바이트)에 도달하면
server.log라고 하는 새로운 빈 파일을 만들고 이전 파일의 이름을server.log_date로 바꿉니다. 여기서 date는 파일이 회전된 날짜와 시간입니다. 기본값은 2MB입니다. 제한의 최소값은 500KB입니다. 더 낮은 값을 지정해도 500KB에 도달해야 파일이 회전됩니다. 로그 파일 회전을 해제하려면 값을 0으로 설정합니다.- 파일 회전 시간 제한: 지정한 시간(분)이 지나면 서버 로그를 회전합니다. 기본값은 0으로 파일 회전 제한 필드에 지정한 크기에 도달하면 파일이 회전됨을 의미합니다. 1분 이상을 지정할 경우 시간 제한이 크기 제한보다 우선합니다.
- 저장을 눌러 변경 사항을 저장합니다. 로그 파일 보기를 눌러 서버 로그를 확인합니다.
로그 수준 구성
- 트리 구성 요소에서 노드 에이전트나 구성 노드를 확장합니다.
- 노드 에이전트를 선택하거나 구성할 인스턴스를 선택합니다.
- 노드 에이전트의 경우 로그 수준 탭을 선택합니다. 구성의 경우 로거 설정 노드를 선택한 다음 로그 수준 탭을 선택합니다.
- 모듈 로그 수준 페이지에서 로그 수준을 변경할 모듈 반대쪽에 있는 드롭다운 목록에서 새로운 값을 선택합니다. 기본값은
INFO로, 이보다 더 높은 수준의 메시지(WARNING,SEVERE)가 로그에 표시됨을 의미합니다. 최고값에서 최저값까지 나열된 다음 값 중에서 선택합니다.- 추가 등록 정보 영역을 사용하여 응용 프로그램 로거에 대한 로그 수준을 구성합니다. 등록 정보 이름은 로거 이름 공간이고, 값은 여덟 가지 가능한 수준 중 하나입니다. 예를 들어, 등록 정보 이름은
samples.logging.simple.servlet일 수 있고, 값은FINE일 수 있습니다.이 영역을 사용하여 하위 모듈(예: CORBA 모듈의 전송 하위 모듈)에 대한 로그 수준도 변경합니다.
javax.enterprise.resource.corba.ORBId.transport- 저장을 눌러 변경 사항을 저장하거나, 기본값 로드를 눌러 기본값을 복구합니다.
System.out.println에 대한 호출은 로거 이름javax.enterprise.system.stream.out을 사용하여INFO수준에서 로깅됩니다.System.err.println에 대한 호출은 로거 이름javax.enterprise.system.stream.err을 사용하여WARNING수준에서 로깅됩니다. 이 소스의 로그를 해제하려면 추가 등록 정보 영역에서OFF값과 함께 로거 이름을 지정합니다.로그 수준 설정에 대한 변경 사항은 즉시 적용됩니다. 이 변경 사항은 서버를 다시 시작할 때 사용할 수 있도록
domain.xml파일에도 저장됩니다.서버 로그 보기
검색 기준 영역을 사용하여 로그 뷰어를 사용자 정의하거나 필터링합니다. 다음과 같은 기본 필드를 사용합니다.
- 인스턴스 이름: 드롭다운 목록에서 인스턴스 이름을 선택하여 해당 서버 인스턴스에 대한 로그를 확인합니다. 기본값은 현재 서버 인스턴스입니다.
- 로그 파일: 드롭다운 목록에서 로그 파일 이름을 선택하여 그 로그 내용을 확인합니다. 기본값은
server.log입니다.- 타임스탬프: 가장 최근 메시지를 보려면 가장 최근(기본값)을 선택합니다. 특정 기간의 메시지만 보려면 특정 범위를 선택하고 표시되는 시작 및 끝 필드에 날짜와 시간 값을 입력합니다. 시간 값의 경우 구문은 다음 형식을 따라야 합니다. 여기에서 SSS는 밀리초의 약자입니다.
hh:mm:ss.SSS
확인할 메시지가 서버 로그에 표시되게 하려면 먼저 로그 수준 페이지에서 적절한 로그 수준을 설정합니다. "로그 수준 구성"을 참조하십시오.
로그 수준을 기준으로 로그 메시지를 필터링하도록 선택한 경우 지정한 필터 기준에 맞는 메시지만 표시됩니다. 그러나 이 필터링은 어떤 메시지를 서버 로그에 로깅할지에는 영향을 미치지 않습니다.
로깅 설정 페이지와 로그 수준 페이지에서 지정한 설정과 함께 서버 로그의 가장 최근 40개 항목이 표시됩니다.
타임스탬프 헤더 옆에 있는 삼각형을 눌러 가장 최근 항목이 마지막으로 표시되도록 메시지를 정렬합니다.
메시지를 형식이 지정된 모양으로 보려면 표시된 링크를 누릅니다.
(details)로그 항목 세부 정보 창이 형식 지정된 버전의 메시지와 함께 표시됩니다.
항목 목록 끝에서 버튼을 눌러 로그 파일의 이전 또는 이후 항목을 확인합니다.
검색 기준 영역에서 고급 검색을 눌러 로그 뷰어를 더 구체화합니다. 다음과 같은 고급 옵션 필드를 사용합니다.
고급 옵션 영역을 숨기려면 기본 검색을 누릅니다.