Access Report

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

☆ 使用上のご注意！

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

※2007年11月02日更新。これ以前にサーバー契約されている方はこちらをご覧下さい。

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

　■ サンプルと特長

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

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

※プログラムは、セキュリティ対策を施した v3.02以降を必ずご使用ください。

　■ プログラムの入手

以下の書庫（圧縮）ファイルをダウンロードします。

Ver: 4.1

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

report.cgi
init.cgi
replog.cgi
replist.cgi
lib/jcode.pl (*1)
lib/simaguni.pl (*2)
lib/jipang8.txt (*2)
img/graph1.gif
img/graph2.gif

(*1) 歌代和正氏のライブラリを再配布するものです。【入手元】
(*2) 小室暁生氏のライブラリを再配布するものです。【入手元】
※秀逸なPerlライブラリを公開する両氏に感謝します。

Ver: 4.1
report.zip

　■ プログラムの修正

ホームディレクトリ（ここでは public_htmlディレクトリとします）の下に、reportディレクトリを作成し、その配下に上記のファイルをFTP転送します。また、ロック用ディレクトリ「lockディレクトリ」を reportディレクトリの下に作成します。

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

public_html / index.html (トップページ) | switch / -- imgRep / graph1.gif | graph2.gif | cgi-bin / -- report /┬ report.cgi ├ init.cgi ├ replog.cgi ├ replist.cgi │ └ lib / jcode.pl simaguni.pl jipang8.txt

init.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は「リンク元」集計から除外されます）

$ip_chk = 0;

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

$title = "My HomePage";

（ホームページのタイトル名を指定します）

$body = '<body bgcolor="#F0F0F0" text="#000000" link="#0000FF" vlink="#800080 alink="#FF0000">';

（一覧リストのbodyタグを適当に修正します。背景色や文字色の変更など）

$graph1 = "./img/graph1.gif"; # 横軸

$graph2 = "./img/graph2.gif"; # 縦軸

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

$max_ref = 2;

$max_os = 2;

$max_brz = 2;

$max_hst = 5;

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

$pass = '';

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

例： $pass = '0123abc'; → パスワードを「0123abc」とする場合

(*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日で更新することになり、時間帯集計などが平均化します。

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

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

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

ファイル名	パーミッション		転送モード
ファイル名	一般サーバ	suEXECサーバ CGIWrapサーバ	転送モード
report.cgi replist.cgi	755 or 705	701 or 700	アスキー
replog.cgi	666 or 606	600	アスキー
init.cgi jcode.pl simaguni.pl jipang8.txt	644 or 604	600	アスキー
graph1.gif graph2.gif	-	-	バイナリ

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://～～/cgi-bin/report/replist.cgi">アクセス解析</a>

　■ おすすめページ

機能改良バージョン
At Works
isweb向け改良バージョン
Single Access Reort for isweb