AshiatoLOG 2.01

設置ガイド

最終更新日：

複数ページを総合記録できるアクセス解析CGIです。ダミーイメージを使ってCGIを起動することが可能なため、SSIを使用できないページのログも取れるのが特徴。他のCGIからの呼び出しも可能です。
最大の特徴は、それぞれのページがどんな風に見られてるかアクセスパターンを分析できることです。

目次
特徴
利用規定
必要ファイル
ディレクトリ構成
CGI設置
CGI変更
既存ページの変更
戻る

特徴
- 同一IPからの一定時間内のアクセス(セッション)をまとめて記録。複数ページにまたがった閲覧記録が取れます。（セッションの判定に、クッキーは使用していません。利用者のIPアドレスが一致し、アクセス時刻が近接している場合に、同一セッションでのアクセスと判断して集計します。）
- 「あしあと」というアクセスパターンを記録することができ、訪問者がどのような順番でページを閲覧していったかを見ることができます。
- 同一人物の巡回数(同一セッションでのPV数)と、その巡回に要した時間も記録集計しており、その人物のHPへの「注目度」を評価できます。
- Perlのみで記述されているため、sh、Ｃ言語などが利用できない個人のホームページへの設置・運用が可能。（perl5でかかれています。perl4では動作しません）
- 一度設置してしまえば、記録したいページにダミー画像を貼り付けるだけでOKです。（ダミー画像を貼り付けるためにHTMLを書き換える必要があります。）
- 別のプロバイダに別室を設けている場合や、ホームページとCGIが別ディレクトリに分かれている場合でも、ダミー画像を使用してすべてのページの総合的な記録をとることができます。（少なくともひとつはCGIの実行できるディレクトリ／サーバーが必要です。不明の場合、契約しているプロバイダにお問い合わせください。）
- 記録ファイルはCSV形式なので、ダウンロードしてExel等で利用可能。（CSV形式：各データがカンマで区切られたテキストファイル。Excelなどの表計算ソフトで読み込み、編集、印刷することができます。）
- 一定期間を経過した記録ファイルを自動的に削除する設定も可能。これにより、サーバー容量制限に対応できます。
- 前日の記録ファイルを指定メールアドレスに自動発送する設定も可能です。（sendmailが使用可能なサーバーのみ）
- 自分のブラウザ/OS/ホスト名を登録することで自分のアクセスを記録から除外できます。
- 集計表示CGIにはパスワードと自分のブラウザ/OS/ホスト名による利用制限を設定可能。
- ダミー画像を不正に利用されないよう、記録URLを登録することも設定可能。
- 記録集計表示の日付範囲を指定できます。表示項目の選択もできます。
- 他、ページ別アクセス数/日別・曜日別アクセス数/アクセス時間帯/サブドメイン別のアクセス数/JPドメイン外のアクセス数/ホスト/ブラウザ/OS/画面解像度（JavaScript併用時）/リンク元（JavaScript併用時）/検索キーワード等をそれぞれグラフつきで表示。
- 残留ロックファイル自動削除。
- エラーログも記録。
- ブラウザのリロードボタンを押したとき等の同一ページの連続アクセス記録は「あしあと」から削除されます。（同一人物の巡回数と巡回に要した時間としては記録されます）
利用規定
- AshiatoLOG ホームページをご参照ください。
▲TOP

必要ファイル
以下のファイルが必要になります。設定の仕方は後述します。

ファイル名	内容	パーミッション
accdata/	記録ディレクトリ	707
lock2.dat	ロックファイル（記録データへの多重書込みを防止するためのファイル）	606
index.html	ダミーHTML(ディレクトリの中身を他人に見られないため)	604
access/	実行ディレクトリ	705
accimg.cgi	記録（＆ダミーイメージ出力）CGI	705
accview.cgi	記録集計表示CGI	705
accgate.cgi	パスワード入力および集計表示項目設定CGI	705
jumper.cgi	記録集計表示CGIからリンク元にジャンプするためのCGI	705
configA.pl	アクセス記録時の各種オプション設定ファイル（自動アップデート時刻の設定などは、この中にあります）	604
configB.pl	記録集計表示時および自動アップデート時の各種オプション設定ファイル（パスワードの設定などは、この中にあります）	604
access.pl	記録ファイル読み書きルーチン	604
accupdate.pl	記録自動アップデートルーチン	604
accviewsub.pl	HTML、パスワード、集計オプション関連ルーチン	604
index.html	ダミーHTML(ディレクトリの中身を他人に見られないため)	604
bar1.gif	記録表示CGI用棒グラフ(横)画像（サンプル） ......デフォルト設定では使用しません	604
bar1v.gif	記録表示CGI用棒グラフ(縦)画像（サンプル） ......デフォルト設定では使用しません	604

※パーミッションについて
上記のパーミッションの3桁の数値は全て真中の桁が「0」になっていますが、 サーバーによっては下二桁を最下位の数字にそろえる（例えば「705」と書いてあるものは「755」にする）必要がある場合があります。
専門的にいうと、CGIが「group」のパーミッションで起動される（ホームページ設置者と同じグループIDをホームページを訪問した人に割り当てる）サーバーが該当します。

▲TOP

ディレクトリ構成
圧縮ファイルを解凍すると、以下のディレクトリ構造が出来るはずです。FTPソフトを使って、この構成のままサーバーにアップロードするようにしてください。

cgi-bin(ディレクトリ)
	   |
	   |----accdata(ディレクトリ)
	   |       |
	   |       |----index.html
	   |       |
	   |       |----lock2.dat
	   |
	   |
	   |----access(ディレクトリ)
	           |
	           |----access.pl
	           |
	           |----accgate.cgi
	           |
	           |----accimg.cgi
	           |
	           |----accupdate.pl
	           |
	           |----accview.cgi
	           |
	           |----accviewsub.pl
	           |
	           |----bar1.gif
	           |
	           |----bar1v.gif
	           |
	           |----configA.pl
	           |
	           |----configB.pl
	           |
	           |----index.html
	           |
	           |----jumper.cgi

▲TOP

CGI設置
- 「accview.cgi」・「accgate.cgi」・「accimg.cgi」・「jumper.cgi」の１行目のPerlのパスをプロバイダにあわせて書き換えてください。メモ帳（Notepad.exe）などのテキストエディタで書き換えます。プロバイダの設置案内を見ると、「#!/usr/bin/perl」とか，「#!/usr/loca/bin/perl」とかいうような、Perlのパスが書いてあると思います。そのパスにあわせて１行目を書き換えます。不明の場合は、プロバイダのサポート窓口にお問い合わせください。
- GIFファイル(画像ファイル)以外のファイルはすべてアスキー（テキスト）モードでアップロードして下さい。
- GIFファイル(画像ファイル)は、バイナリモードでアップロードして下さい。
- ファイル名はすべて半角、アルファベットは小文字です。
- 上記「必要ファイル」の表を参考にして、各ファイルのパーミッションを設定して下さい。
- 次に、記録を残したい既存ページを改造するわけですが、その前に、うまく動作しているか確認します。ブラウザで「http://.../access/accview.cgi」を表示してみてください。（「configA.pl」および「configB.pl」で各種設定を書き換える前に行ってください。）
- 「http://.../access/accview.cgi」の動作が正常であることを確認できたら、記録を残したいページを改造して、アップロードしてください。
- 以上で、運用開始です。改造した既存ページをブラウザでアクセスしたあと、ブラウザで「http://.../access/accview.cgi」を表示して、うまく記録されていることを確認してください。
▲TOP
CGI変更
基本的に、Perlのパス以外は設定不要のはずですが、お好みに合わせ、多少の設定が比較的楽に変更できます。主な設定は全て「configA.pl」と「configB.pl」に入っています。メモ帳（Notepad.exe）などのテキストエディタで必要な箇所を編集して下さい。編集が可能な箇所は、ファイルの中に書いてあります。
▲TOP
既存ページの変更
このCGIは単体では役に立ちません。記録をとりたいページにCGIを呼び出す行を追加する必要があります。といっても、HTMLファイルにダミーの画像を貼り付けるだけで簡単に呼び出せます。
- 方法１： <img>タグからCGIを呼び出す方法
  以下のような行を追加します。この行で指定の画像が表示されると同時にアクセス記録が行われます。
  赤字で書いてあるのが「accimg.cgi」のパスです。別サーバーから呼び出すときはURLをすべて書く必要があります。その場合、以下の例のようにかなり長くなります。
  そのページがアクセスされたとき、緑字で書いてある単語が記録されます。「accview.cgi」でアクセス解析を表示するとき、「あしあと」として表示される単語です。重複しないようにそれぞれのページで異なる単語を指定してください。出来るだけ短く分りやすい単語を指定した方がアクセス解析が見やすくなります。半角のアルファベットと数字以外は使わないほうが無難でしょう。
  
  最後の「img=1」というのは、そこに画像を表示するための指定です。サイズ1x1の透明GIF画像が表示されるため、実際は目に見えません。
  
  方法３の方が優れていますが、先に方法１で動作を確認することをお奨めします。
- 方法２： SSIから呼び出す方法
  Ver.1.xx同様、呼び出しは可能ですが、”require”、”use”等で呼び出すサブスクリプトのサーチパスを指定しなければならない場合があり、技術的に難しいため、解説は省略します。
- 方法３： JavaScriptの併用
  方法１ではリンク元の記録が出来ません。これをJavaScriptで記録します。また、Ver.1.00から追加された解像度の集計にもJavaScriptが必要です。方法１で動作を確認できたら、方法３を使う事をお奨めします。
  以下のような行を追加します。この行で指定の画像が表示されると同時にアクセス記録が行われます。閲覧者のブラウザがJavaScriptを使用可能な場合、リンク元の記録と画面解像度の記録も行われます。
  似たようなことを二回書いているように見えますが、上の<script...で始まるほうが、JavaScriptをつかえるブラウザ用の設定、下の<noscript>で始まるほうがJavaScriptをつかえない（または禁止している）ブラウザの設定です。
  
  以下、詳しくは方法１を参照してください。
  赤字で書いてあるのが「accimg.cgi」のパスです。別サーバーから呼び出すときはURLをすべて書く必要があります。
  緑字で書いてある単語が、そのページのアクセス時に記録されます。
  注意：画像タグ「<IMG src=～>」は、以下の例のように、改行せずに一行で書いてください。(上の例では、方法１、方法３ともに、見易さの為、ブラウザのウィンドウ幅で改行が入っています。)
```
	document.write("<IMG src='cgi-bin/access/accimg.cgi?id=INDEX&amp;img=1&amp;scr=", screen.width, "x", screen.height, "x", screen.colorDepth, "&amp;ref=", escape(document.referrer), "' border=0>");
```
- 方法４： （参考まで） CGIからの呼び出し
  自作CGIから呼び出す為のライブラリは、本バージョンより削除されましたが、IMGタグを使用することで、呼び出しは可能です。
  自作CGIから呼び出す場合は、<BODY>タグ出力後、適当な位置に「accimg.cgi」の呼び出しタグを挿入してください。
  #!/usr/local/bin/perl …(各種処理)… ##### ヘッダ表示（一例） print "Content-type: text/html\n\n"; print <<"_EOL_"; <html lang="ja-JP"> <head><title>$title</title></head> <body> _EOL_ #### アクセス集計ファイル更新タグ表示 my $refer = $ENV{'HTTP_REFERER'}; print <<"_EOL_"; <img SRC="http://www02.so-net.ne.jp/~organ/suga-cgi/access.pro/cgi-bin/access/accimg.cgi?id=BBS&img=1&ref=$refer" BORDER=0 height=1 width=1> _EOL_
  赤字が、リンク元の記録をとる処理です。CGIから呼び出す場合は、JavaScriptなしで、リンク元が記録できます。
  緑字が記録される単語です。適宜変更してください。
▲TOP