AWStats Ver.7.0 完全日本語版

日本語化について

AWStats自身は日本語に対応していることになっていますが、かなり”オマケ”的な対応でしかなく、日本人の目から見たら明らかに不自然な箇所、不足ている機能などが目に付きます。このため、日本人が”自然に”利用できるようにするために修正を加えたものをここで公開しています。実際の利用イメージについては、こちらを参照ください。

具体的に加えた修正点は以下の通りです。

・ユーザーインターフェースの日本語を”自然”な日本語に
・メンテが放置されていた各種メッセージファイル / チップヘルプファイルの最新化
・日本ローカルの検索エンジンを検出するように修正
・Google(J), Biglobe, Nifty, MSN(J), ODN, Excite(J)など
・日本ローカルブラウザであるSleipnirとLunascapeを検出するように修正。
・日本ローカルロボット(はてなアンテナなど)を検出するように修正。
・日本語の検索語が正常に検出されない(文字化け)を修正。
・Google/Yahooのキャッシュ経由でのアクセスを正常に検出されるように修正。
・設定ファイルの日本語化。

ちなみに、Ver.7.0の日本語化にあたって、Googleのキャッシュ経由のアクセスのロジックの見直しを行いました(URLの変更があったため)。

AWStats Ver.7.0完全日本語版のダウンロード

以下のリンクからダウンロードができます。当然ではありますが、ご利用は自己責任で。

AWStats Ver.7.0完全日本語版のダウンロード

AWStats Ver.7.0完全日本語版のインストール

基本はかなり昔から変わっていません。少々古い文書になりますが、こちらが参考になると思いますので、併せて参考にしてください。configure.plというインストール用のスクリプトファイルを利用する方法と手動でインストールする方法とがありますが、ここでは後者を紹介します。挙動をよく理解するという意味でも、個人的には手動インストールをお勧めいたします。なお、想定している環境はCent OS(=Redhat系のディストリビューション)のApacheです。

ファイルをダウンロード・解凍してから、以下の手順でインストールを行ってください。

1. 展開されたファイルのコピー

最低限必要なのは、配布ファイルの/wwwroot/cgi-bin以下と/wwwroot/icon以下に格納されているファイルです。特に考慮すべき事情が無ければ、前者に格納されているファイル/ディレクトリは、WebサーバでCGIが動作するディレクトリに、後者に格納されているディレクトリは、Webサーバで利用するアイコンのファイルが格納されているディレクトリ(CentOSの場合/var/www/icon)にコピーします。前者については、以降の手順では/var/www/cgi-bin/AWStats70というディレクトリにコピーしたと考えることとします。同時に適切な権限を設定しておくことを忘れないように(awstats.plはWebサーバの権限で実行できる必要があります)。

また、何らかの理由で既定のCGIディレクトリやアイコンディレクトリ以外にファイルを置く場合は、httpd.confを修正してコピー先がApacheから認識されるようにしておいてください。

2. Apacheのログ方式の確認

AWStats自体は柔軟にさまざまな形のログ形式に対応することができますが、基本的に想定しているのはApacheのCombined形式のログです。詳細な説明は省きますが、httpd.confの中のログ形式の部分の設定が次のようになっていればOKです。

#
# The following directives define some format nicknames for use with
# a CustomLog directive (see below).
#
LogFormat “%h %l %u %t “%r” %>s %b “%{Referer}i” “%{User-Agent}i”” combined
LogFormat “%h %l %u %t “%r” %>s %b” common
LogFormat “%{Referer}i -> %U” referer
LogFormat “%{User-agent}i” agent

(中略)

#
# For a single logfile with access, agent, and referer information
# (Combined Logfile Format), use the following directive:
#
# CustomLog logs/access_log combined env=!no_log
CustomLog logs/access_log combined

赤字の部分がポイントです。ここがコメントアウトされているようであれば、そのコメントを外し、同時にコメントアウトされていない”CustomLog”の行をコメントにします。もし修正したら、Apacheを再起動してログ出力形式が変わったことを確認しておきましょう。

3. AWStatsの設定ファイルの準備

1. の手順に従っていれば、/var/www/cgi-bin/AWStats70/awstats.model_jp.confというファイルがあるはずですので、このファイルをawstats.(あなたのホスト名).confという名前でコピーします。ちなみに管理人のサイトでは、”awstats.starplatinum.conf”という名前になっています。このファイルを編集して、AWStatsの設定を行います。

設定内容は設定ファイルのコメントを読めばすべてわかるはずですので、頑張ってみてください。膨大な設定項目がありますが、必須項目はメインセットアップセクション(設定ファイルの一番上の部分)部分のみなので、まずはそこだけ編集して動作確認を行い、詳細なカスタマイズ(オプショナルセットアップセクション)は正常動作確認後に実施すればいいでしょう。

日本語特有の設定

完全日本語版では、ログファイルをAWStatsに渡す前に、 utf8_decode.plというスクリプトを経由させます。このスクリプトで、GoogleやYahooのキャッシュ経由のアクセスログの整形や、検索語のデコードを行います。この部分はオリジナルのAWStatsには存在していない部分であるため、別個に作業を行う必要があります。

1. Jcode.pmのインストール

URLをデコードするために必要となるJcode.pmをインストールします。
インストール方法についてはここでは紹介しませんので、こちらなどを参照してインストールしてください。

2. 必要なファイルのコピー

配布ファイルの/wwwroot/cgi-bin/utf8_decode.plが/var/www/cgi-bin/AWStats70/にあることを確認します。

3. utf8_decode.plの修正

1行目のPerlへのパスと$Myhostとを、実際の環境に合わせて修正します。

4. テスト用ログファイルの用意

AWStats完全日本語版では、utf8_decode.plで変換したログファイルを入力ファイルとして利用します。このため、awstats.plを起動する前に、オリジナルのログファイルをutf8_decode.plを通す必要があります。本番運用ではcronで上記の作業を行いますが、ここでは手動でコピーをしてテスト用のログを用意します。以下をコマンドラインから入力して、テスト用のデコード済みアクセスログを用意します。

/var/www/cgi-bin/AWStats70/utf8_decode.pl < /var/log/httpd/access_log > /var/www/cgi-bin/AWStats70/access_log.utf8

utf8_decode.plの場所とaccess_logの場所は、実際の環境に合わせて修正してください。デコード済みアクセスログのaccess_log.utf8のファイル名とパスは、awstats.confの設定に合わせて下さい。

5. awstats.confの設定の確認

ログファイルのパスを、4.で作成したデコード済みアクセスログ(access_log.utf8)を参照するように変更します。

また、awstats.conf中の、”PurgeLogFile”を”0″(処理済ログを切り詰めない)に設定しておくことをお勧めいたします(デフォルトでそうなっているはず)。本番運用では切り詰める方が好ましいので”1″にしますが、テスト中は”0″にしておくと便利です。なぜならば、awstats.plの実行時にエラーが出てもログファイルが削除されないため、正常に動作するまで何度でもそのログファイルを再利用できるからです。

AWStats完全日本語版のテスト

ここからは、再度こちらも参照しながら進めてください(古い文書で申し訳ございません。何しろ翻訳には膨大な手間がかかるもので…)。

1. awstats.plファイルを実行し、更新処理を行う

“awstats.pl -config=(あなたのホスト名) -update”と入力して、AWStatsの更新処理を起動します。”(あなたのホスト名)”は、設定ファイルをコピーする際に利用し た”awstats.(あなたのホスト名).conf”のことです。当サイトの場合であれば、”starplatinum”になるということになります。こうして起動すると、 awstats.(あなたのホスト名).confの設定内容にしたがって処理が実行されます。

この初回のアクセス解析は、固まっているんじゃないかと思うほど時間が掛かる場合があります。すぐに終わる場合もありますが、処理するログの量によっては数十分掛かることもあります。処理の長さは本当に千差万別で一概には言えませんが、ここはひとつ気長にお待ちください。正常に終了すれば、処理結果が以下のような形で表示されます(注 : ひょっとしたら現在のバージョンでは微妙に異なっているかもしれませんが、類似の出力を得られればOKだと思ってください)。

Lines in file: 225730
Found 5 dropped records,
Found 124 corrupted records,
Found 0 old records,
Found 225601 new records.

上から、ファイルの行数、統計対象外の行数、不正な行数、過去に処理済みの行数、新たに処理した行数になります。この処理はログファイルの解析の実行と、その解析結果のデータベースファイルへの書き出しのみを行います。

2. awstats.plファイルを実行し、レポート作成処理を行う

1. で解析されたデータを視覚的にブラウザから閲覧することができるように、レポートの作成処理を行います。 当サイトで見えているように静的なHTMLとして出力する場合、以下の形でawstats.plを起動します。

perl awstats.pl -config=virtualhostname -output > awstats.virtualhostname.html

他にも、いきなりPerlのCGIとしてブラウザに表示させたり、特定のレポートだけを出力したりもできます。詳細については、こちらを参照ください。

3. 出力されたHTMLファイルをブラウザから閲覧してみる

1.や2.でエラーが出ていなければ基本的に問題はないはずですが、一応ブラウザで正常に表示されることを確認します。

本格運用のための設定

ここまでAWStats完全日本語版を利用するための基本的な設定は終了しました。あと は本格運用の設定をするだけです。実際には、同梱の awstats.cronで定期的に実行するように設定することになります。awstats.cronの処理内容を簡単に紹介しますと、

1. オリジナルのログファイルをutf8_decode.plというフィルタに通してからテンポラリなファイルとしてコピー (デフォルトファイル名:access_log.utf8)。この時点で検索エンジンの引数の日本語化は終了。また、生のAWStatsでは正常に処理されないGoogleのキャッシュからのアクセスも、通常のGoogleからのアクセスと認識されるように整形される。
2. awstats.plが切り詰めるのがaccess_log.utf8になるため、オリジナルのログファイルを切り詰める処理を実行。
3. 統計の更新処理 / 作成処理を走らせる。
4. 念のため出力されたHTMLファイルの権限を、一般ユーザに変更しておく。

こんな感じになります。1.の部分はテスト用ログファイルを用意する際に行った処理と同じ内容です。

また、awstats.cronを実行すると、オリジナルのアクセスログファイルが切り 詰められてしまいますので、正常な動作を確認するまではバックアップを取ったり、設定ファイルの”ArchiveLogRecords”を”1″に設定 (処理済ログのアーカイブファイルを作成する)しておいてください。

このファイルを/etc /cron.hourlyなどに置けば、上記の処理が自動的に1時間おきに行われるようになります。私の場合は1時間に1度なのでcron.hourly ですが、例えば1日に1回でよければcron.dailyに置きます。しかし、可能であればその前に設定ファイルの”PurgeLogFile”を”1″ に変更して下さい。この設定にすると、AWStatsが毎回処理終了後にデコード後のアクセスログファイルを切り詰めてくれるので、処理速度が向上しま す。

実際にcronとして実行させる前に、コマンドラインからawstats.cronを実行してみて、正常に動作しているのを確認するようにしてください。なお、このファイルの内容は当サイトで利用している内容そのものになりますので、パスなどについてはご利用の環境に合わせて変更してご利用ください。

最後に

本手順で、Linuxに不慣れな方でもなんとかAWStatsを利用するところまでこぎつけることができると信じていますが、”ここがわかりにくい”とか、”ここはおかしい”というところがあれば、下のコメントフォームから投稿してくださいますよう、お願いいたします。