第13回　Apacheのログを活用しよう

• アクセスログ
  通常、「ログ」といえばこのアクセスログを意味する。アクセスログは、Webブラウザがサーバ（Apache）に何かをリクエストし、それにApacheが応えるごとに記録される。簡単にいえば、だれかが何かにアクセスするたびに、その結果が記録されるのだ。
  　詳しくは後述するが、このログに「何を記録するのか」「どのファイルに記録するのか」といったことは、管理者が自由に定義できる。細かな設定を可能としていることは、ログを活用しようと思う管理者にとって大きなメリットである。
  
  
• エラーログ
  　エラーログは、リクエストの結果がエラーになったものだけが記録される。また、アクセスログと違い、エラーログは設定の自由度が低い。設定できるのは、記録するエラーのレベルくらいである。
  　このログを見ると、設定やリンクの間違いなどに気付くこともある。しかし、それは別な手段でチェックした方がいい。エラーログは、サーバに問題が起きていないことを確認するために使う。
  
  
• CGIエラーログ
  　このログには、CGIスクリプトが発行するエラーだけが記録される。このログは、Apacheの設定ファイルであるhttpd.confに対し、ScriptLogディレクティブを使って設定しなければ作成されない。通常の運用時にこのログを記録することは少なく、CGIスクリプトの開発環境においてのみ記録させることが多い。
  　間違い（バグ）を含んだCGIスクリプトを作成し、Webブラウザでアクセスすればこのログを作成することができる。その内容を見ると分かるが、サーバ上（端末やエミュレータ）で実行したときに出力されるエラーメッセージとまったく同一のものが記録されるだけである。Webブラウザでテストしたときに、どうしてもうまくいかない場合には、こうしたログが役に立つというレベルのものだ。
  
  
• クッキーログ
  　クッキーログは、ユーザーの行動追跡に使われる。このログは、「mod_usertrack」と（注）いうモジュールを必要とするため、あらかじめApacheにモジュールを組み込んでおかなければ記録できない。
  
  

  注：以前は「mod_cookie」を使っていたのだが、Apache 1.2から「mod_usertrack」に変更された。

  
  　モジュールが組み込まれていて、その機能が有効化されている場合、ApacheはリクエストしたWebブラウザに対して、自動的にクッキー（cookie）を発行する。後で詳しく紹介するが、ここで発行されたクッキーを記録することで、利用者がどういった経路でサイト内を移動したかを分析できる。主に、商業サイトなどでユーザーの行動を分析し、サイトの構造を評価する目的で利用されることが多い。

　まず、クッキーを使ったトラッキングの仕組みを簡単に解説しておこう。クッキーログが有効になっていると、Webサーバはアクセスされた際に自分が発行したクッキーをWebブラウザが持っているかどうかを調べる。Webブラウザが要求されたクッキーを持っていれば、要求にこたえて「クッキー値」と呼ばれる値を返信する。持っていなければ、サーバが新規にクッキーを発行し、Webブラウザに記憶させる。

　このクッキー値をアクセスのたびに要求することで、そのユーザーが過去にアクセスしてきたユーザーか否か、新規でないならだれなのかを識別できる。「識別できる」といっても、あくまでもクッキーの値が同じならば同じユーザーであろうという程度にすぎない。重要なことは、クッキーの値とアクセスしたページ、その時間などを記録しておくことにある。こうした情報が記録されていれば、クッキーの値で特定のユーザーを抽出でき、特定のユーザーの足跡をたどることができるわけだ。

　クッキーログの活用法やより高度な記録の方法については、本稿の意図するところではないから、これ以上詳しくは解説しない。興味があれば、そうした分析の専門企業もあるので調べてみるといいだろう。ここでは、発行したクッキーをWebブラウザから受け取り、足取りを記録する方法を紹介する。

■クッキーログの設定

　クッキーログの設定自体は決して難しくない。「CookieTracking」ディレクティブでクッキーを発行する機能を有効にし、「CookieExpires」ディレクティブによってクッキーの有効期限を決める。後は、ユーザーに送られたクッキーをサーバ側に記録するためのログファイルと書式を設定するだけだ。

　CookieTrackingディレクティブの設定は簡単で、

のように、指定すべきは「on」（有効）と「off」（無効）だけである。これとペアで用いるのが前述のCookieExpiresディレクティブで、

のように、数字と単位（years、months、weeks、days、hours、minutes、seconds）をダブルクオーテーションで囲んで指定する。このディレクティブで有効期限を指定しなかった場合、クッキーの有効期限はユーザーがWebブラウザを終了させるまでとなる。

　ちなみに、クッキーの発行はバーチャルホストや仮想ディレクトリの単位でも行える。サイト全体ではなく、ある一部分だけ追跡したい場合、こうした細かい単位での設定が有効になるだろう。その場合は、バーチャルホストや仮想ディレクトリのディレクティブ「<Directory>〜</Directory>」の中で、「CookieTracking on」を指定すればよい。

■ログを使った追跡

　Webブラウザに記憶させたクッキーを取得してファイルに記録する設定は、実のところアクセスログと共通の方法を用いる。正確には、「カスタムログ」と呼ばれる方法によって実現する。カスタムログとは、ログに記録する書式を設定し、その書式をどのファイルに出力するかを指定する方法を指す。

　カスタムログの書式やファイルの設定については次に譲るとして、ここではクッキーに的を絞って紹介する。リスト1およびリスト2は、実際にクッキーを使ってログを出力した例である。見てのとおり、ログを出力する方法は2つある。

　いずれにしても、書式として%{cookie}とすることに変わりはなく、その後に続く文字によって出力が変化する。また、見てのとおりクッキーだけを記録しても何の役にも立たない。「%{cookie}」で記録されるのは、クッキーを返してきたクライアントのIPアドレスとそのクッキー値だけだからだ。実際には、さらに書式を追加して必要な情報を得られるようにしなければならない。

　書式の設定は、必要とする情報の種類によるので一概にはいえないが、2つほど具体例を紹介しよう。

とした場合のログがリスト3だ。

　前述の%{cookie}iに、アクセスしたファイル「%U」とその前にアクセスしていたファイル「%{Referer}i」を付加している。「->」はログを見やすくするためのもので、特別な意味があるわけではない。

　さらに、時間「%t」を加えて、

とすると、リスト4のようなログになる。

　このように、クッキー値とともに付加情報を記録することで、特定のユーザー（Webブラウザ）がどのようにサイト内を移動したのかを追跡できる。

　皆さんも、実際にいろいろ設定を変えてみて、どのようなログが記録されるのか試してみるといいだろう。そのとき重宝するのが「tail」コマンドだ。このコマンドは、もともとファイルの末尾20行程度を見るために用いられるのだが、「-f」オプションを与えるとファイルに書き込まれる内容をリアルタイムに監視できる。例えば、

とするとcookie_logに書き込まれる内容を監視し、書き込まれた内容を画面に表示してくれる。

　httpd.confの設定を変えたら、エディタを終了せずに保存し、別のウィンドウを使ってApacheをgracefulで再起動する。そして、もう1つのウィンドウでログを監視しながらWebブラウザでいろいろアクセスしてみると、リアルタイムに書き込まれる内容が分かるというわけだ。古くからUNIXやLinuxに触れている方にとっては当たり前の手法かもしれないが、もしご存じでなかったなら一度試してみていただきたい。応用すれば、いろいろな場面で役に立つだろう。

アクセスログ

　クッキー値などが記録できることは理解していただけたと思うが、その設定方法についてはいま一つピンとこないことだろう。ここまでで紹介したのは、エラーログの記録先を決める「ErrorLog」とレベルを決める「LogLevel」、CGIエラーログの記録先を決める「ScriptLog」。そして、クッキーによる追跡を有効にする「CookieTracking」とクッキーの有効期限を設定する「CookieExpires」だった。

　ここから紹介するのは、クッキー値や時間といったさまざまな情報について、どのように記録するかの設定だ。それには、ログの書式を設定し、その書式で記録するログファイルを設定する。それぞれ、「LogFormat」ディレクティブと「CustomLog」ディレクティブで実現する。

■アクセスログの設定

　LogFormatとCustomLogディレクティブは、いずれも簡単に設定できる。

　LogFormatディレクティブは、記録する書式と、その書式の名前を設定する。例えば、

とすれば、書式の名前が「time」で、記録するのはアクセス時刻「%t」となる。

　続いて、CustomLogディレクティブを使ってこの書式のログを記録するファイルを指定する。

とすれば、書式名「time」のログを「time_log」というファイル名で記録すると設定したことになる。このようにすることで、自分の使いやすい書式のログをいくつでも記録できるわけだ。

　設定自体は簡単なのだが、書式に指定できる内容が分からなければ話にならない。これについては、まず表2を参照していただこう。Apacheがサポートするログの書式パラメータである。

　これらの書式パラメータを組み合わせ、ダブルクオーテーションで囲んで指定すれば、望みどおりの書式でログを記録できる。とはいえ、表2に示されたもののうち、どれを記録するのが有益かは分かりづらい。それどころか、「Foobar」のように表現したものは、そこに「Referer」や「Cookie」などの名称を指定しなくては使えない。

　これでは、HTTPの仕様に詳しくなければどうしていいものやら困り果ててしまうだろう。ありがたいことに、必要そうな書式はあらかじめApacheの開発者側で設定してくれているのだ。これらはhttpd.confの中に用意されているから、探せばすぐに見つかるだろう。念のためにリスト5にも示しておいた。

　「\」は「"」をログに記録するためのエスケープ文字。また、「%>s」のように「>」を間に入れると、内部的にリダイレクトされても最終的な結果を出力する指定になる。

　デフォルトのアクセスログ（/usr/local/apache/logs/access_log）では、リスト5の「common」を採用している。commonによって記録されたログの例がリスト6（一部分を抜粋）だ。このログでも、アクセス時間とアクセス先、どこからのアクセスかといったことは理解できる。

　それでも足りないなら「combined」を選択してもよい。combinedは、commonで定義された情報に加えて1つ前にアクセスしていた場所（Referer）とクライアントが使っているWebブラウザ（Agent）も記録する。

　必要であればこれ以上の情報を得ることもできるのだが、ログとしての必要性を考えると、これ以上のカスタマイズが必要なのはまれであろう。情報量を増やすためのカスタマイズよりも、ログの見やすさを追求したり、本当に必要なものだけに絞る方が有益だと思う。リスト5にも示したとおり、「->」を入れると情報を理解しやすくなる。

■アクセスログの条件設定

　ログの出力設定についてはほぼマスターしたことになるのだが、もう1つだけマスターしていただきたいことがある。記録するログに条件を付けて、限られたアクセスだけを出力する方法である。これには、CustomLogディレクティブに第3の引数として環境変数とその値を指定する。これを使うと、ある特定の種類のファイル（PDFなど）へのアクセスだけを記録したり、不正と思われる種類のリクエストだけを別なログに記録できるようになる。例えば、

と指定した場合を考えてみよう。これは、pdf_logというファイルに書式commonで記録するが、記録するのは環境変数「pdf-files」が設定されている場合だけ、という意味になる。では、「環境変数pdf-filesが設定されている場合」とはどういう意味だろうか？

　これには「mod_setenvif」というモジュールが関係し、「SetEnvIf」ディレクティブを使う必要がある。mod_setenvifはApacheに標準で組み込まれるモジュールだから、基本的にはすでに用意されているはずである。このモジュールは、リクエストを条件に従って判定し、条件に一致すると環境変数を設定する役割を果たす。例えば、

と指定すると、リクエストのURIに拡張子pdfが含まれている場合に環境変数pdf-filesを設定する。これを指定することで、PDFへのアクセス時にはpdf-filesという環境変数が設定されることになり、PDFへのアクセスだけを記録するログが実現できるというわけである。

　この手法はこれ以外にも当然応用可能で、クラッカーが不正アクセス目的で指定するURIを抽出することなども考えられる。また、SetEnvIfはURIだけでなくMethod（POSTかGET）やIPアドレスを判定することもできるから、POSTとGETで区別したり社内・社外のアクセスを区別することもできるだろう。

　社内と社外を区別するなら、

として社内のアクセスを記録する。逆に、社外を記録するなら、

のように「!=」を使って、「それ以外」（この場合はinternal以外）と指定すると便利だ。

次回はログの分析や管理

　「たかがログ」といっても、その設定の応用は奥が深い。本当は、ログの分析やローテーションについても紹介したかったのだが、筆者の悪癖が出て書き切れなくなってしまった。次回はログ管理の続きとして、出力されたアクセスログの分析やログのローテーション管理について紹介しようと思う。

Appendix