Sun 로고      이전      목차      다음     

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].|#]

이 예에서

앞으로의 릴리스에서 로그 레코드 형식이 변경되거나 향상될 수 있습니다.

로거 이름 공간 계층

Application Server에서는 각 모듈에 대한 로거를 제공합니다. 다음 표는 모듈 이름과 각 로거에 대한 이름 공간이 관리 콘솔의 로그 수준 페이지에 표시되는 알파벳 순서로 나열합니다. "로그 수준 구성"을 참조하십시오. 표의 마지막 세 모듈은 로그 수준 페이지에 표시되지 않습니다.

표 20-1  Application Server 로거 이름 공간 

모듈 이름

이름 공간

관리

javax.enterprise.system.tools.admin

클래스 로더

javax.enterprise.system.core.classloading

CMP

javax.enterprise.system.container.cmp

구성

javax.enterprise.system.core.config

커넥터

javax.enterprise.resource.resourceadapter

CORBA

javax.enterprise.resource.corba

배포

javax.enterprise.system.tools.deployment

EJB 컨테이너

javax.enterprise.system.container.ejb

JavaMail

javax.enterprise.resource.javamail

JAXR

javax.enterprise.resource.webservices.registry

JAX-RPC

javax.enterprise.resource.webservices.rpc

JDO

javax.enterprise.resource.jdo

JMS

javax.enterprise.resource.jms

JTA

javax.enterprise.resource.jta

JTS

javax.enterprise.system.core.transaction

MDB 컨테이너

javax.enterprise.system.container.ejb.mdb

이름 지정

javax.enterprise.system.core.naming

노드 에이전트(Enterprise Edition에만 해당)

javax.ee.enterprise.system.nodeagent

루트

javax.enterprise

SAAJ

javax.enterprise.resource.webservices.saaj

보안

javax.enterprise.system.core.security

서버

javax.enterprise.system

동기화(Enterprise Edition에만 해당)

javax.ee.enterprise.system.tools.synchronization

Util

javax.enterprise.system.util

검증자

javax.enterprise.system.tools.verifier

웹 컨테이너

javax.enterprise.system.container.web

코어

javax.enterprise.system.core

시스템 출력(System.out.println)

javax.enterprise.system.stream.out

시스템 오류(System.err.println)

javax.enterprise.system.stream.err

로깅을 위한 관리 콘솔 작업

일반 로깅 설정 구성

  1. 트리 구성 요소에서 노드 에이전트나 구성 노드를 확장합니다.
  2. 노드 에이전트를 선택하거나 구성할 인스턴스를 선택합니다.
    1. 특정 인스턴스를 구성하려면 그 인스턴스의 구성 노드를 선택합니다. 예를 들어 기본 인스턴스 server는 server-config 노드를 선택합니다.
    2. default-config의 사본을 사용하는 앞으로의 인스턴스에 대한 기본 설정을 구성하려면 default-config 노드를 선택합니다.
  3. 노드 에이전트의 경우 로거 설정 탭을 선택합니다. 구성의 경우 로거 설정 노드를 선택합니다.
  4. 로깅 설정 페이지에서 다음 필드를 사용하여 로깅을 사용자 정의합니다.
    • 로그 파일: 서버 로그 파일에 대한 대체 이름이나 위치를 지정하려면 텍스트 필드에 새로운 경로 이름을 입력합니다. 기본 위치는 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분 이상을 지정할 경우 시간 제한이 크기 제한보다 우선합니다.
  5. 저장을 눌러 변경 사항을 저장합니다. 로그 파일 보기를 눌러 서버 로그를 확인합니다.

로그 수준 구성

  1. 트리 구성 요소에서 노드 에이전트나 구성 노드를 확장합니다.
  2. 노드 에이전트를 선택하거나 구성할 인스턴스를 선택합니다.
    1. 특정 인스턴스를 구성하려면 그 인스턴스의 구성 노드를 선택합니다. 예를 들어 기본 인스턴스 server는 server-config 노드를 선택합니다.
    2. default-config의 사본을 사용하는 앞으로의 인스턴스에 대한 기본 설정을 구성하려면 default-config 노드를 선택합니다.
  3. 노드 에이전트의 경우 로그 수준 탭을 선택합니다. 구성의 경우 로거 설정 노드를 선택한 다음 로그 수준 탭을 선택합니다.
  4. 모듈 로그 수준 페이지에서 로그 수준을 변경할 모듈 반대쪽에 있는 드롭다운 목록에서 새로운 값을 선택합니다. 기본값은 INFO로, 이보다 더 높은 수준의 메시지(WARNING, SEVERE)가 로그에 표시됨을 의미합니다. 최고값에서 최저값까지 나열된 다음 값 중에서 선택합니다.
    • SEVERE
    • WARNING
    • INFO
    • CONFIG
    • FINE
    • FINER
    • FINEST고
    • OFF
  5. 추가 등록 정보 영역을 사용하여 응용 프로그램 로거에 대한 로그 수준을 구성합니다. 등록 정보 이름은 로거 이름 공간이고, 값은 여덟 가지 가능한 수준 중 하나입니다. 예를 들어, 등록 정보 이름은 samples.logging.simple.servlet일 수 있고, 값은 FINE일 수 있습니다.

    6. 이 영역을 사용하여 하위 모듈(예: CORBA 모듈의 전송 하위 모듈)에 대한 로그 수준도 변경합니다.

    javax.enterprise.resource.corba.ORBId.transport
  6. 저장을 눌러 변경 사항을 저장하거나, 기본값 로드를 눌러 기본값을 복구합니다.

System.out.println에 대한 호출은 로거 이름 javax.enterprise.system.stream.out을 사용하여 INFO 수준에서 로깅됩니다. System.err.println에 대한 호출은 로거 이름 javax.enterprise.system.stream.err을 사용하여 WARNING 수준에서 로깅됩니다. 이 소스의 로그를 해제하려면 추가 등록 정보 영역에서 OFF 값과 함께 로거 이름을 지정합니다.

로그 수준 설정에 대한 변경 사항은 즉시 적용됩니다. 이 변경 사항은 서버를 다시 시작할 때 사용할 수 있도록 domain.xml 파일에도 저장됩니다.

서버 로그 보기

  1. 트리 구성 요소에서 확인할 로그의 서버 인스턴스에 대한 노드를 확장합니다.
  2. 일반 정보 페이지에서 로그 파일 보기를 누릅니다.

검색 기준 영역을 사용하여 로그 뷰어를 사용자 정의하거나 필터링합니다. 다음과 같은 기본 필드를 사용합니다.

로깅 설정 페이지와 로그 수준 페이지에서 지정한 설정과 함께 서버 로그의 가장 최근 40개 항목이 표시됩니다.

타임스탬프 헤더 옆에 있는 삼각형을 눌러 가장 최근 항목이 마지막으로 표시되도록 메시지를 정렬합니다.

메시지를 형식이 지정된 모양으로 보려면 표시된 링크를 누릅니다.

(details)

로그 항목 세부 정보 창이 형식 지정된 버전의 메시지와 함께 표시됩니다.

항목 목록 끝에서 버튼을 눌러 로그 파일의 이전 또는 이후 항목을 확인합니다.

검색 기준 영역에서 고급 검색을 눌러 로그 뷰어를 더 구체화합니다. 다음과 같은 고급 옵션 필드를 사용합니다.

고급 옵션 영역을 숨기려면 기본 검색을 누릅니다.



이전      목차      다음     

Copyright 2004 - 2005 Sun Microsystems, Inc. 모든 권리는 저작권자의 소유입니다.