ログ解析機能を使用するには，ログファイルの出力先フォルダを指定する必要があります。ログファイルは次の形式で出力されます。

• ログファイル名：yyyymmdd.log
• ファイル形式：CSV
• 出力単位：Bibliotheca21をインストールしたマシンごとに一日1ファイル

ログファイルを出力するフォルダは，Web構成ファイル（Bib21ASPX.Config）でパラメタを指定して設定します。ログ解析機能のパラメタ名，Web構成ファイルの設定方法，定義例については「5.7.1　定義ファイルにパラメタを設定する」を参照してください。なお，存在しないフォルダを指定した場合，ログは出力されません。

注意

• ログは検索の実行，文書の参照がされるたびに，その日付のログファイルに書き込まれます。検索の実行，文書の参照がなかった日は，その日付のログファイルは作成されません。
• Bibliotheca21 StandardとBibliotheca21 Searching+で複数サーバによるBibliotheca21システムを構築している場合でも，共有ディスクなどを使用してログファイルの出力先を一つのファイルにまとめることはできません。Bibliotheca21をインストールしたマシンごとに，1ファイルを出力する設定にしてください。
• 1日ごとのログファイルのサイズは，次の計算式で算出できます。
  ファイルサイズ［バイト］ = 100^※1×検索ユーザ数×1ユーザが1日に行う検索数+ 160^※2×検索ユーザ数×1ユーザが1日に行う文書参照数
  注※1：一回の検索の検索条件により増減します。
  注※2：一文書のタイトルと実体パスにより増減します。
  

ログファイルに出力される内容について説明します。検索条件・参照文書のログは，ログファイルに1行ずつ出力されます。

検索条件のログファイルの出力内容を次の表に示します。

表5-8　ログファイルの出力内容（検索条件）

参照文書のログファイルの出力内容を次の表に示します。

表5-9　ログファイルの出力内容（参照文書）

ログファイルの出力例を次に示します。

 
［SRCH］,2008/07/08 14:59:15.437,2008/07/08 14:59:15.671,"日立　Bibliotheca21",hit:3077,Administrator
［VIEW］,2008/07/08 15:01:15.211,Bibliotheca21の最新動向, http://localhost/sample/bib.html,Administrator

注意

参照文書のログは，「検索結果一覧」画面に表示された文書のタイトルリンクをクリックしたタイミングで取得されます。ただし，文書の表示に失敗した場合，および画面を表示したあとにブラウザの［戻る］ボタン，または［進む］ボタンを使用して表示された文書は，ログ取得の対象となりません。

なお，ASP.NET版検索テンプレートのカスタマイズで，検索リンクの別ウィンドウ表示を設定している場合は，ブラウザの［戻る］ボタン，または［進む］ボタンを使用して表示された文書はログ取得の対象になります。

ログ解析機能を使用するには，検索条件・参照文書のログファイルからログ解析結果情報ファイルを作成する必要があります。ここでは，BIBanalyzeSrchLogコマンドを使用したログ解析結果情報ファイルの作成について説明します。

なお，ログ解析結果情報ファイルはBibliotheca21が指定したフォーマットでユーザが作成することもできます。ユーザが作成する場合のフォーマットについては，「(4)　ログ解析結果情報ファイルのフォーマット」を参照してください。また，BIBanalyzeSrchLogコマンドが出力するメッセージについては，「10.6　ログ解析コマンド（BIBanalyzeSrchLogコマンド）に関するメッセージ」を参照してください。

BIBanalyzeSrchLogコマンドの文法を説明します。

(a)　機能

検索条件・参照文書のログファイルを解析し，ASP.NET版検索テンプレートに読み込むログ解析結果情報ファイルをCSV形式で出力します。

Bibliotheca21は標準解析メニューとして，次の二つを提供しています。

• よく検索されるキーワードランキング
• よく参照される文書ランキング

(b)　形式

BIBanalyzeSrchLog -f ログ解析結果情報ファイルパス

(c)　オプション

-f　ログ解析結果情報ファイルパス

ログの解析結果が記述されたログ解析結果情報ファイルの場所を，絶対パスの形式で指定します。

(d)　ログ解析結果情報ファイルの形式

ログ解析結果情報ファイルの形式を次に示します。

 
［セクション］
エントリ＝データ
　　:
［セクション］
　　:

ログ解析結果情報ファイルの設定値を次の表に示します。

表5-10　ログ解析結果情報ファイルの設定値

注※1

• TotalBaseとTotalPeriod，TotalStartDateとTotalEndDateは，それぞれがペアで指定する設定です。TotalBaseとTotalEndDate，TotalStartDateとTotalPeriodなどの異なるペアでの指定はできません。
• TotalBaseとTotalPeriodに値が指定された場合，TotalStartDateとTotalEndDateに指定した値は無視されます。TotalStartDateとTotalEndDateに値を指定する場合は，TotalBaseとTotalPeriodに値は指定しないでください。
  なお，TotalBaseとTotalPeriod，TotalStartDateとTotalEndDateのすべてのエントリに値の指定がない場合，TotalBaseとTotalPeriodのデフォルトの値が設定されます。
  
• TotalBaseとTotalPeriod，またはTotalStartDateとTotalEndDateに値を指定する場合は，それぞれのペア同士で両方のエントリに値を指定してください。どちらか一方だけのエントリに値を指定した場合，指定のないエントリはデフォルト値と判断されるため，集計期間が設定したい期間と異なるおそれがあります。
  10月1日にBIBanalyzeSrchLogコマンドを実行する場合のTotalBaseとTotalPeriod指定例を，次の表に示します。
  

  表5-11　TotalBaseとTotalPeriodの指定例

  No.	エントリ名	指定値	ランキング集計期間
  1	TotalBase	0	9月1日0時〜10月1日23時59分59秒 コマンド実行日を基点として過去31日分を集計します。
  	TotalPeriod	31
  2	TotalBase	−	8月31日0時〜9月30日23時59分59秒 コマンド実行日の前日を基点として過去31日分を集計します。
  	TotalPeriod	31
  3	TotalBase	7	9月11日0時〜9月24日23時59分59秒 コマンド実行日の7日前を基点として過去14日分を集計します。
  	TotalPeriod	14
  4	TotalBase	7	8月25日0〜9月24日23時59分59秒 コマンド実行日の7日前を基点として過去31日分を集計します。
  	TotalPeriod	−

  （凡例）　−：値を設定しないことを示します。
  

注※2

• 解析結果のCSVファイルの出力フォーマットについては，「(4)　ログ解析結果情報ファイルのフォーマット」を参照してください。

注※3

• KeywordRankingセクションに値が設定されていない場合，解析結果のCSVファイルに検索条件のランキングデータは出力されません。

注※4

• AccessRankingセクションに値が設定されていない場合，解析結果のCSVファイルに参照文書のランキングデータは出力されません。

注※5

同率の順位の検索条件，または参照文書が存在した場合でも，Rankに指定した数を超える分は出力されません。例えば，Rankに5を指定した場合で「日立」，「Bibliotheca21」が同率の2位のとき，4位までの順位が表示されます。

注意

ログ解析機能は出力された検索条件・参照文書のログファイルを集計して，ログ解析結果情報ファイルを作成します。このため，ログファイルの一部を移動，または削除すると，エントリ値で指定した集計日数と異なる日数で解析されるおそれがあります。ログファイルの格納場所は，Web構成ファイル（Bib21ASPX.Config）でパラメタを指定して変更してください。

(e)　戻り値

戻り値を次に示します。

(f)　注意事項

• BIBanalyzeSrchLogコマンドを実行できるのは，Administratorsグループのユーザだけです。
• BIBanalyzeSrchLogコマンドは多重実行できません。
• オプションで範囲外を指定した場合は，Usageを表示します。

(g)　解析結果を更新する場合

• ログ解析結果情報ファイルは，CSV形式で出力されます。解析結果を更新する場合は，Windowsのatコマンドを利用してBIBanalyzeSrchLogコマンドを定期的に実行してください。「検索結果一覧」画面には，ログ解析結果情報ファイルをASP.NET版テンプレートで読み込んで表示します。
• TotalBaseとTotalPeriodを使用すると，コマンド実行日を基準にランキングの集計日を指定した運用ができます。例えば，TotalBaseに0を指定し，TotalPeriodに7を指定します。この設定でコマンドを毎週日曜日に実行すると，過去１週間分の検索条件・参照文書のログが集計されるので，毎週月曜日に最新のランキングデータが参照できます。

ログ解析結果情報ファイルのフォーマットについて説明します。

ログ解析結果情報ファイルはCSV形式で出力されます。ファイルのフォーマットはbib，またはsummaryの二つのうちどちらかを，解析オプション定義ファイルのCSVOutputStyleエントリで指定します。CSVOutputStyleエントリについては「表5-10　ログ解析結果情報ファイルの設定値」を参照してください。

なお，ユーザがログ解析結果情報ファイルを作成する場合，使用できるフォーマットはbibだけです。bib以外のフォーマットで作成したファイルを指定した場合，指定は無視されます。

ログ解析結果情報ファイルのフォーマットを次の表に示します。

表5-12　ログ解析結果情報ファイルのフォーマット（bib）

注※　テーブルの対象期間を指定してください。

ログ解析結果情報ファイルのテーブルは検索条件，参照文書の二種類です。それぞれのテーブルで指定したテーブルコンテンツが，ランキングとして「検索結果一覧」画面に表示されます。

• 検索条件テーブル
  内容1に記述された検索条件と，検索条件のURLを「検索結果一覧」画面に表示します。順位とカウントはそのまま表示します。
  
• 参照文書テーブル
  内容1に記述された参照文書タイトルと，参照文書の実体へリンクするURLのリンクを「検索結果一覧」画面に表示します。順位とカウントはそのまま表示します。
  

ログ解析結果情報ファイルのCSVデータの例を次に示します。

フォーマットがbibの場合

TBL_ST_K,20080101,20080630 TBL_TL,よく使用されるキーワードランキング TBL_CT,1,Bibliotheca21,,4526 TBL_CT,2,日立,,3012 TBL_CT,3,システム,,1504 TBL_CT,4,検索,,644 TBL_CT,5,Cosminexus,,318 TBL_CT,6,Web2.0,,56 TBL_ED TBL_ST_D,20080501,20080630 TBL_TL,よく参照される文書ランキング TBL_CT,1,Bibliotheca21マニュアル,http://localhost/manual/bib21.html,415 TBL_CT,2,全文検索エンジンの変遷,http://localhost/topics/history_srch_engine.html,169 TBL_CT,3,Web2.0入門,http://localhost/topics/intro_web20.html,79 TBL_CT,4,今日から始める社内SNS,http://localhost/article/sns_bootcamp.html,54 TBL_CT,5,Cosminexusアプリケーション構築ガイド,http://localhost/doc/app_guide_cosmi.html,32 TBL_CT,6,ブログで情報発信,http://localhost/topics/try_blog.html,24 TBL_ED

フォーマットがsummaryの場合

よく使用されるキーワードランキング(2008/01/01〜2008/06/30) 順位,キーワード,カウント 1,Bibliotheca21,4526 2,日立,3012 3,システム,1504 4,検索,644 5,Cosminexus,318 よく参照される文書ランキング(2008/05/01〜2008/06/30) 順位,文書タイトル,文書実体URL,カウント 1,Bibliotheca21マニュアル,http://localhost/manual/bib21.html,415 2,全文検索エンジンの変遷,http://localhost/topics/history_srch_engine.html,169 3,Web2.0入門,http://localhost/topics/intro_web20.html,79 4,今日から始める社内SNS,http://localhost/article/sns_bootcamp.html,54 5,Cosminexusアプリケーション構築ガイド,http://localhost/doc/app_guide_cosmi.html,32

注意

フォーマットがsummaryの場合，キーワードランキングの指定をすると，タイトル（集計開始日時〜集計終了日時），順位，キーワード，カウントの書式でヘッダが出力されます。参照文書ランキングの指定をすると，タイトル（集計開始日時〜集計終了日時），順位，参照文書タイトル，文書へのリンクURL，カウントの書式でヘッダが出力されます。それぞれのヘッダを出力したあと，集計したランキングデータが出力されます。

なお，summaryのフォーマットは，出力結果のファイルを直接参照してランキングの内容を確認するために使用します。「検索結果一覧」画面に使用することはできません。

ログ解析結果情報ファイルは，ログ解析コマンド（BIBanalyzeSrchLogコマンド）を使用して作成する場合と，ユーザが作成する場合があります。ここでは，ユーザがログ解析結果情報ファイルを作成する場合の注意事項を説明します。

なお，ログ解析コマンド（BIBanalyzeSrchLogコマンド）を使用してログ解析結果情報ファイルを作成する場合，ここでの注意事項は不要です。

• ログ解析結果情報ファイルのデータは，UTF-8でエンコーディングしてください。それ以外の文字コードでデータを作成すると，「検索結果一覧」画面で文字化けが発生します。
• ログ解析結果情報ファイルが「検索結果一覧」画面に表示できるテーブル数（TBL_ST〜TBL_EDの組）は，20個までです。21個以上作成した場合，21個目以降のテーブルは無視されます。
• テーブル開始（TBL_ST_K，TBL_ST_D）に指定した日付は，そのまま画面に出力されます。指定した日付が正しいかの確認はされません。
• テーブルタイトル（TBL_TL）に指定できるタイトルの長さは255バイトまでです。256バイト以上の場合は，255バイトまでが表示されます。
• テーブルコンテンツ（TBL_CT）に指定できる順位は，1位〜100位の範囲です。無効な値を指定した場合は，そのテーブルコンテンツは表示されません。
• テーブルコンテンツ（TBL_CT）に指定できる内容1の長さは，255バイトまでです。256バイト以上の場合は255バイトまでの内容1が表示され，256バイト以降は無視されます。
• テーブルコンテンツ（TBL_CT）に指定する内容2の長さは，URLをエンコードしたあとのサイズが2,000バイト以内となるように記述してください。エンコード後の長さが2,000バイトを超えた場合，内容2の指定は無視されます。
• テーブルコンテンツ（TBL_CT）に指定できる内容1，および内容2に「,」（コンマ）が含まれる場合は，「"」（ダブルクォート）で囲んでください。また「,」と「"」の両方が含まれる場合は，「"」を二つ続けて記述する必要があります。「"」を使用した内容1，および内容2の指定例を次に示します。
  
  • 内容1に「ab,c」を指定する場合：「TBL_CT,1,"ab,c"」
  • 内容2に「ab,c"d」を指定する場合：「TBL_CT,2,"ab,c""d"」
• テーブルコンテンツ（TBL_CT）に指定するカウントは，0〜2,147,483,647の範囲で指定してください。無効な値を指定した場合，そのテーブルコンテンツはカウントを除いた情報が表示されます。
• CSVデータの各行に指定するカラム数が，各種別記号が必要とするカラム数より少ない場合，その行は読み込みエラーとなります。また，必要とするカラム数以上の指定がある場合は必要とするカラム数だけが表示され，多いカラムは無視されます。