The Logger Component

Logger 엘리먼트는, Catalina 컨테이너(Engine, Host, 또는 Context)의 로깅, 디버깅, 그리고 에러메시지(스택 트레이스 포함)의 목적지(destination)를 나타냅니다. 또한 어떤 Engine이나 Host와 연결된 Logger 들은 명시적으로 재설정하지 않으면 자동적으로 하위의 컨테이너로부터 설정을 물려 받습니다.

웹서버같이 액세스로그를 만드는데 관심이 있다면(가령 히트수 분석 소프트웨어를 돌리려고), 그 Engine, Host, 또는 Context의 액세스로그 밸브(Access Log Valve) 컴포넌트 설정이 필요할 것입니다.

이하의 설명에서는 $CATALINA_HOME 변수명을 사용하여 당신이 Tomcat 4를 설치한 디렉토리를 참조하며, 이 디렉토리가 대부분의 상대경로에 대한 기준 디렉토리(base directory)가 됩니다. 그러나 만약 CATALINA_BASE 디렉토리를 설정하여 Tomcat 4를 여러개 설치했다면, 이러한 디렉토리 참조에 대해 $CATALINA_HOME 대신 $CATALINA_BASE 를 사용해야 합니다.

Common Attributes

Logger 엘리먼트의 모든 구현체는 다음 속성들을 지원하게 됩니다: Attribute Description className 사용할 Java 구현체 클래스의 이름. 이 클래스는 반드시 org.apache.catalina.Logger 인터페이스를 구현해야 합니다. 지정하지 않으면 표준값(아래에 정의됩니다)이 사용됩니다. verbosity 이 로거에 대한 상세수준(verbosity level). 지정한 값보다 높은 상세수준의 메시지는 조용히 무시됩니다. 가능한 값은 0 (중요 메시지만), 1 (에러), 2 (경고), 3 (정보), 그리고 4 (디버그) 입니다. 지정하지 않은 경우 1 (에러) 입니다. NOTE - 명시적 상세수준을 가진 메시지만 이 값과 비교하여 로그여부를 결정합니다. 명시적 상세수준이 없는 메시지는 무조건 로그됩니다.

Standard Implementation

대부분의 Catalina 컴포넌트와는 달리 Logger의 경우에는, 사용할 수 표준 구현체가 여러개입니다. 따라서 사용하고자 하는 구현체를 반드시 className 속성을 사용해서 지정해야 합니다. File Logger (org.apache.catalina.logger.FileLogger) File Logger는 한 지정된 디렉토리 안의 파일에 로그되는 메시지를 기록합니다. 로그파일의 실제 파일명은 설정된 prefix, YYYY-MM-DD 포맷의 현재 날짜, 그리고 설정된 suffix로 이루어집니다. 각 날의 자정을 지난 이후에 어떤 메시지가 로그되면, 이 메시지가 발생하자마자 현재의 로그파일은 닫혀지고 새 로그파일이 새 날짜로 생성되어 열립니다. 따라서 이런 로그파일의 전환 때문에 Catalina를 재부팅시킬 필요는 없습니다. File Logger가 지원하는 속성은 다음과 같습니다: Attribute Description directory 이 로거가 생성할 로그파일이 위치할 디렉토리의 절대/상대경로명. 상대경로로 지정되면 $CATALINA_HOME을 기준으로 해석합니다. directory 속성을 지정하지 않으면 디폴트 값은 "logs"($CATALINA_HOME에 상대적임) 입니다. prefix 각 로그파일명의 시작부분에 붙여질 prefix. 지정하지 않으면 "catalina."이 됩니다. 아무 prefix도 붙이지 않으려면 길이가 0인 문자열("")을 사용하면 됩니다. suffix 각 로그파일명의 끝부분에 붙여질 suffix. 지정하지 않으면 ".log"가 됩니다. 아무 suffix도 붙이지 않으려면 길이가 0인 문자열("")을 사용하면 됩니다. timestamp 모든 로그메시지에 날짜와 시간을 붙이려면 true로 지정하십시오. false(디폴트)로 지정하면 날짜와 시간은 찍히지 않습니다. Standard Error Logger (org.apache.catalina.logger.SystemErrLogger) Standard Error Logger는, Catalina의 표준 에러출력스트림으로 정해진 스트림으로 로그되는 모든 메시지를 기록합니다. Catalina의 디폴트 기동 스크립트에서는 표준 에러출력스트림을 $CATALINA_HOME 아래의 logs/catalina.out 파일로 지정해 놓습니다. 이 로거에서 지원하는 추가 속성은 없습니다. Standard Output Logger (org.apache.catalina.logger.SystemOutLogger) Standard Output Logger는, Catalina의 표준 출력스트림으로 정해진 스트림으로 로그되는 모든 메시지를 기록합니다. Catalina의 디폴트 기동 스크립트에서는 표준 출력스트림을 $CATALINA_HOME 아래의 logs/catalina.out 파일로 지정해 놓습니다. 이 로거에서 지원하는 추가 속성은 없습니다.

Logger 엘리먼트 내에 포함될 수 있는 컴포넌트는 없습니다.

Logger 엘리먼트와 관련된 특별기능은 없습니다.