다음을 통해 공유

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

로거 이름

커넥터 구성 요소를 지정합니다.

  • com.fastsearch.esp.cctk - CCTK(Connector Controller Tool Kit)의 로그 수준을 정의합니다.

  • org.apache.axis.utils.JavaUtils - 콘텐츠 공급에서 MIME 메시지의 로그 수준을 정의합니다.

  • org.apache.commons.httpclient - 쿠키 거부 메시지의 로그 수준을 정의합니다.

  • com.fastsearch.esp.connectors.lotus - FAST Search Lotus Notes 콘텐츠 커넥터 메시지의 로그 수준을 정의합니다.

  • com.fastsearch.esp.connectors.lotus.userdirectory - FAST Search Lotus Notes 사용자 디렉터리 커넥터 메시지의 로그 수준을 정의합니다.

  • com.fastsearch.esp.connectors.jdbc - FAST Search 데이터베이스 커넥터 메시지의 로그 수준을 정의합니다.

level value

로깅 수준

로깅 수준을 지정합니다.

  • INFO - 정보, 경고 및 오류 수준의 모든 메시지를 기록합니다.

  • DEBUG - 디버그, 정보, 경고 및 오류 수준의 모든 메시지를 기록합니다.

  • WARN - 정보 및 오류 수준의 모든 메시지를 기록합니다.

  • ERROR - 오류 수준의 모든 메시지를 기록합니다.

  • TRACE - 추적, 디버그, 정보, 경고 및 오류 수준의 모든 메시지를 기록합니다.

예

<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

로깅 수준

로깅 수준을 지정합니다.

  • INFO - 정보, 경고 및 오류 수준의 모든 메시지를 기록합니다.

  • DEBUG - 디버그, 정보, 경고 및 오류 수준의 모든 메시지를 기록합니다.

  • WARN - 정보 및 오류 수준의 모든 메시지를 기록합니다.

appender-ref ref

log

사용할 로그를 지정합니다.

  • console - 콘솔 로그를 사용합니다.

  • rollingfile - 롤링 파일 로그를 사용합니다.

  • net - FAST Search Server 2010 for SharePoint 네트워크 로깅을 사용합니다.

예

<root>

    <level value="WARN"/>

    <appender-ref ref="console"/>

    <appender-ref ref="rollingfile"/>

    <appender-ref ref="net"/>

</root>