Analog 5.91beta1: その他のレポート Analog 5.91beta1: その他のレポートまず、時間レポートと同様に、これらのレポートにも COLS 系コマンドがあります。(このコマンドの使い方については、時間レポートの章を参照してください) しかし、時間レポート以外のレポートのみで使用可能なカラムもあります。以下、そうしたカラムの一覧を示します。
REQCOLS NRSDはリクエストレポート中のファイル数、各々のファイルに対するリクエスト数、各々のファイルに対する最近7日間のリクエスト数、各々のファイルに対する最後のリクエスト 時刻を表示させます。 時間レポート以外の COLS 系コマンドの一覧を以下に示します: HOSTCOLS、REDIRHOSTCOLS、FAILHOSTCOLS、ORGCOLS、DOMCOLS、REQCOLS、DIRCOLS、TYPECOLS、SIZECOLS、PROCTIMECOLS、REDIRCOLS、FAILCOLS、REFCOLS、REFSITECOLS、SEARCHQUERYCOLS、SEARCHWORDCOLS、INTSEARCHQUERYCOLS、INTSEARCHWORDCOLS、REDIRREFCOLS、FAILREFCOLS、BROWREPCOLS、BROWSUMCOLS、OSCOLS、VHOSTCOLS、REDIRVHOSTCOLS、FAILVHOSTCOLS、USERCOLS、REDIRUSERCOLS、FAILUSERCOLS、 STATUSCOLS すべてのカラムがすべてのレポートで使用できるわけではありません。あるレポートで使用できないカラムを設定すると、Analog は警告を出力します。
HOSTSORTBY ALPHABETICALというコマンドにより、「ホストレポート」がアルファベット順にソートされます。SORTBY 系コマンドの一覧を以下に示します: HOSTSORTBY、REDIRHOSTSORTBY、FAILHOSTSORTBY、ORGSORTBY、DOMSORTBY、REQSORTBY、DIRSORTBY、TYPESORTBY、REDIRSORTBY、FAILSORTBY、REFSORTBY、REFSITESORTBY、SEARCHQUERYSORTBY、SEARCHWORDSORTBY、INTSEARCHQUERYSORTBY、INTSEARCHWORDSORTBY、REDIRREFSORTBY、FAILREFSORTBY、BROWREPSORTBY、BROWSUMSORTBY、OSSORTBY、VHOSTSORTBY、REDIRVHOSTSORTBY、FAILVHOSTSORTBY、USERSORTBY、REDIRUSERSORTBY、FAILUSERSORTBY、STATUSSORTBY もう一度書きますが、すべてのカラムがすべてのレポートで使用できるわけではありません。あるレポートで使用できないカラムを設定すると、警告が出力されます。
なおSORTBY ALPHABETICALに関しては、既知のバグが1つあり、レポートは 出力エイリアス が適用される前にソートされてしまいます。 このため、出力エイリアスがレポートに適用されていると、そのレポートは正しくソートされません。
DOMFLOOR 1000r # 少なくとも1,000件のリクエストがあった全てのドメイン
DOMFLOOR 100s # 最近7日間で少なくとも100件のリクエスト
DOMFLOOR 1000p # 少なくとも1,000件のページリクエスト
DOMFLOOR 100q # 最近7日間で少なくとも100件のページリクエスト
DOMFLOOR 1000000b # 少なくとも1,000,000バイトのデータ転送量
DOMFLOOR 1kb # 少なくとも1キロバイト(1,024バイト)
DOMFLOOR 10.5kc # 最近7日間で少なくとも 10.5Mb
DOMFLOOR 0.5%r # ドメインレポートで、総リクエスト数の 0.5%
# ( %s、%p 等についても同様)
DOMFLOOR 0.5:r # どれかのドメインに対する最大リクエスト数の 0.5%
# ( %s、%p 等についても同様)
DOMFLOOR 970701d # 1997年7月1日以降で最も最近のアクセス
DOMFLOOR 970701e # 1997年7月1日以降で最も古いアクセス
DOMFLOOR -00-01-00d # 先月に発生した最終アクセス(
# FROM および TO
# コマンドのドキュメントを参照のこと)
DOMFLOOR -100r # リクエスト数で上位100位以内のドメイン
# ( -100s、p、q、b、c、d、e も同様)
FLOOR 系コマンドの一覧を以下に示します: HOSTFLOOR、
REDIRHOSTFLOOR、FAILHOSTFLOOR、DOMFLOOR、
ORGFLOOR、REQFLOOR、DIRFLOOR、
TYPEFLOOR、REDIRFLOOR、FAILFLOOR、
REFFLOOR、REFSITEFLOOR、SEARCHQUERYFLOOR、
SEARCHWORDFLOOR、INTSEARCHQUERYFLOOR、
INTSEARCHWORDFLOOR、REDIRREFFLOOR、
FAILREFFLOOR、BROWREPFLOOR、BROWSUMFLOOR、
OSFLOOR、VHOSTFLOOR、REDIRVHOSTFLOOR、
FAILVHOSTFLOOR、USERFLOOR、REDIRUSERFLOOR、
FAILUSERFLOOR、STATUSFLOOR
繰返しになりますが、すべての閾値がすべてのレポートで有効ではありません。あるレポートで使用できない閾値を設定すると、警告が出力されます。
REQCHART OFFは、リクエストレポートでの円グラフの表示を抑止しますが、
REQCHART ONは、表示を行なわせます。以下の引数を指定することで、様々な円グラフを表示させることもできます。
CHART 系コマンドの一覧を以下に示します: HOSTCHART、REDIRHOSTCHART、 FAILHOSTCHART、ORGCHART、DOMCHART、 REQCHART、DIRCHART、TYPECHART、 REDIRCHART、FAILCHART、REFCHART、 REFSITECHART、SEARCHQUERYCHART、 SEARCHWORDCHART、INTSEARCHQUERYCHART、 INTSEARCHWORDCHART、REDIRREFCHART、 FAILREFCHART、BROWREPCHART、BROWSUMCHART、 OSCHART、VHOSTCHART、REDIRVHOSTCHART、 FAILVHOSTCHART、USERCHART、REDIRUSERCHART、 FAILUSERCHART、STATUSCHART、SIZECHART、 PROCTIMECHART 再度繰返しますが、すべてのグラフの方式がすべてのレポートで有効ではありません。あるレポートで使用できない閾値を設定すると、警告が出力されます。また、以下のコマンド
ALLCHART ON ALLCHART OFFにより、一括して同じ設定を行なうことも可能です。
円グラフは、通常 OUTFILE と同じディレクトリに書き出されますが、CHARTDIR および LOCALCHARTDIR コマンドにより、別の場所を指定することもできるようになっています。OUTFILE が標準出力の場合は、このコマンドで場所を指定しない限り、円グラフはどこにも書き出されません。 また、複数の出力ファイルを同じディレクトリに書き出すようにしている場合も、このコマンドで場所を指定しない限り、すでに存在する画像ファイルが別の出力の画像ファイルによって上書きされてしまいます。フォームインタフェースを使っている場合も、このコマンドで場所を指定することが必要ですが、それ以外にも気をつける点があります。 case.
このコマンドは、設定ファイル内で、コマンドの記述が参照されるより前に記述する必要があります。 CHARTDIR は円グラフが置かれるサーバ上の URL になります。IMAGEDIR コマンドの場合と同様に、これはグラフの画像イメージに対応づけられる「img」タグに反映されます。 LOCALCHARTDIR は、画像ファイルの書き込み先となるサーバのファイルシステム上での場所を指定します。例えば、以下の設定により
CHARTDIR /images/ LOCALCHARTDIR /usr/local/apache/htdocs/images/円グラフは /usr/local/apache/htdocs/images/dom.png といった場所に書き込まれ、<img src="/images/dom.png">のような形で参照されます。Windows の場合、「\」記号を行末に記述した際に、継続行を示すものとして解釈されるのを避けるために、LOCALCHARTDIR の引数を括弧で囲む必要があります。以下に例を示します。
LOCALCHARTDIR "\webimages\analog\"実際には CHARTDIR と LOCALCHARTDIR はファイル名の先頭に付加される文字列に過ぎないので、以下のような記述を行なうことで、
CHARTDIR /stats/rep1 LOCALCHARTDIR /usr/local/htdocs/stats/rep1円グラフを /usr/local/htdocs/stats/rep1dom.png のような場所に書き込ませ、そのリンクを <img src="/stats/rep1dom.png"> のように行なわせることも可能です。 LOGFILE や OUTFILE と同様に、上記文字列には、日付を含めることも可能です。
Analog のコンパイルを自分で行ない、その際に Analog が提供する libgd の代わりに、外部の libgd を指定した場合(これを行なう方法については、Makefile を参照のこと)、以下のコマンド
JPEGCHARTS ONを使うことで、グラフの画像を PNG フォーマットではなく JPEG フォーマットで出力することが可能になります (PNGIMAGES コマンドにより、時間レポートの棒グラフを PNG から GIF フォーマットにすることも可能です)。
以下、円グラフの中に各要素をどのように表示するかについて説明します。最大10個の要素と「その他」が表示されます。一定以上の割合に達しない要素は表示されません。また、表示される要素は、レポートのメインの項目に限られます。なお、要素が1つしかない場合、円グラフ自体が表示されません。
より詳細な円グラフを表示したい場合、例えばOSレポートにおいて「Windows」ではなく、Windows 98とWindows NTを個別に表示したい場合などは、次の章を参照してください。
REPORTSPAN ONREPORTSPANTHRESHOLD というコマンド (これは RSTHRESH と省略できます)もあります。これは、 This says that each report span should only be listed if it differs from the overall span of the whole report -- listed at the top of the page -- by at least this many minutes at one end. 例えば、
REPORTSPANTHRESHOLD 60は、レポートの期間が、ログファイルの開始時刻より、1時間以上経ってから始まるもの、もしくはログファイルの終了時刻より、1時間以上前に終了するものについてのみ、「レポート報告期間」を表示します。
REPORTSPANTHRESHOLD 0と記述することにより、すべてのレポートに「レポート報告期間」が表示されます。
もう一つ、リクエストレポート、リダイレクトレポート、失敗レポート に影響を与えるコマンドがあります。BASEURL コマンドは生成されるリンクの URL に付加する文字列を指定します。例えば、以下のコマンドを記述すると
BASEURL http://www.statslab.cam.ac.uk/~sret1/ は http://www.statslab.cam.ac.uk/~sret1/ にリンクされます。/~sret1/ ではありません。 This is very useful if you want to display the statistics on a different server from the server they refer to. http://www.statslab.cam.ac.uk/~sret1/ に対するリンクを作成したいのではなく、ファイル自体を http://www.statslab.cam.ac.uk/~sret1/ のように表示させたい場合は、LOGFILE コマンドの第2引数を使用してください。
次の章では、本章で説明したコマンドと密接に関係する 階層レポート を生成するコマンドについて説明していきます。
Stephen Turner
Analog についての質問はanalog-help メーリングリスト をお使いください。 (訳注: 日本では analog-jp メーリングリスト をご利用ください)