logserverconfig.xml 참조
적용 대상: FAST Search Server 2010
마지막으로 수정된 항목: 2015-03-09
logserverconfig.xml을 사용하여 Microsoft FAST Search Server 2010 for SharePoint 구성 요소에서 전송된 로그 메시지에 대한 라우팅과 필터링을 구성할 수 있습니다. 로깅 프로세스는 세 단계로 이루어지며 첫 번째 단계는 loggerconfig.xml에서 구성합니다. logserverconfig.xml 에는 나머지 두 단계에 해당하는 로컬 로그 서버와 주 로그 서버에 대한 구성이 포함됩니다.
모든 FAST Search Server 2010 for SharePoint 노드에는 로컬 로그 서버가 있습니다. 로컬 로그 서버에서는 로컬로 로깅을 수행하며, 관리 노드에서만 실행되는 주(팜) 로그 서버로 로그 메시지를 전달합니다.
두 로그 서버의 하위 시스템은 모두 FAST Search Server 2010 for SharePoint 모니터링 서비스 내에서 실행됩니다. logserverconfig.xml은 모니터링 서비스가 시작될 때 로드됩니다. 이 파일은 <FASTSearchFolder>\etc\ 폴더에 있어야 합니다. 여기서 *<FASTSearchFolder>*는 FAST Search Server 2010 for SharePoint를 설치한 폴더의 경로(예: C:\FASTSearch)입니다.
대상 목록을 사용하여 들어오는 메시지를 보낼 로깅 대상을 설정합니다. 이 프로그램 목록은 개별 로그 원본에 대한 로그 수준 필터링을 구성합니다. 각 로그 서버에 대해 기본 프로그램 항목(name = default)이 정의되어 있습니다. 들어오는 로그 메시지가 정의된 프로그램 중 어떤 것과도 일치하지 않으면 대신 기본 프로그램 항목이 사용됩니다.
설치된 logserverconfig.xml 버전을 편집하여 기존 값을 조정하고 프로그램 요소를 추가하여 특정 로그 원본에 대한 필터링과 라우팅을 재정의할 수 있지만 대부분의 경우에는 기본값이 적절합니다.
logserverconfig.xml 사용자 지정
참고
구성 파일을 수정하려면 FAST Search Server 2010 for SharePoint이 설치된 컴퓨터에서 FASTSearchAdministrators 로컬 그룹의 구성원이어야 하는 최소 요구 사항을 만족하는지 확인합니다.
텍스트 편집기나 XML 편집기를 사용하여 이 파일을 변경할 수 있습니다. 편집한 내용은 FAST Search Server 2010 for SharePoint 모니터링 서비스(FASTSearchMonitoring)를 다시 시작하기 전까지는 적용되지 않습니다.
요소 빠른 참조
logserverconfig.xml 의 요소는 다음과 같습니다.
| 요소 | 설명 |
|---|---|
<logserverconfig 요소> |
최상위 요소 |
<locallogserverconfig 요소> |
로컬 로그 서버의 구성 |
<mainlogserverconfig 요소> |
주 로그 서버의 구성 |
<flood_protect 요소> |
과도한 로깅을 차단하는 필터 |
<destinations 요소> |
로그 대상 목록:
|
<programs 요소> |
로그 원본 목록:
|
logserverconfig.xml 파일 형식
logserverconfig.xml 은 XML 파일 형식에 대해 정의된 모든 규칙 및 구문 규칙을 따르는 XML 파일입니다.
기본 파일 구조는 다음과 같습니다.
<?xml version="1.0" encoding="UTF-8"?>
<logserverconfig version="1.0">
<locallogserverconfig>
<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>
</locallogserverconfig>
<mainlogserverconfig>
.. same basic structure as for locallogserverconfig
</mainlogserverconfig>
</logserverconfig>
logserverconfig 요소
이 요소는 logserverconfig.xml의 최상위 요소입니다.
특성
| 특성 | 값 | 설명 |
|---|---|---|
version |
1.0 |
version 특성은 파일 형식의 향후 확장을 제공합니다. 현재로서는 1.0만 사용할 수 있습니다. |
locallogserverconfig 요소
이 요소는 로컬 로그 서버의 구성을 포함합니다.
mainlogserverconfig 요소
이 요소는 주(팜) 로그 서버의 구성을 포함합니다.
flood_protect 요소
넘침이 감지되는 경우 로그 메시지를 차단하는 필터입니다.
다음과 같은 세 가지 기간을 사용할 수 있습니다.
| 기간 | 설명 |
|---|---|
Measure |
단일 측정 기간 동안 로그 메시지의 수가 max_count를 초과하면 차단이 설정됩니다. |
Block |
차단이 설정되어 있으면 현재 차단 기간이 끝날 때까지 로그 메시지가 필터링됩니다. |
Trickle |
차단이 설정되어 있는 경우에도 각 지속적인 공급 기간 동안 단일 로그 메시지는 통과될 수 있습니다. |
로그 메시지는 로그 원본과 로그 수준 모두를 기반으로 필터링됩니다. 예를 들어 현재 INFO 메시지가 차단되더라도 ERROR 메시지는 이로 인해 영향을 받지 않습니다.
특성
| 특성 | 값 | 설명 |
|---|---|---|
max_count |
값 |
단일 측정 기간 동안 허용되는 로그 메시지 수입니다. |
measure_minutes |
값 |
측정 기간의 길이(분)입니다. |
block_minutes |
값 |
차단 기간의 길이(분)입니다. |
trickle_minutes |
값 |
지속적인 공급 기간의 길이(분)입니다. |
Measure_minutes, block_minutes 및 trickle_minutes는 개별적으로 구성할 수 있지만 가장 작은 값의 배수(정수)로 값을 설정했을 때 가장 논리적인 결과를 얻을 수 있습니다.
Block_minutes는 일반적으로 measure_minutes보다 크거나 같은 값으로 설정합니다. 지속적인 공급 기능을 해제하려면 trickle_minutes를 block_minutes와 같은 값으로 설정합니다.
예
다음 예에서는 각각 5분의 측정 기간 동안 최대 1,000개의 메시지가 허용됩니다. 이 임계값을 초과하면 현재 180분의 차단 기간 중 남은 기간 동안에 로그 메시지가 차단됩니다. 그러나 30분마다 1개의 로그 메시지는 통과하도록 허용됩니다(지속적인 공급 기간).
<flood_protect max_count = "1000"
measure_minutes = "5"
block_minutes = "180"
trickle_minutes = "30" />
destinations 요소
이 요소는 하나 이상의 destination 요소를 포함하는 컨테이너입니다.
sharepointulslog 요소
이 요소는 로컬 로그 서버에 사용할 SharePoint ULS(통합 로깅 서비스) 로그 대상을 정의합니다. 이 요소에 flood_protect 요소를 하나 포함하여 넘침이 감지되는 경우 로그 메시지를 차단하는 선택적 필터를 정의할 수 있습니다.
특성
| 특성 | 값 | 설명 |
|---|---|---|
name |
문자열 |
program 요소에서 이 로그 대상을 참조하는 데 사용되는 기호입니다. |
이 대상은 SharePoint ULS(통합 로깅 서비스)의 추적 로그 기능을 사용합니다.
mainlogserver 요소
이 요소는 로컬 로그 서버에서 주(팜) 로그 서버로 로그를 전달하는 로그 대상을 정의합니다. 이 요소에 flood_protect 요소를 하나 포함하여 넘침이 감지되는 경우 로그 메시지를 차단하는 선택적 필터를 정의할 수 있습니다.
특성
| 특성 | 값 | 설명 |
|---|---|---|
name |
문자열 |
program 요소에서 이 로그 대상을 참조하는 데 사용되는 기호입니다. |
로그 메시지 전달에는 WCF 프로토콜이 사용됩니다. bin\MonitoringService.exe.config .NET 파일을 편집하여 WCF 서비스 매개 변수, 바인딩 및 동작을 구성할 수 있습니다.
localeventlog 요소
이 요소는 로컬 로그 서버에 사용되는 NT 이벤트 로그 대상을 정의합니다. 이 요소에 flood_protect 요소를 하나 포함하여 넘침이 감지되는 경우 로그 메시지를 차단하는 선택적 필터를 정의할 수 있습니다.
특성
| 특성 | 값 | 설명 |
|---|---|---|
name |
문자열 |
program 요소에서 이 로그 대상을 참조하는 데 사용되는 기호입니다. |
farmeventlog 요소
이 요소는 주(팜) 로그 서버에 사용할 NT 이벤트 로그 대상을 정의합니다. 이 요소에 flood_protect 요소를 하나 포함하여 넘침이 감지되는 경우 로그 메시지를 차단하는 선택적 필터를 정의할 수 있습니다.
특성
| 특성 | 값 | 설명 |
|---|---|---|
name |
문자열 |
program 요소에서 이 로그 대상을 참조하는 데 사용되는 기호입니다. |
filedestination 요소
이 요소는 주(팜) 로그 서버에 사용할 텍스트 파일 로그 대상을 정의합니다. 이 요소에 flood_protect 요소를 하나 포함하여 넘침이 감지되는 경우 로그 메시지를 차단하는 선택적 필터를 정의할 수 있습니다.
특성
| 특성 | 값 | 설명 |
|---|---|---|
name |
문자열 |
program 요소에서 이 로그 대상을 참조하는 데 사용되는 기호입니다. |
이 대상은 <FASTSearchFolder>\var\log\syslog\ 디렉터리의 파일에 메시지를 기록합니다.
programs 요소
이 요소는 하나 이상의 program 요소를 포함하는 컨테이너이며 로그 원본 목록을 포함합니다.
program 요소
로그 원본에 대한 라우팅과 필터링을 정의합니다. 이 요소에 output 요소를 하나 이상 포함하여 지정한 로그 수준 임계값 필터를 사용해 특정 대상으로의 로그 메시지 라우팅을 정의할 수 있습니다.
특성
특성 |
값 |
설명 |
name |
문자열 |
로깅 원본에 사용되는 식별자와 일치하는 로그 모듈 이름입니다. 주 로그 서버에서 <FASTSearchFolder>\var\log\syslog\all.log 를 검토하여 식별자를 검색합니다. 예: indexer |
로컬 로그 서버의 경우 mainlogserver 대상으로의 라우팅이 암시적입니다. 이 메시지 전달은 해제할 수 없습니다.
예
다음은 모듈 인덱서에서 전송된 로그 메시지에 대한 라우팅과 필터링을 정의하는 예입니다. 로그 수준이 CRITICAL인 메시지만 eventlog 및 ulslog 대상으로 라우팅됩니다. 로그 수준이 이보다 낮은 로그 메시지는 삭제됩니다.
<program name="indexer">
<output destination="eventlog" threshold="critical" />
<output destination="ulslog" threshold="critical" />
</program>
output 요소
지정한 로그 수준 임계값 필터를 사용하여 특정 대상으로의 로그 메시지 라우팅을 정의합니다.
| 특성 | 값 | 설명 |
|---|---|---|
destination |
문자열 |
구성된 destination 요소를 참조하는 기호입니다. |
threshold |
CRITICAL|ERROR|WARNING|INFO|VERBOSE|DEBUG |
|
예
다음 예에서는 모든 메시지가 file이라는 대상으로 라우팅됩니다.
<output destination="file" threshold="debug" />