cctklog4j.xml 참조
적용 대상: FAST Search Server 2010
마지막으로 수정된 항목: 2015-03-09
cctklog4j.xml 파일을 사용하여 FAST Search Lotus Notes 커넥터와 FAST Search 데이터베이스 커넥터에서 만드는 로그를 제어할 수 있습니다. 여기에는 콘솔 로그, 파일 로그 또는 Microsoft FAST Search Server 2010 for SharePoint 네트워크 로거가 포함됩니다. 이러한 로그에 기록되는 정보의 수준을 지정할 수도 있습니다.
경고
다음과 같은 경우에는 이 파일에서 변경한 모든 내용이 덮어쓰이고 손실됩니다.
-
Set-FASTSearchConfiguration Windows PowerShell cmdlet을 실행하는 경우
-
FAST Search Server 2010 for SharePoint 업데이트나 서비스 팩을 설치하는 경우
Set-FASTSearchConfiguration Windows PowerShell cmdlet을 실행하거나 FAST Search Server 2010 for SharePoint 업데이트 또는 서비스 팩을 설치한 후에는 변경 내용을 다시 적용해야 합니다.
FAST Search 커넥터는 시작할 때 로그 구성 명령을 확인하기 위해 cctklog4j.xml 파일을 읽습니다. 이 구성 파일은 각 커넥터 구성 요소에 대한 로그 수준을 설정하며 생성된 메시지에 대한 필터를 제공합니다. 예를 들어 주 커넥터 구성 요소에 대해서는 INFO 수준 로그를 설정하고 커넥터에서 사용하는 라이브러리에 대해서는 ERROR 수준 로그를 설정할 수 있습니다.
참고
구성 파일을 수정하려면 FAST Search Server 2010 for SharePoint이 설치된 컴퓨터에서 FASTSearchAdministrators 로컬 그룹의 구성원이어야 하는 최소 요구 사항을 만족하는지 확인합니다.
참고
로깅에는 log4j Java 유틸리티가 사용됩니다. cctklog4j.xml 파일에는 추가로 참조할 수 있도록 Apache log4j 설명서로 연결되는 링크가 포함되어 있습니다.
요소 빠른 참조
cctklog4j.xml파일에는 세 가지 종류의 요소가 포함되어 있습니다.
요소 형식 | 설명 |
---|---|
cctklog4j.xml appender 요소 참조 |
log4j는 "appender"를 사용하여 출력 대상(예: 콘솔 또는 파일)을 정의합니다. FAST Search 커넥터에 대해 console, rollingfile 및 net의 세 가지 로그 appender를 구성할 수 있습니다. 각 appender에는 특정 로그를 제어하는 데 사용할 수 있는 구성 매개 변수 집합이 있습니다. |
cctklog4j.xml logger 요소 참조 |
각 커넥터 구성 요소에는 별도의 로그와 로그 수준이 있습니다. logger는 이러한 로그의 대상과 로그에 기록되는 정보의 자세한 정도를 정의합니다. |
cctklog4j.xml root 요소 참조 |
이 요소는 appender를 지원하며 명시적으로 구성되어 있지 않은 구성 요소에 대한 로그 수준을 지정합니다. |
cctklog4j.xml 파일 형식
cctklog4j.xml 의 XML 요소는 <
로 시작해서 />
로 끝납니다.
기본 형식은 다음과 같습니다.
<appender name=[" 값 "]>
<param name=["값"] value=["값"] />
<layout class=["값"] >
<param name=["값"] value=["값"] />
</layout>
</appender>
<logger name=[" 값 "]>
<level value=["값"] />
</logger>
<root>
<level value=["값"] />
<appender-ref ref=["값"] />
</root>
예를 들면 다음과 같습니다.
<logger name="org.apache.axis.utils.JavaUtils">
<level value="ERROR"/>
</logger>
요소와 특성은 대/소문자를 구분하지만 특성 값은 대/소문자를 구분하지 않습니다. 특성 값은 따옴표(" ")로 묶어야 합니다.
요소 정의는 여러 줄에 입력할 수 있습니다. 요소 정의에서 공백, 캐리지 리턴, 줄 바꿈 및 탭 문자는 무시됩니다.
예를 들면 다음과 같습니다.
<logger name="org.apache.axis.utils.JavaUtils">
<level value="ERROR"/>
</logger>
팁
요소 정의가 긴 경우 특성을 여러 줄에 배치하고 들여쓰기를 사용하여 파일을 알아보기 쉽게 만듭니다.
<log4j:configuration>
요소는 특수한 경우이며 필수 요소입니다. 다른 모든 요소는 <log4j:configuration>
요소 내에 포함되며 이 요소는 </log4j:configuration>
을 사용하여 닫습니다.
<!--
와 -->
로 구분하여 어디에든 주석을 추가할 수 있습니다.
예를 들면 다음과 같습니다.
<!-- Setting the log level to ERROR avoids warnings about MIME -->
<logger name="org.apache.axis.utils.JavaUtils">
<level value="ERROR"/>
</logger>
cctklog4j.xml appender 요소 참조
appender 요소는 로깅 출력 형식과 로그의 실제 대상을 정의합니다.
하위 매개 변수와 레이아웃 클래스를 사용하여 요소를 추가로 지정할 수 있습니다.
cctklog4j.xml appender console 요소 참조
console appender를 사용하면 콘솔 출력과 메시지 내용을 지정할 수 있습니다.
특성 | 값 | 설명 |
---|---|---|
ConversionPattern |
%d{ABSOLUTE} %-5p [%c{1}] %m%n |
로그 메시지의 레이아웃을 지정합니다. 자세한 내용은 Apache log4j 설명서를 참조하십시오. 기본값: time, level, class name 및 message |
예
다음은 특정 메시지 레이아웃을 사용하여 출력을 구성하는 예입니다.
<appender name="console" class="org.apache.log4j.ConsoleAppender">
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%d{ABSOLUTE} %-5p [%c{1}] %m%n"/>
</layout>
</appender>
cctklog4j.xml appender rollingfile 요소 참조
rollingfile appender는 구성된 파일이 지정된 크기에 도달할 때까지 해당 파일에 메시지를 기록합니다. 로그 파일이 최대 크기에 도달하면 현재 파일의 이름이 바뀌고(파일 이름에 일련 번호가 추가됨) 새 로그 파일이 만들어집니다. 또한 이 appender는 롤링 집합의 최대 파일 수와 로그 메시지의 내용을 제어합니다.
특성 | 값 | 설명 |
---|---|---|
Append |
true|false |
true로 설정할 경우 커넥터를 시작하면 기존 파일에 추가합니다. false로 설정할 경우 비어 있는 파일에서 시작합니다. |
File |
log/${cctk.module}connector.log |
파일이 작성되는 경로입니다. 이 경로는 변경하지 마십시오. ${cctk.module}은 런타임에 자동으로 lotusnotesconnector나 jdbcconnector로 변경됩니다. |
MaxFileSize |
값 |
최대 파일 크기를 지정합니다. 이 파일 크기를 초과한 후부터는 동일한 이름의 새 파일에 메시지가 기록됩니다. 이전 파일은 일련 번호가 추가되어 이름이 수정됩니다. KB 단위 대신 MB 단위로 지정할 수도 있습니다. 기본값: 5,000KB |
MaxBackupIndex |
값 |
순서대로 로깅이 수행될 로그 파일의 최대 수를 지정합니다. 모든 파일이 최대 크기에 도달하면 가장 오래된 파일을 덮어씁니다. 기본값: 10 |
ConversionPattern |
%d{ISO8601} %-5p [%c{1}] %m%n |
자세한 내용은 Apache log4j 설명서를 참조하십시오. 기본값: datetime, level, class name 및 message. |
예
다음은 각각 5,000KB인 10개의 로그 파일에 순서대로 로그를 기록하는 rollingfile appender를 설정하는 예입니다.
<appender name="rollingfile" class="org.apache.log4j.RollingFileAppender">
<param name="Append" value="true"/>
<param name="File" value="log/${cctk.module}connector.log"/>
<param name="MaxFileSize" value="5000KB"/>
<param name="MaxBackupIndex" value="10"/>
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%d{ISO8601} %-5p [%c{1}] %m%n"/>
</layout>
</appender>
파일 이름은 lotusnotesconnector.log.1
, lotusnoteconnector.log.2
등으로 지정됩니다. 메시지에는 타임스탬프, 수준, 클래스 이름 및 메시지 내용이 포함됩니다.
cctklog4j.xml appender net 요소 참조
net appender는 FAST Search Server 2010 for SharePoint 네트워크 로거 파일 이름과 메시지 내용을 지정합니다.
참고
네트워크 로그 파일은 자동으로 만들어집니다. 이 요소와 특성은 변경하지 마십시오.
특성 | 값 | 설명 |
---|---|---|
LogHost |
hostname |
설치 관리자에 의해 자동으로 설정됩니다. 변경하지 마십시오. |
LogPort |
portnumber |
설치 관리자에 의해 자동으로 설정됩니다. 변경하지 마십시오. |
LogModuleName |
${cctk.module}connector |
런타임에 로그를 보내는 커넥터로 자동으로 설정됩니다. 변경하지 마십시오. |
예
다음은 localhost, 포트 13415에서 네트워크 로거를 찾는 예입니다.
<appender name="net" class="com.fastsearch.esp.cctk.logging.ESPLogServerAppender">
<param name="LogHost" value="localhost"/>
<param name="LogPort" value="13415"/>
<param name="LogModuleName" value="${cctk.module}connector"/>
</appender>
로그의 모듈 이름은 lotusnotesconnector
나 jdbcconnector
입니다.
cctklog4j.xml logger 요소 참조
logger 요소를 사용하면 로그에서 다양한 커넥터 구성 요소에 대해 기록되는 정보의 자세한 정도를 정의할 수 있습니다. 커넥터 구성 요소는 클래스의 패키지 이름을 통해 정의됩니다. 패키지는 있는 그대로 두어야 하지만(예: 로거를 제거하지 않아야 함) 자세한 정도는 변경할 수 있습니다.
특성 | 값 | 설명 |
---|---|---|
logger name |
로거 이름 |
커넥터 구성 요소를 지정합니다.
|
level value |
로깅 수준 |
로깅 수준을 지정합니다.
|
예
<logger name="com.fastsearch.esp.cctk">
<level value="INFO"/>
</logger>
<logger name="org.apache.axis.utils.JavaUtils">
<level value="ERROR"/>
</logger>
<logger name="org.apache.commons.httpclient">
<level value="ERROR"/>
</logger>
<logger name="com.fastsearch.esp.connectors.lotus">
<level value="INFO"/>
</logger>
<logger name="com.fastsearch.esp.connectors.lotus.userdirectory">
<level value="INFO"/>
</logger>
<logger name="com.fastsearch.esp.connectors.jdbc">
<level value="INFO"/>
</logger>
cctklog4j.xml root 요소 참조
root 요소를 사용하면 사용할 로그 appender를 정의할 수 있으며 cctklog4j.xml 구성에 개별적으로 지정되어 있지 않은 구성 요소에 대해 기록되는 정보의 자세한 정도를 지정할 수 있습니다.
특성 | 값 | 설명 |
---|---|---|
level value |
로깅 수준 |
로깅 수준을 지정합니다.
|
appender-ref ref |
log |
사용할 로그를 지정합니다.
|
예
<root>
<level value="WARN"/>
<appender-ref ref="console"/>
<appender-ref ref="rollingfile"/>
<appender-ref ref="net"/>
</root>