searchinfo XML 상태 보고서 구문(FAST Search Server 2010 for SharePoint)
적용 대상: FAST Search Server 2010
마지막으로 수정된 항목: 2015-03-09
searchinfo 상태 명령은 Microsoft FAST Search Server 2010 for SharePoint 쿼리 일치 상태에 대한 XML 형식 보고서를 검색합니다. 이 문서에서는 이 보고서의 구문에 대해 설명합니다.
이 명령은 명령에서 요청된 각 서버에 대해 보고서를 하나씩 반환합니다.
요소 빠른 참조
보고서에 사용되는 요소는 다음과 같습니다.
| 요소 | 설명 |
|---|---|
<search-stats> |
이 요소는 최상위 요소입니다. |
<error> |
이 요소는 쿼리 일치 구성 요소와 관련된 오류 조건을 설명합니다. |
<fdispatch> |
이 요소는 쿼리 일치 구성 요소로의 쿼리 발송을 담당하는 fdispatch 프로세스와 관련된 정보를 표시합니다. |
<hostname> |
이 요소는 이 구성 요소를 실행하는 서버의 호스트 이름을 표시합니다. |
<searchhandler> |
이 요소는 들어오는 검색 쿼리를 처리하는 인스턴스인 검색 처리기에 대한 정보를 표시합니다. |
<datasets> |
이 요소는 단일 dataset 하위 요소를 포함합니다. |
<dataset> |
이 요소는 발송자가 전송한 쿼리와 관련된, 각 쿼리 일치 구성 요소(엔진)에 대한 정보를 표시합니다. |
<engine> |
이 요소는 한 인덱스 파티션과 관련된 fsearch 프로세스에 대한 정보를 표시합니다. |
<fsearch> |
이 요소는 쿼리 일치를 담당하는 fsearch 프로세스와 관련된 정보를 표시합니다. |
<search-statistics> |
이 요소는 쿼리 일치 통계에 대한 정보를 표시합니다. |
<attributevectors> |
이 요소는 상세한 쿼리 구체화 및 정렬을 위한 메모리 구조와 관련된 정보를 표시합니다. |
다음 요소는 주로 디버깅에 사용되는 정보를 포함합니다.
<version>, <filedesc-resource>, <httpdconn>, <file-statistics>, <transportd>, <result-cache>, <resultattr-cache>, <docinfo-cache>, <boolean-occ-cache>, <pos-occ-cache>, <phrase-occidx-cache>, <phrase-occ-cache2>, <bitvector-cache>, <int-range-bitvector-cache>, <int-occ-cache>, <filter-occ-cache>, <dict-cache>, <subquery-cache>, <attributevector>
searchinfo status XML 형식
상태 출력은 XML 파일 형식에 대해 정의되어 있는 모든 규칙과 구문 규칙을 따릅니다.
기본 XML 구조는 다음과 같습니다.
<search-stats>
<error />
<fdispatch>
<error />
<version />
<hostname />
<searchhandler />
<datasets>
<dataset>
<engine />
</dataset>
</datasets>
<filedesc-resource />
</fdispatch>
<fsearch>
<version />
<search-statistics />
<httpdconn />
<file-statistics />
<transportd />
<result-cache />
<resultattr-cache />
<docinfo-cache />
<boolean-occ-cache />
<pos-occ-cache />
<phrase-occidx-cache />
<phrase-occ-cache2 />
<bitvector-cache />
<int-range-bitvector-cache />
<int-occ-cache />
<filter-occ-cache />
<dict-cache />
<subquery-cache />
<attributevectors >
<attributevector />
</attributevectors>
<filedesc-resource />
</fsearch>
</search-stats>
fdispatch
이 요소는 쿼리 일치 구성 요소로의 쿼리 발송을 담당하는 fdispatch 프로세스와 관련된 정보를 표시합니다.
쿼리 처리 서버에는 개별 쿼리 일치 서버로 쿼리를 발송하는 fdispatch 프로세스의 인스턴스가 하나 있습니다.
각 쿼리 일치 서버에는 쿼리 일치 서버의 개별 쿼리 일치 파티션으로 쿼리를 발송하는 fdispatch 프로세스의 인스턴스가 하나 있습니다.
참고
다중 서버 배포에서는 일반적으로 쿼리 처리 서버와 쿼리 일치 서버가 서로 다른 컴퓨터에서 실행됩니다.
search 형식의 engine 요소는 여러 인덱스 파티션의 쿼리 일치를 관리하는 기본 fsearch 프로세스를 나타냅니다. 인덱스 열이나 검색 행이 둘 이상인 다중 서버 배포에서는 최상위 fdispatch 요소도 dispatch 형식으로 나열되는데 이는 이 요소가 기본 쿼리 일치 서버에 대한 발송자이기 때문입니다.
hostname
이 요소는 이 구성 요소를 실행하는 서버의 호스트 이름을 표시합니다.
특성
| 특성 | 설명 |
|---|---|
name |
이 구성 요소를 실행하는 서버의 호스트 이름입니다. 배포의 서버 역할에 대한 자세한 내용은 deployment.xml 구성 파일을 참조하십시오. |
참고
쿼리 처리 서버의 최상위 쿼리 발송자의 경우 호스트 이름이 실제 호스트 이름 대신 "localhost"로 표시될 수 있습니다. engine 하위 요소의 type 값이 dispatch인지 확인하여 이 요소가 최상위 쿼리 발송자인지 확인할 수 있습니다.
searchhandler
이 요소는 들어오는 검색 쿼리를 처리하는 검색 처리기에 대한 정보를 표시합니다.
특성
| 특성 | 설명 |
|---|---|
instantiate-count |
검색 처리기 스레드의 총 수를 표시합니다. |
active-count |
현재 평가 중인 쿼리 수를 표시합니다. |
dataset
이 요소는 발송자가 전송한 쿼리와 관련된, 각 쿼리 일치 구성 요소에 대한 정보를 포함합니다.
특성
| 특성 | 설명 |
|---|---|
active-nodes |
활성 쿼리 일치(fsearch) 프로세스의 수를 표시합니다. |
total-search-time |
쿼리 일치에 사용된 총 시간을 표시합니다. |
up-time |
이 구성 요소를 마지막으로 다시 시작한 이후 구성 요소가 실행된 총 시간을 표시합니다. |
avg-seconds-per-search |
쿼리 평가당 사용된 평균 시간(초)을 표시합니다. |
partitions |
이 쿼리 발송자에 표시되는 인덱스 파티션의 수를 표시합니다. 최상위 발송자의 경우 이 숫자는 인덱스 열의 수를 반영합니다. |
timed-out-percentage |
시간 초과된 쿼리의 백분율을 표시합니다. |
max-active-partitions |
만들어진 활성 인덱스 파티션의 최대 수를 표시합니다. |
avg-searches-per-sec |
초당 평균 쿼리 수를 표시합니다. |
first-partition |
첫 번째 인덱스 파티션 번호를 표시합니다. |
samples |
avg-searches-per-sec 값을 계산하는 데 사용된 쿼리 수를 표시합니다. |
id |
이 특성은 주로 디버깅에 사용되는 정보를 포함합니다. |
unit-selection-cost |
이 특성은 주로 디버깅에 사용되는 정보를 포함합니다. |
timed-out |
쿼리 시간 초과 발생 횟수를 표시합니다. |
total-searches |
마지막 인덱스 집합 변경 이후의 총 쿼리 수를 표시합니다. |
max-active-nodes |
이 특성은 주로 디버깅에 사용되는 정보를 포함합니다. |
total-selection-cost |
이 특성은 주로 디버깅에 사용되는 정보를 포함합니다. |
active-partitions |
활성 인덱스 파티션의 총 수를 표시합니다. |
avg-uncached-search-time |
쿼리 캐시를 사용하지 않는 경우 쿼리당 평균 시간(초)을 표시합니다. |
참고
인덱서는 낮은 인덱싱 및 쿼리 대기 시간으로 다수의 인덱싱된 항목을 처리할 수 있도록 각 인덱스 열 내에서 인덱스 동적 분할을 사용합니다. 이 분할 작업은 동적으로 이루어지며 각 인덱서에서 내부적으로 처리됩니다.
engine
이 요소는 이 fdispatch 프로세스에 표시되는 기본 쿼리 일치 엔진에 대한 정보를 표시합니다.
이 프로세스가 쿼리 일치 서버의 fdispatch 프로세스인 경우 각 engine 요소는 이 서버에 있는 한 인덱스 파티션과 관련된 fsearch 프로세스를 나타냅니다.
이 프로세스가 쿼리 처리 서버의 fdispatch 프로세스인 경우 각 engine 요소는 쿼리 일치 서버의 fdispatch 프로세스를 나타냅니다.
특성
| 특성 | 설명 |
|---|---|
socket |
인덱스 파티션에 연결된 쿼리 일치 구성 요소의 연결 ID를 표시합니다. ID는 다음 형식을 사용하여 지정합니다. <호스트 이름>:<포트> |
samples |
실행된 쿼리 수를 표시합니다. |
avg-search-time |
쿼리당 평균 시간(초)을 표시합니다. 참고 samples 값이 0인 경우에는 이 특성이 반환되지 않습니다. |
partition |
인덱스 파티션 ID를 표시합니다. |
type |
이 engine 요소의 형식을 표시합니다.
|
state |
이 엔진 요소와 관련된 fsearch 또는 fdispatch 프로세스의 상태를 표시합니다.
|
docstamp |
인덱스 파일이 만들어진 날짜/시간(1970년 1월 1일 이후 경과된 시간(초)으로 측정됨)을 표시합니다. |
row |
관련 검색 행을 표시합니다. |
refcost |
이 특성은 주로 디버깅에 사용되는 정보를 포함합니다. |
active |
인덱스 파티션에 연결된 인덱스의 검색 가능한 항목 수를 표시합니다. |
주의
쿼리 수(samples)가 매우 낮은 새로 생성된 인덱스의 경우 avg-search-time 값(쿼리를 평가하는 데 걸리는 시간)이 높을 수 있습니다. 이는 쿼리 캐시의 초기 생성과 관련됩니다.
fsearch
이 요소는 쿼리 일치를 담당하는 fsearch 프로세스와 관련된 통계 및 리소스 사용량 정보를 포함합니다.
fsearch 프로세스는 인덱스 열의 각 인덱스 파티션에 대해 하나씩 있습니다.
특성
| 특성 | 설명 |
|---|---|
name |
"localhost:<포트 번호>"로 지정되며 여기서 <포트 번호>는 fsearch 프로세스의 포트 번호입니다. 관련 파티션 번호는 socket 특성과 동일한 값을 가진 fdispatch/engine 엔진에서 확인할 수 있습니다. |
search-statistics
이 요소는 쿼리 일치 통계에 대한 정보를 표시합니다.
특성
| 특성 | 설명 |
|---|---|
up-time |
이 프로세스가 시작되거나 다시 시작된 이후 경과한 시간(초)을 표시합니다. |
total-search-time |
쿼리 일치에 사용된 총 시간(초)을 표시합니다. |
total-searches |
처리된 쿼리 수를 표시합니다. |
avg-searches-per-second |
초당 평균 쿼리 수를 표시합니다. |
avg-search-time |
쿼리당 평균 시간(초)을 표시합니다. |
attributevectors
이 요소는 상세한 쿼리 구체화 및 정렬을 위한 메모리 구조와 관련된 정보를 포함합니다.
특성
| 특성 | 설명 |
|---|---|
total-memory-usage |
이 인덱스 파티션에 대한 데이터 구조 정렬 및 상세한 쿼리 구체화에 할당된 총 메모리의 양입니다. |
주의
정렬 특성 벡터의 이름은 "batv"라는 접두사로 시작하고 상세한 쿼리 구체화 특성 벡터의 이름은 "bavn"이라는 접두사로 시작합니다.
예
다음은 searchinfo -a status 명령을 실행하는 경우 반환되는 XML 출력의 일부를 보여 주는 예입니다.
예 1
예 1에서는 인덱스 열 0 및 검색 행 0과 관련된 쿼리 일치 서버에 대한 XML 출력의 일부를 보여 줍니다.
<search-stats>
<fdispatch>
<version value="fs14.301"/>
<hostname name="host1.site1.contoso.com"/>
<searchhandler active-count="0" instantiate-count="0"/>
<datasets>
<dataset id="0" partitions="5" first-partition="0" max-active-nodes="5"
active-nodes="5" max-active-partitions="5" active-partitions="5"
unit-selection-cost="1" total-selection-cost="0"
up-time="168163.798" total-search-time="0.000" total-searches="0"
avg-searches-per-sec="0.000" samples="0" timed-out="0">
<engine socket="localhost:13056" state="up" type="search" partition="0"
row="0" refcost="1" docstamp="1286267246" samples="0"/>
...
<engine socket="localhost:13096" state="up" type="search" partition="4"
row="0" refcost="1" docstamp="1286254268" samples="0"/>
</dataset>
</datasets>
<filedesc-resource wait-queue-len="0" resource-usage="18"
total-resource-count="1014"/>
</fdispatch>
<fsearch name="localhost:13056">
<version value="fs14.9999"/>
<search-statistics total-search-time="0.000" total-searches="0"
up-time="0.000"/>
...
<attributevectors total-memory-usage="48">
<attributevector name="batvprocessingtime" type="int64" multi-value="no"
elements="0" memory-bytes="0"
basefile="D:\FASTSearch\data\data_index\0\index_1286267244861467000\index_data\merged\batvprocessingtime"
status="OK" custom="format=enum"/>
...
</attributevectors>
...
</fsearch>
<fsearch name="localhost:13096">
<version value="fs14.9999"/>
<search-statistics total-search-time="0.000" total-searches="0"
up-time="0.000"/>
...
<attributevectors total-memory-usage="1077786037">
<attributevector name="batvprocessingtime" type="int64" multi-value="no"
elements="5999523" memory-bytes="25799404"
basefile="D:\FASTSearch\data\data_index\4\index_1286242512297821000\index_data\merged\batvprocessingtime"
status="OK" custom="format=enum"/>
...
</attributevectors>
...
</fsearch>
...
</search-stats>
이 XML 출력은 인덱스 파티션 0과 4에 대한 데이터를 보여 줍니다. 인덱스 파티션 0은 최근에 업데이트된 항목을 보유하고 있는 파티션입니다.
예 2
예 2에서는 쿼리 처리 서버에 대한 XML 출력의 일부를 보여 줍니다. 표시되는 상태 정보는 이 서버의 쿼리 발송자 구성 요소와 관련된 정보입니다. 이 배포에는 세 개의 인덱스 열과 한 개의 검색 행이 있습니다. 각 쿼리 일치 서버는 XML에서 하나의 engine 항목으로 나타납니다.
<search-stats>
<fdispatch>
<version value="fs14.301"/>
<hostname name="localhost"/>
<searchhandler active-count="0" instantiate-count="0"/>
<datasets>
<dataset id="0" partitions="3" first-partition="0" max-active-nodes="15"
active-nodes="15" max-active-partitions="15"
active-partitions="15" unit-selection-cost="1"
total-selection-cost="0" up-time="169002.845"
total-search-time="0.000" total-searches="0"
avg-searches-per-sec="0.000" samples="0" timed-out="0">
<engine socket="host1.site1.contoso.com:13052" state="up"
type="dispatch" partition="0" row="0" refcost="11"
docstamp="1287410432" samples="0"/>
<engine socket="host2.site1.contoso.com:13052" state="up"
type="dispatch" partition="1" row="0" refcost="11"
docstamp="1287410430" samples="0"/>
<engine socket="host3.site1.contoso.com:13052" state="up"
type="dispatch" partition="2" row="0" refcost="11"
docstamp="1287410432" samples="0"/>
</dataset>
</datasets>
...
</fdispatch>
...
</search-stats>
참고
partitions는 이 쿼리 발송자에 표시되는 인덱스 열의 수를 나타냅니다. active-partitions는 총 활성 인덱스 파티션 수를 나타냅니다. 이 예에서는 세 개의 인덱스 열에 다섯 개의 활성 파티션이 있습니다.
예 3
예 3에서는 engine 요소로 나타나는 한 쿼리 일치 서버의 쿼리 발송자 보기를 보여 줍니다. 쿼리는 하나만 실행되었으며(samples=1) 비어 있는 쿼리 캐시로 인해 평균 쿼리 평가 시간이 높습니다.
<engine socket=" host21.site1.contoso.com:13052"
state="up" type="dispatch" partition="9" row="1" refcost="11"
docstamp="1276035428" avg-search-time="1.919" samples="1"/>
See Also
Reference
searchinfo.exe 참조(FAST Search Server 2010 for SharePoint)
Concepts
FAST Search Server 팜 토폴로지 계획(FAST Search Server 2010 for SharePoint)
중복 및 가용성 계획(FAST Search Server 2010 for SharePoint)
deployment.xml 참조