ランダムグラフィックカウンタ

特徴

1. ランダムグラフィックカウンタ : <!--#exec cmd="./count.ksh [lengs] [rand]"-->
   • Korn シェルで作成した、グラフィックイメージをランダムに呼び出すカウンタです。コマンドが実行された数に応じた IMG タグを呼び出し、ログデータファイル logdata.${DOCUMENT_NAME}.file にコマンド実行の情報を記入します。
   • カウント数保持ファイル no.${DOCUMENT_NAME}.file、ログデータファイル logdata.${DOCUMENT_NAME}.file、ロックファイル名保持ファイル countlockfile.${DOCUMENT_NAME}.file は、Web ページ毎に作成されるため、複数の Web ページにカウンタを設置することができます。これらのファイルが、カレントディレクトリに存在しない場合は、本スクリプトは自動的にこれらのファイルを作成します。従って、新規 Web にカウンタを設置する場合、その Web ページに、 <!--#exec cmd="./count.ksh [lengs] [rand]"--> と記入するだけで準備が完了します。
   • デフォルトで、6桁、10種類のイメージファイルを呼び出します。
   • カウンタは、引数を指定することにより、桁数、ランダムに呼び出すイメージの種類数を指定できます。
2. カウンタログ解析 : <!--#exec cmd="./acs_stat.sh [-dtha] [-n num] [file....]"-->
   • acs_stat.html ファイルから、count.ksh コマンドが作成したログデータファイル logdata.${DOCUMENT_NAME}.file を解析して、日付別アクセス明細、時刻別アクセス明細、ドメイン別アクセスランキング、アクセス明細を表示することが出来ます。
   • オプションを指定しない場合は、デフォルトで、日付別アクセス明細、時刻別アクセス明細、ドメイン別アクセスランキング、アクセス明細（最大表示件数:100）の順で、全ての明細を表示します。
   • ログデータファイル名を指定しない場合は、カレントディレクトリに存在する全てのログデータファイルの明細を順次表示します。
   • カウンタログ解析は、オプションを指定することにより、表示明細を指定することが出来ます。

インストールの方法

インストール作業を自動化しています。

1. count.tar ファイルをダウンロードして下さい。
2. カウンタを置きたいディレクトリに count.tar ファイルを転送して下さい。（転送モード binary）
3. telnet でログインして下さい。
4. カウンタを設置したいディレクトリに count.tar を置き、
   tar -xvf count.tar と入力して下さい。
5. ./config.sh と入力して下さい。自動的にカウンタとアクセスログ解析及びその他必要ファイルがインストールされます。
6. 後は、カウンタを設置するファイルに <!--#exec cmd="./count.ksh"--> と記入すれば、OK です。

インストールされるファイル

./config.sh と入力することにより、カレントディレクトリに以下のファイルのインストールと設定が行われます。

test_count.html

テスト用ランダムアクセスカウンタ呼び出しファイル。
<!--#exec cmd="./count.ksh"--> と記入。

count.ksh

ランダムグラフィックカウンタスクリプト。
chmod 5711 count.ksh

no.${DOCUMENT_NAME}.file

カウント数保持ファイル。
count.ksh スクリプトが自動作成します。
chmod 600 no.${DOCUMENT_NAME}.file

logdata.${DOCUMENT_NAME}.file

ログデータファイル。
count.kshスクリプトが自動作成します。
chmod 600 logdata.${DOCUMENT_NAME}.file

countlockfile.${DOCUMENT_NAME}.file

ロックファイル名保持ファイル。
count.kshスクリプトが自動作成します。
chmod 600 countlockfile.${DOCUMENT_NAME}.file

rmcountlock

ロックファイル手動削除スクリプト。
chmod 700 rmcountlock

count_images/
　├ 0a.gif - 9a.gif
　│　│
　└ 0j.gif - 9j.gif

カウントイメージファイル。
mkdir count_images ; chmod 755 count_images ; chmod 644 count_images/??.gif
WIDTH="15" HEIGHT="20"

acs_stat.html

ログ解析スクリプト呼び出しファイル。
<!--#exec cmd="./acs_stat.sh"--> と記入。

acs_stat.sh

ログ解析スクリプト。
chmod 5711 acs_stat.sh

$HOME/man/man1/count.ksh.1

ランダムグラフィックカウンタスクリプトマニュアル。
man -M $HOME/man count.ksh で表示。

$HOME/man/man1/acs_stat.sh.1

カウンタログ解析スクリプトマニュアル。
man -M $HOME/man acs_stat.sh で表示。

* man -M $HOME/man count.ksh 及び、man -M $HOME/man acs_stat.sh と入力することで、それぞれのスクリプトのマニュアルを表示することが出来ます。

環境

このスクリプトは、SSI(Server Side Includes) で動作します。このスクリプトが動作するには、httpd の access.confファイル srm.confファイルに適切な設定が必要となります。詳しくは、 httpd のマニュアルをご覧下さい。
各ディレクトリで制御する場合の ACF ファイル (.htaccess: ディレクトリアクセス制御ファイル)の例を、参考として以下に示します。

.htaccessファイルの記述

Options Includes
AddType text/x-server-parsed-html .html
Addtype text/x-server-parsed-html .shtml

利用規定

1. 著作権表示部分の削除不可。
2. 再配布禁止。
3. 上記の項目は、修正使用を含みます。

* 本スクリプトを無償で使用するにあたり、如何なる責をも当方は負いかねます。

count.ksh 機能説明

• Web ページに、<!--#exec cmd="./count.ksh [lengs] [rand]"--> と記入することにより、コマンドが実行された数に応じた IMG タグを呼び出し、ログデータファイル logdata.${DOCUMENT_NAME}.file にコマンド実行の情報を記入する。
• カウント数保持ファイル no.${DOCUMENT_NAME}.file、ログデータファイル logdata.${DOCUMENT_NAME}.file、ロックファイル名保持ファイル countlockfile.${DOCUMENT_NAME}.fileは、 Webページ毎に作成されるため、複数の Webページにカウンタを設置することができます。これらのファイルが、カレントディレクトリに存在しない場合は、本スクリプトは自動的にこれらのファイルを作成します。従って、新規 Webにカウンタを設置する場合、その Webページに、 <!--#exec cmd="./count.ksh [lengs] [rand]"-->と記入するだけで準備が完了します。
• カウンタの桁数 [lengs] を指定しない場合は、デフォルトで 6 桁表示となります。
• 乱数の数 [rand] を指定しない場合は、デフォルトで 10 種類のイメージファイルをランダムに呼び出します。

オペランド

lengs

カウンタの桁数を指定します。カウンタの桁数は、最小桁数 1 から 50 までの範囲で選択する事ができます。カウンタの桁数を指定しない場合は、デフォルトで 6 桁となります。

rand

ランダムに呼び出すカウントイメージ数を指定します。ランダムに呼び出されるカウントイメージは、 1 （カウントイメージ固定）から 10 までの範囲でカウントイメージ数を選択することができます。ランダムに呼び出すカウントイメージを指定しない場合は、デフォルトで 10 種類のイメージファイルをランダムに呼び出します。 カウントイメージ固定にした場合、デフォルトで ?a.gif が使用されます。デフォルトイメージを変更したい場合は、 count.ksh スクリプト内の default_image 変数の値を変更して下さい。指定できる値は、 a から j までです。

診断

このスクリプトは、ロックファイル、テンポラリーファイル、割り込み処理の手続きを行うことにより、トラブルを最小限に押さえています。カウントファイル、ログファイルへの複数のユーザによる同時記入を防止する為、本スクリプトはロックファイルを作成します。ロックファイルが存在する場合、本スクリプトは 1 分間に 60 回の試行を試みます。それでも、記入することができない場合、 I'm busy と表示します。
しかしながら、 I'm busy が続く場合は、予期せぬトラブルにより、（先ず無いと思いますが）ロックファイルが削除されず、そのまま残っている可能性があります。その場合、ロックファイルを手動で削除する為、 rmcountlock スクリプトを実行して下さい。 countlockfile.${DOCUMENT_NAME}.file に基づいて、カレントディレクトリに存在するカウンタを置いたファイルのロックファイルを全て削除します。

使用例

<!--#exec cmd="./count.ksh"-->

カウント桁数 6 桁、ランダムに呼び出すカウントイメージ数 10 種類。

<!--#exec cmd="./count.ksh 8"-->

カウント桁数 8 桁、ランダムに呼び出すカウントイメージ数 10 種類。

<!--#exec cmd="./count.ksh '' 5"-->

カウント桁数 6 桁、ランダムに呼び出すカウントイメージ数 5 種類。

<!--#exec cmd="./count.ksh 12 1"-->

カウント桁数 12 桁、ランダムに呼び出すカウントイメージ数 1 種類。

acs_stat.sh 機能説明

• Web ページに、<!--#exec cmd="./acs_stat.sh [-dtha] [-n num] [file....]"--> と記入することにより、 count.ksh コマンドが作成したログデータファイル logdata.${DOCUMENT_NAME}.file を解析して、日付別アクセス明細、時刻別アクセス明細、ドメイン別アクセスランキング、アクセス明細を表示する。
• オプションを指定しない場合は、デフォルトで、日付別アクセス明細、時刻別アクセス明細、ドメイン別アクセスランキング、アクセス明細（最大表示件数:100）の順で、全ての明細を表示する。
• ログデータファイル名を指定しない場合は、カレントディレクトリに存在する全てのログデータファイルの明細を順次表示する。

オプション

オプションを指定した場合は、表示明細を指定することができます。その場合、オプションを指定した順序で、明細を表示します。

-d

日付別アクセス明細を表示する。

-t

時刻別アクセス明細を表示する。

-h

ドメイン別アクセスランキングを表示する。

-a

アクセス明細を表示する。

-n num

アクセス明細の最大表示件数。
-aオプションを指定した場合に、 -nオプションを指定して、アクセス明細の最大表示件数を指定することができます。
numに 1以上の整数を指定して下さい。
デフォルトの最大表示件数は、 100 です。

オペランド

file....

解析するログデータファイル名を指定します。ログデータファイル名は、空白で区切ることにより、複数指定可能です。
ログデータファイル名を指定しない場合は、デフォルトでカレントディレクトリに存在する全てのログデータファイルの明細を順次表示します。

使用例

<!--#exec cmd="./acs_stat.sh"-->

<!--#exec cmd="./acs_stat.sh -dtha -n 100"--> と同等。
<!--#exec cmd="./acs_stat.sh -d -t -h -a -n 100"--> と同等。
日付別アクセス明細、時刻別アクセス明細、ドメイン別アクセスランキング、アクセス明細（最大表示件数:100）の順で、全ての明細を表示する。

<!--#exec cmd="./acs_stat.sh -d"-->

日付別アクセス明細のみ表示する。

<!--#exec cmd="./acs_stat.sh -hd"-->

<!--#exec cmd="./acs_stat.sh -h -d"--> と同等。
ドメイン別アクセスランキング、日付別アクセス明細の順で、明細を表示する。

<!--#exec cmd="./acs_stat.sh -hadt"-->

<!--#exec cmd="./acs_stat.sh -hadt -n 100"--> と同等。
<!--#exec cmd="./acs_stat.sh -h -a -d -t"--> と同等。
<!--#exec cmd="./acs_stat.sh -h -a -d -t -n 100"--> と同等。
ドメイン別アクセスランキング、アクセス明細（最大表示件数:100）、日付別アクセス明細、時刻別アクセス明細の順で、明細を表示する。

<!--#exec cmd="./acs_stat.sh -ad -n 300"-->

<!--#exec cmd="./acs_stat.sh -a -d -n 300"--> と同等。
アクセス明細、日付別アクセス明細の順で、明細を表示する。ただし、アクセス明細の最大表示件数は、 300 件。

<!--#exec cmd="./acs_stat.sh -hadt -n 300"-->

<!--#exec cmd="./acs_stat.sh -h -a -d -t -n 300"--> と同等。
ドメイン別アクセスランキング、アクセス明細、日付別アクセス明細、時刻別アクセス明細の順で、明細を表示する。ただし、アクセス明細の最大表示件数は、 300 件。

<!--#exec cmd="./acs_stat.sh logdata.index.html.file"-->

<!--#exec cmd="./acs_stat.sh -dtha -n 100 logdata.index.html.file"--> と同等。
<!--#exec cmd="./acs_stat.sh -d -t -h -a -n 100 logdata.index.html.file"--> と同等。
カレントディレクトリに存在する index.htmlファイルのログデータファイルを解析し、日付別アクセス明細、時刻別アクセス明細、ドメイン別アクセスランキング、アクセス明細（最大表示件数:100）の順で、明細を表示する。

<!--#exec cmd="./acs_stat.sh -hadt -n 300 logdata.index.html.file"-->

<!--#exec cmd="./acs_stat.sh -h -a -d -t -n 300 logdata.index.html.file"--> と同等。
カレントディレクトリに存在する index.htmlファイルのログデータファイルを解析し、ドメイン別アクセスランキング、アクセス明細、日付別アクセス明細、時刻別アクセス明細の順で、明細を表示する。ただし、アクセス明細の最大表示件数は、 300 件。

<!--#exec cmd="./acs_stat.sh -hadt -n 300 ../logdata.index.html.file"-->

<!--#exec cmd="./acs_stat.sh -h -a -d -t -n 300 ../logdata.index.html.file"--> と同等。
親ディレクトリに存在する index.htmlファイルのログデータファイルを解析し、ドメイン別アクセスランキング、アクセス明細、日付別アクセス明細、時刻別アクセス明細の順で、明細を表示する。ただし、アクセス明細の最大表示件数は、 300 件。