loggerconfig.xml 참조

아티클
01/25/2017

적용 대상: FAST Search Server 2010

마지막으로 수정된 항목: 2015-03-09

LoggerConfig.xml을 사용하여 FAST Search Server 2010 for SharePoint 구성 요소에서 전송되는 로그 메시지에 대한 라우팅과 필터링을 구성할 수 있습니다. 로깅 프로세스는 세 단계로 이루어지며 첫 번째 단계는 LoggerConfig.xml에서 구성하고 로컬 로그 서버와 주 로그 서버에 대한 마지막 두 단계는 LogServerConfig.xml에서 구성합니다.

경고

다음과 같은 경우에는 이 파일에서 변경한 모든 내용이 덮어쓰이고 손실됩니다.

Set-FASTSearchConfiguration Windows PowerShell cmdlet을 실행하는 경우
FAST Search Server 2010 for SharePoint 업데이트나 서비스 팩을 설치하는 경우

변경한 내용이 손실되지 않도록 하려면 이 파일을 수정한 후 백업해야 합니다.
Set-FASTSearchConfiguration Windows PowerShell cmdlet을 실행하거나 FAST Search Server 2010 for SharePoint 업데이트 또는 서비스 팩을 설치한 후에는 변경 내용을 다시 적용해야 합니다.

LoggerConfig.xml 구성 파일에서는 FAST Search Server 2010 for SharePoint에서 출력 로그 메시지를 처리하는 방식을 결정합니다. 로그 메시지는 대개 후속 라우팅 및 필터링을 위해 로컬 로그 서버로 전송될 뿐 아니라 로그 파일 및 콘솔 출력으로도 전송됩니다. 로컬 및 주 로그 서버의 구성에 대한 자세한 내용은 logserverconfig.xml을 참조하십시오.

LoggerConfig.xml에는 로그 메시지가 전송되는 로깅 대상을 설정하는 데 사용되는 destinations의 목록이 포함되어 있습니다. programs 목록에서는 개별 로그 원본에 대한 로그 수준 필터링을 구성합니다. 들어오는 로그 메시지가 정의된 programs와 일치하지 않는 경우에는 기본 program 항목(name=default)이 사용됩니다.

설치된 버전의 LoggerConfig.xml을 편집하여 기존 값을 조정하거나, 프로그램 요소를 추가하여 특정 로그 원본에 대한 필터링 및 라우팅을 재정의할 수 있습니다. 하지만 대부분의 경우에는 기본값을 사용하면 됩니다.

LoggerConfig.xml 사용자 지정

참고

구성 파일을 수정하려면 FAST Search Server 2010 for SharePoint이 설치된 컴퓨터에서 FASTSearchAdministrators 로컬 그룹의 구성원이어야 하는 최소 요구 사항을 만족하는지 확인합니다.

텍스트 편집기나 XML 편집기를 사용하여 이 파일을 변경할 수 있습니다. 편집 내용을 적용하려면 구성 변경 내용과 관련된 FAST Search Server 2010 for SharePoint 구성 요소를 다시 시작해야 합니다.

요소 빠른 참조

LoggerConfig.xml 에서는 다음과 같은 요소를 사용합니다.

최상위 요소입니다.

로그 대상의 목록입니다.

로컬 로그 서버로 로그 메시지를 네트워크를 통해 전달하기 위한 구성입니다.

파일에 대한 로깅을 위한 구성입니다.

콘솔 또는 파이프에 대한 출력을 위한 구성입니다.

로그 원본의 목록입니다.

로그 원본의 라우팅 및 필터링 사양입니다.

로그 수준 임계값 필터를 사용하여 특정 대상으로 로그 메시지를 라우팅하기 위한 사양입니다.

LoggerConfig.xml 파일 형식

LoggerConfig.xml 은 XML 파일 형식에 대해 정의된 모든 규칙 및 구문 규칙을 따르는 XML 파일입니다.

기본 파일 구조는 다음과 같습니다.

<?xml version="1.0" encoding="UTF-8"?>
<config version="2">

  <destinations>
    ... specification of where logs can be sent
  </destinations>

  <programs>
    <program name="default">
      ... routing to destination with log level filtering
    </program>
    ... add more program elements here to override defaults
  </programs>

</config>

config

LoggerConfig.xml의 최상위 요소입니다.

특성

특성	값	설명
version	2	version 특성은 파일 형식의 향후 확장을 제공합니다. 현재로서는 2만 사용할 수 있습니다.

destinations

이 요소는 하나 이상의 destination 요소에 대한 컨테이너입니다.

요소	설명
netdestination	로컬 로그 서버로 로그 메시지를 네트워크를 통해 전달하도록 구성합니다.
filedestination	파일에 대한 로깅을 구성합니다.
stdoutdestination	콘솔 또는 파이프에 대한 출력을 구성합니다.

netdestination

이 요소는 네트워크 로그 대상을 정의합니다.

특성

특성	값	설명
name	문자열	program 요소에서 이 로그 대상을 참조하는 데 사용되는 기호입니다.

요소

요소	값	설명
hostname	문자열	로컬 로그 서버의 네트워크 주소입니다.
port	정수	로컬 로그 서버의 TCP 포트 번호입니다.
timeout	정수	제한 시간(초)입니다.
retrycount	정수	최대 로그 항목 쓰기 시도 횟수입니다.
retryperiod	정수	각 재시도 간의 지연(초)입니다.

참고

이 대상에서는 TCP/IP 네트워크 연결을 사용하여 로컬 로그 서버에 로그를 전달합니다.

filedestination

이 요소는 지정된 폴더에 로그 파일을 기록하는 로그 대상을 정의합니다.

특성

특성	값	설명
name	문자열	program 요소에서 이 로그 대상을 참조하는 데 사용되는 기호입니다.

요소

요소	값	설명
directory	문자열	로그 파일이 만들어지는 디렉터리입니다.
backups	정수	유지할 보관된 로그 파일의 수입니다.
rotatesize	정수	각 로그 파일의 최대 크기(바이트)입니다.
rotatetime	HHMM	크기에 관계없이 로그 파일이 보관되는 시간입니다. 예를 들어 `0100`은 로그 파일이 오전 1시에 보관된다는 것을 나타냅니다.

참고

rotatesize 또는 rotatetime 요소를 지정하여 로그 파일을 보관하기 위한 다양한 절차를 정의할 수 있습니다.

stdoutdestination

이 요소는 콘솔 또는 명령줄 프로세스 파이프에 대한 로그 출력을 정의합니다.

특성

특성	값	설명
name	문자열	program 요소에서 이 로그 대상을 참조하는 데 사용되는 기호입니다.

참고

이 대상에서는 표준 출력 스트림(stdout)에 메시지를 기록합니다.

programs

이 요소는 로그 원본의 목록을 지정합니다.

요소

요소	설명
program	로그 원본의 라우팅 및 필터링을 정의합니다.

program

이 요소는 로그 원본의 라우팅 및 필터링을 정의합니다.

특성

특성	값	설명
name	문자열	프로세스 이름입니다.

요소

요소	설명
output	지정된 로그 수준 임계값 필터를 사용하여 특정 대상에 대한 로그 메시지 라우팅을 정의합니다.

예

다음 예에서는 searchctrl-search라는 프로세스의 로그 메시지에 대한 라우팅 및 필터링을 정의합니다. 로그 수준이 INFO 이상으로 설정된 메시지만 server 대상으로 라우팅됩니다. 로그 수준이 VERBOSE 이상으로 설정된 메시지는 file 대상으로 전송됩니다. 로그 수준이 이보다 낮은 로그 메시지는 삭제됩니다.

<program name="searchctrl-search">
  <output destination="server" threshold="info"/>
  <output destination="file"   threshold="verbose"/>
</program>

output

지정된 로그 수준 임계값 필터를 사용하여 특정 대상에 대한 로그 메시지 라우팅을 정의합니다.

특성

특성	값	설명
destination	문자열	구성된 destination 요소를 참조하는 기호입니다.
threshold	CRITICAL\|ERROR\|WARNING\|INFO\|VERBOSE\|DEBUG	CRITICAL - CRITICAL 메시지만 라우팅합니다. ERROR - 로그 수준이 ERROR 이상인 메시지를 라우팅합니다. WARNING - WARNING 이상의 로그 수준을 사용하는 메시지를 라우팅합니다. INFO - INFO 이상의 로그 수준을 사용하는 메시지를 라우팅합니다. VERBOSE - VERBOSE 이상의 로그 수준을 사용하는 메시지를 라우팅합니다. DEBUG - 모든 로그 메시지를 라우팅합니다.

예

다음 예에서는 file이라는 대상으로 모든 메시지를 라우팅합니다.

<output destination="file" threshold="debug" />

다음을 통해 공유