Sun Java System Application Server Enterprise Edition 8.1 2005Q2 관리 설명서

로깅을 위한 관리 콘솔 작업

Procedure일반 로깅 설정을 구성하는 방법

  1. 트리 구성 요소에서 노드 에이전트나 구성 노드를 확장합니다.

  2. 노드 에이전트를 선택하거나 구성할 인스턴스를 선택합니다.

    • 특정 인스턴스를 구성하려면 해당 인스턴스 구성 노드를 선택합니다. 예를 들어, 기본 인스턴스 server에 대해 server-config 노드를 선택합니다.

    • default-config의 사본을 사용하는 예비 인스턴스에 대한 기본 설정을 구성하려면 default-config 노드를 선택합니다.

  3. 노드 에이전트의 경우 로거 설정 탭을 선택합니다. 구성의 경우 로거 설정 노드를 선택합니다.

  4. 로깅 설정 페이지에서 다음 필드를 사용하여 로깅을 사용자 정의합니다.

    • 로그 파일 — 서버 로그 파일에 대한 대체 이름이나 위치를 지정하려면 텍스트 필드에 새로운 경로 이름을 입력합니다. 기본 위치는 domain-dir/logs/server.log입니다.

    • 경보 — JMX 프레임워크를 통해 SEVEREWARNING 메시지를 라우팅하려면 사용 가능 확인란을 선택합니다.

    • 시스템 로그에 쓰기 — 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. 저장을 눌러 변경 사항을 저장합니다. 로그 파일 보기를 눌러 서버 로그를 확인합니다.

Procedure로그 수준을 구성하는 방법

  1. 트리 구성 요소에서 노드 에이전트나 구성 노드를 확장합니다.

  2. 노드 에이전트를 선택하거나 구성할 인스턴스를 선택합니다.

    • 특정 인스턴스를 구성하려면 해당 인스턴스 구성 노드를 선택합니다. 예를 들어, 기본 인스턴스 server에 대해 server-config 노드를 선택합니다.

    • default-config의 사본을 사용하는 예비 인스턴스에 대한 기본 설정을 구성하려면 default-config 노드를 선택합니다.

  3. 노드 에이전트의 경우 로그 수준 탭을 선택합니다. 구성의 경우 로거 설정 노드를 선택한 다음 로그 수준 탭을 선택합니다.

  4. 모듈 로그 수준 페이지에서 로그 수준을 변경할 모듈 반대쪽에 있는 드롭다운 목록에서 새로운 값을 선택합니다.

    기본 수준은 INFO로 해당 수준 이상의 메시지(WARNING, SEVERE)가 로그에 표시됨을 의미합니다. 최고값에서 최저값까지 나열된 다음 값 중에서 선택합니다.

    • SEVERE

    • WARNING

    • INFO

    • CONFIG

    • FINE

    • FINER

    • FINEST

    • OFF

  5. 추가 등록 정보 영역을 사용하여 응용 프로그램 로거에 대한 로그 수준을 구성합니다.

    등록 정보 이름은 로거 이름 공간이고 값은 여덟 가지 가능한 수준 중 하나입니다. 예를 들어, 등록 정보 이름은 samples.logging.simple.servlet이고 값은 FINE일 수 있습니다.

    이 영역을 사용하여 하위 모듈(예: 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 파일에도 저장됩니다.

Procedure서버 로그를 보는 방법

  1. 트리 구성 요소에서 확인할 로그의 서버 인스턴스에 대한 노드를 확장합니다.

  2. 일반 정보 페이지에서 로그 파일 보기를 누릅니다.

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

    • 인스턴스 이름 — 드롭다운 목록에서 인스턴스 이름을 선택하여 해당 서버 인스턴스에 대한 로그를 확인합니다. 기본값은 현재 서버 인스턴스입니다.

    • 로그 파일 — 드롭다운 목록에서 로그 파일 이름을 선택하여 해당 로그 내용을 확인합니다. 기본값은 server.log입니다.

    • 타임스탬프 — 가장 최근 메시지를 보려면 가장 최근(기본값)을 선택합니다. 특정 기간의 메시지만 보려면 특정 범위를 선택하고 표시되는 시작 및 끝 필드에 날짜와 시간 값을 입력합니다. 시간 값의 경우 구문은 다음 형식을 따라야 합니다. 여기에서SSS는 밀리초의 약자입니다.


      hh:mm:ss.SSS
      

      예를 들면 다음과 같습니다.


      17:10:00.000

      시작 값이 끝 값보다 이후일 경우 오류 메시지가 표시됩니다.

    • 로그 수준 — 로그 수준별로 메시지를 필터링하려면 드롭다운 목록에서 로그 수준을 선택합니다. 기본적으로 선택한 로그 수준과 더 심각한 수준에서 서버 로그에 표시되는 모든 메시지가 표시됩니다. 선택한 수준의 메시지만 표시하려면 “더 심각한 메시지를 포함하지 않습니다.” 확인란을 선택합니다.

      확인할 메시지가 서버 로그에 표시되게 하려면 먼저 로그 수준 페이지에서 적절한 로그 수준을 설정합니다. 로그 수준을 구성하는 방법을 참조하십시오.

      로그 수준을 기준으로 로그 메시지를 필터링하도록 선택한 경우 지정한 필터 기준에 맞는 메시지만 표시됩니다. 그러나 이 필터링은 어떤 메시지를 서버 로그에 로깅할지에는 영향을 미치지 않습니다.

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

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

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


      (details)

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

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

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

    • 로거 — 모듈별로 필터링하려면 드롭다운 목록에서 하나 이상의 이름 공간을 선택합니다. 또는 Shift 키나 Control 키를 누르면 여러 이름 공간을 선택할 수 있습니다.

      더 높은 수준의 이름 공간을 선택하면 그 아래에 있는 모든 이름 공간이 선택됩니다. 예를 들어, javax.enterprise.system을 선택하면 해당 이름 공간에 속한 모든 모듈에 대한 로거도 선택됩니다(예: javax.enterprise.system.core, javax.enterprise.system.tools.admin 등).

    • 사용자 정의 로거 — 특정 응용 프로그램에 관련된 로거의 메시지를 보려면 텍스트 필드에 로거 이름을 한 줄에 하나씩 입력합니다. 응용 프로그램에 여러 모듈이 있을 경우 모두 표시하거나 선택해서 표시할 수 있습니다. 예를 들어 응용 프로그램에 다음과 같은 이름의 로거가 있다고 가정합니다.


      com.mycompany.myapp.module1
      com.mycompany.myapp.module2
      com.mycompany.myapp.module3

      응용 프로그램에 있는 모든 모듈의 메시지를 나타내려면 com.mycompany.myapp를 입력합니다. module2의 메시지만 확인하려면 com.mycompany.myapp.module2를 입력합니다.

      사용자 정의 로거를 하나 이상 지정한 경우 해당 로거를 로거 영역에 명시적으로 지정해야만 Application Server 모듈의 메시지가 표시됩니다.

    • 이름 값 쌍 — 특정한 스레드의 출력을 보려면 텍스트 필드에서 해당 스레드에 대한 키 이름과 값을 입력합니다. 키 이름은 _ThreadID입니다. 예를 들면 다음과 같습니다.


      _ThreadID=13

      com.mycompany.myapp.module2가 여러 스레드에서 실행되는 것으로 가정합니다. 단일 스레드의 출력만 표시하도록 로거 뷰어를 구체화하려면 사용자 정의 로거 필드에서 모듈의 로거를 지정한 다음 이 필드에서 스레드 아이디를 지정합니다.

    • 표시 — 한 번에 40개 이상(기본값)의 메시지를 보려면 드롭다운 목록에서 사용 가능한 값(100, 250 또는 1000) 중 하나를 선택합니다.

      스택 추적을 보려면 “과도하게 긴 메시지를 제한합니다.” 확인란을 선택 취소합니다. 기본적으로 스택 추적은 뷰어에 표시되지 않습니다. 스택 추적을 보려면 메시지의 (details) 링크를 누릅니다.

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