searchinfo XML ステータス レポートの構文 (FAST Search Server 2010 for SharePoint)

適用先: FAST Search Server 2010

トピックの最終更新日: 2015-03-09

searchinfo ステータス コマンドは、Microsoft FAST Search Server 2010 for SharePoint のクエリ照合ステータスに関する XML 形式のレポートを取得します。この記事では、このレポートの構文について説明します。

このコマンドは、コマンドで要求されているサーバーごとにレポートを 1 つ返します。

要素のクイック リファレンス

このレポートでは以下の要素を使用します。

以下の要素には、主にデバッグのために使用される情報が含まれます。

<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 ステータスの 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 プロセスのインスタンスが 1 つ存在し、個々のクエリ照合サーバーへのクエリのディスパッチを行います。

それぞれのクエリ照合サーバーには fdispatch プロセスのインスタンスが 1 つ存在し、そのクエリ照合サーバー上にある個々のクエリ照合パーティションへのクエリのディスパッチを行います。

search 型の engine 要素は、さまざまなインデックス パーティションでのクエリ照合を管理する、基になる fsearch プロセスを表します。複数のインデックス列または検索行が存在する複数サーバー展開では、最上位レベルの fdispatch も dispatch 型として表示されますが、それはこのプロセスもまた基になるクエリ照合サーバーに対するディスパッチャーだからです。

hostname

この要素は、このコンポーネントを実行するサーバーのホスト名を示します。

属性

解説

最上位レベルのディスパッチャー (クエリ処理サーバー上にあるもの) では、ホスト名が実際のホスト名ではなく "localhost" と表示される場合があります。これが最上位レベルのクエリ ディスパッチャーであることは、engine サブ要素の type が dispatch という値であるかを調べることによって確認できます。

searchhandler

この要素は、受け取った検索クエリを処理する検索ハンドラーに関する情報を示します。

属性

dataset

この要素には、ディスパッチャーによって送信されたクエリに関連した、各クエリ照合コンポーネントに関する情報が含まれます。

属性

解説

それぞれのインデックス列内では、インデックス作成とクエリ処理の遅延を抑えながら多数のインデックス作成済みアイテムを処理するために、インデックスの動的なパーティション設定がインデクサーで使用されます。このパーティション設定は動的なものであり、各インデクサーで内部的に処理されます。

engine

この要素は、基になるクエリ照合エンジンのうちこの fdispatch プロセスから見えるものに関する情報を示します。

これがクエリ処理サーバー上の fdispatch プロセスである場合は、それぞれの engine 要素がこのサーバー上の 1 つのインデックス パーティションに関連付けられている fsearch プロセスを表します。

これがクエリ処理サーバー上の fdispatch プロセスである場合は、それぞれの engine 要素がクエリ処理サーバー上の fdispatch プロセスを表します。

属性

解説

クエリ数 (samples) の非常に少ない新しく作成されたインデックスでは、avg-search-time の値 (クエリの評価時間) が大きくなる可能性があります。これは、クエリ キャッシュの最初の作成に関連しています。

fsearch

この要素には、クエリ照合を行う fsearch プロセスに関連する統計情報とリソース使用率の情報が含まれます。

fsearch プロセスは、あるインデックス列内のインデックス パーティションごとに 1 つ存在します。

属性

search-statistics

この要素は、クエリ照合の統計に関する情報を示します。

属性

attributevectors

この要素には、詳細なクエリ絞り込みと並べ替えのメモリ構造に関連する情報が含まれます。

属性

解説

並べ替えの場合は、プレフィックス "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 出力のサブセットを示しています。ここに示されているステータス情報は、このサーバー上のクエリ ディスパッチャー コンポーネントに関連するものです。この展開には、3 つのインデックス列と 1 つの検索行が存在します。それぞれのクエリ照合サーバーは、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>

例 3

例 3 は、engine 要素として表された、クエリ照合サーバーのクエリ ディスパッチャー ビューを示しています。発行されたクエリは 1 つだけであり (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 リファレンス