Access Report

Access Report
(アクセス解析) Kent Web

☆ 使用上のご注意！

このシステムは、Kent Web さん作成のプログラムを、当社が代行設置しているものです。
ご利用前に、以下の事項に必ず目をお通しください。
1. Kent Web スクリプト利用規定
2. 当社は皆様の便宜のために代行設置していますが、スクリプトが当社サーバー上で仮に正常に動作しない場合でも一切の保証は行いません。
3. スクリプトに動作不具合が発生し、その原因が仮に当社サーバーにあるとしても一切の保証は行いません。
4. 当社は作者から提供されているスクリプトをそのままの状態で設置します。カスタマイズはお客様ご自身で行ってください。
5. 管理用のパスワードについては、以下の説明をご覧いただき、お客様ご自身で設定してください。初期設定ではパスワード設定されていません。
6. これらに同意できない場合、スクリプト一式(ホルダ毎)をサーバーから削除してくださいますようお願いいたします。利用される場合には、これらに同意したものとみなします。
7. スクリプト設置場所:
  http://貴方のドメイン名/cgi/report/ (= /home/yourdomain/www/cgi/report/)

以下は、スクリプト使用方法について、作者の方のドキュメントを引用（抜粋、当社環境用に一部修正）させていただいたものです。正本はこちら

■ サンプルと特長

このシステムは、ホームページへの「アクセス解析」を行うものです。
サンプルは以下にあります。

Access Report
Access Reportの機能的な特長は以下のとおりです。
1. どこからリンクされてきたかという「リンク元情報」「ブラウザ情報」「ホスト名情報」「アクセス時間帯」等を集計し、その割合をグラフ表示します。
2. オプションにより、SSIを使わず CGI + JavaScriptで動作するモードと、CGI + SSIで動作する２つのモードが可能です。
  （CGI + SSIモードのほうが、より正確なリンク元、ブラウザ情報等を取得することができますが、プロバイダでSSIが利用可能であることや、フレームページでの利用ができないなどの制限があります）
3. ロックファイル機構により、同時アクセスによるログ破損を極力防止します。　
このスクリプトを利用する上での利用規定です。必ず目を通しておいて下さい。スクリプトをダウンロードする場合、無条件に「利用規定」に同意したものとみなします。

スクリプト利用規定
※プログラムは、セキュリティ対策を施した v2.3以降を必ずご使用ください。

■ プログラムの入手

以下の書庫（圧縮）ファイルをダウンロードします。書庫ファイルは LHA形式と ZIP形式のいずれかをお選びください。

Ver: 3.02

LHA形式

report.lzh ZIP形式

report.zip
ダウンロード後、解凍します。解凍すると以下のファイルが展開されます。

report.cgi
replog.cgi
replist.cgi
jcode.pl (*1)
graph1.gif
graph2.gif

(*1) 歌代和正氏作のライブラリで再配布は許可されています。秀逸なライブラリを提供する同氏に感謝します。

Ver: 3.02
LHA形式 report.lzh		ZIP形式 report.zip

■ プログラムの修正

ウェブディレクトリ（ここでは /home/yourdomain/www/cgi/ ディレクトリとします）の下に、reportディレクトリを作成し、上記のファイルをFTP転送します。また、ロック用ディレクトリ「lockディレクトリ」を reportディレクトリの下に作成します。

全体のディレクトリ構成とファイル位置の設置例は以下のとおりです。（かっこ内はパーミッションの設定値）

report.cgi をエディタで開いて以下の箇所を修正します。

#!/usr/local/bin/perl

（プロバイダで定められたPerlへのパスを指定します）

$jcode = './jcode.pl';

（jcode.plの位置を指定します。report.cgiと同一ディレクトリにおく場合にはこのままとしておきます）

$ssi = 0;

（CGI + JavaScriptモードでの運用ならば 0 を、CGI + SSIモードであれば 1 を指定します。この指定によって、HTMLに記述するタグに違いがあるので注意します） (*1)

$max = 1000;

（蓄積するログの最大数を指定します。これ以上大きく設定しない方が無難です）

$rand = 0;

（アトランダム機能で、0以外を指定することで有効になります。例えば、$rand = 100; とすると、確率的に100回に1度カウントを取り、それ以外はカウント集計を行ないません） (*2)

$myurl = 'http://www.xxx.yyy/~foo/ http://www.zzz.xx.jp/';

（リンク元除外ページを指定します。スペースで区切ることで複数のURLも指定可能です。ここで指定したURLは「リンク元」集計から除外されます）

$lockkey = 0;

（ログ消滅防止策としてのファイルロック機構の設定です。サーバでsymlink関数が使用可能であれば「1」を、使用できない場合又はよく分からない場合には「2」とします。

$lockfile = "./lock/report.lock";

（ロックファイルを記述します。report.cgi のあるディレクトリの下に「lockディレクトリ」を作成する場合にはこのままでOKです）

$ip_chk = 0;

（直前のIPアドレスをチェックして、重複記録を避ける機能です。この機能を行なう場合には 1 とします）

(*1) CGI + JavaScriptモードと CGI + SSIモードの違いは以下のとおりです。

	CGI + JavaScript	CGI + SSI
リンク元	JavaScriptで取得	SSIで取得
特徴	SSIの使えないプロバイダでも利用可能フレームページで利用可能ブラウザ情報やリンク元の取得に一部制限あり	プロバイダでSSIが利用可能であることが条件フレームページではリンク元が取得不可ブラウザ情報やリンク元が汎用的に取得可能

(*2) 1日のカウント数が1000回以上の人気サイトなどでは有効な機能です。

これはログ保持件数が初期値で1000件のため、1日に1000件以上アクセスのあるサイトでは「時間帯」の集計が不均衡になるため、アトランダム機能により、1日の集計数を調整します。

例： 1日のアクセスが3000件のサイト　→　$rand = 30;　で設定すると、3000÷30=100件で、1日当りの集計件数は約100件となり、1000件のログを10日で更新することになり、時間帯集計などが平均化します。

replist.cgi をエディタで開いて以下の箇所を修正します。

#!/usr/local/bin/perl
（プロバイダで定められたPerlへのパスを指定します）

$title = "My HomePage";
（ホームページのタイトル名を指定します）

$body = '<body bgcolor="#F0F0F0" text="#000000" link="#0000FF" vlink="#800080 alink="#FF0000">';
（一覧リストのbodyタグを適当に修正します。背景色や文字色の変更など）

$graph1 = "./graph1.gif"; # 横軸
$graph2 = "./graph2.gif"; # 縦軸
（グラフ画像の指定です。replist.cgiと同じディレクトリに置く場合はこのままで結構ですが、サーバ規定などによりグラフ画像を別ディレクトリ等に置く場合は、http://からの絶対パスで指定します）

$max_ref = 2;
$max_os = 2;
$max_brz = 2;
$max_hst = 5;
（リスト最低表示件数の指定で、上から順に「リンク元」「OS情報」「ブラウザ」「ホスト名」となります。これに満たない情報は非表示となります）

$pass = '';
（解析リストの一覧を、パスワードがないと閲覧できないように制限する場合には、その「パスワード」を英数字で指定します）
例： $pass = '0123abc'; → パスワードを「0123abc」とする場合

以上、修正が完了したら該当ファイルをFTP転送し、以下のとおりパーミッションを設定します。

ファイル名	パーミッション		転送モード
ファイル名	一般サーバ	suEXECサーバ CGIWrapサーバ	転送モード
report.cgi	755 or 705	701 or 700	アスキー
replist.cgi	755 or 705	701 or 700	アスキー
replog.cgi	666 or 606	600	アスキー
jcode.pl	644 or 604	600	アスキー
*.gif	-	-	バイナリ
lockディレクトリ	777 or 707	701 or 700	-

Tips:ファイル転送の仕方は以下のページを参考にしてください。

Windows編 Mac編

チェックモードについて
- 外部から設定チェックを行うことができます。
- checkという引数をスクリプトの後につけて直接呼び出せば結果が表示されます。
  
  http://～～/report.cgi?check

最後に、アクセス集計を取りたいHTMLファイル（トップページなど）の <body>～</body>間に、タグを記述します。

【CGI + JavaScriptモードの基本的な記述例】 → $ssi = 0; のとき

<SCRIPT Language="JavaScript">  </SCRIPT>

【CGI + JavaScriptモードで、フレームページでの記述例】 → $ssi = 0; のとき

<SCRIPT Language="JavaScript">  </SCRIPT>

【CGI + SSIモードの記述例】 → $ssi = 1; のとき

集計リストを見る場合は、ブラウザから直接 replist.cgi を指定することで見ることができます。
またHTMLからリンクする場合は以下のように記述するといいでしょう。

【リンクタグ記述例】

<a href="http://～～/report/replist.cgi">アクセス解析</a>