Readme for analog3.90beta2

よく聞かれる質問

1. 始めに
2. 基本的環境設定
3. 出力結果の理解
4. 進んだ使い方
5. フォームインタフェース
6. プログラム設計の考え方

A. 始めに

1. analog は setup.exe を持っていない。
   持っていません。そのファイルは必要ありません。ファイルはそれ自身で動 作します。Windows 上での analog の 使い方 を見てください。
2. analog は DOS のウィンドウを一瞬開いて終了してしまいます。
   これは正しい振る舞いです。analog は Report.html という ファイルを作成したはずです。 Windows 上で の analog の使い方 を見てください。
3. analog をコンパイルしようとすると、エラーメッセージをはく。（例えば、 SunOS 5）。
   多分 Makefile を編集する必要があります。 他のプラットホーム上での analog の使い方 の章と Makefile 自身に幾つかのプラットフォームに依存した注意が書かれて います。
4. analog は動作しているときに、ログファイルに書き込んでくれません。
   analog はログファイルには書き込みません。あなたの Web サーバが ログファイルに書き込みをし、analog はそれらを読むだけです。 analog を使うにあたって を見て下さい。
5. analog は、存在しない /usr/local/etc/httpd/analog/analog.cfg のようなファイルを探しにいきます。
   これらのファイルの位置をコンパイルする前に、 anlghead.h に 設定しなければなりません。
6. analog は IIS で生成された、拡張されたログファイルを読みません。
   このサーバは、全ての行ではなく、ログファイルの一番上にだけ日付を 書き、ログを取っている間に日付が変わっても新しい日付を書きません。そのため analog は記録中の最後の記入がいつ生じたのか判断できません。更なる詳細と どうすべきかは、 ログファイルの選択 の章を見てください。
7. エラーメッセージは何を意味するのですか。
   エラーと注意 についての章を 見てください。
8. 私のブラウザーから analog を走らせようとしたが、うまくいかな かった。
   analog は CGI プログラムとして走らせるべきではありません。CGI プログラムのディレクトリに入れてもいけません。代わりに特別な CGI プログラム を使うべきです。
9. analog は2000年対応のプログラムですか。
   はいそうです（以前のバージョンもそうです）。analog は西暦の下２桁 表現を 1970 〜 2069 の間であると解釈します。

B. 基本的環境設定

1. 幾つかの異なる統計ページを作成したい。このとき analog のコピーを幾つか インストールしなければならないのでしょうか。
   いいえ。１個だけインストールし、異なる 環境設定ファイル で走らせてください。
2. 私の analog.cfg は多くの CONFIGFILE コマンドを を含んでいるが、１個のレポートしか生成されない。
   analog は一回の動作で１個のレポートを生成することができます。幾つかの レポートを生成するためには、何回も analog を走らせなければなりません。
3. 毎日のレポートはなぜ最近の６週間の記録しか示さないのでしょうか。
   これはFULLDAYROWS コマンド で制御されます。
4. 時間レポートはなぜ全て０リクエストになるのでしょうか。
   それらはページに対して０リクエストだけするようになっているのでしょう。 PAGEINCLUDE を使って、 ファイルをページとして計算するようにさせる必要があるでしょう。
5. どうしたら、私のサイトからのアクセスを無視するようにできるでしょう か。
   HOSTEXCLUDE コマンドを使いなさ い。
6. どうしたら、全ての人ではなく私だけのホームページの情報を得られるで しょうか。
   FILEINCLUDE コマンドを使いなさ い。
7. "DIREXCLUDE /mydir/" コマンドを使ったが、 そのディレクトリのファイルは依然として一覧に出てくる。
   DIREXCLUDE は、ディレクトリレポートにだけ影響を及ぼすが 他のレポートには関係が無い。代わりに、 "FILEEXCLUDE /mydir/*" を使いなさい。
8. "FILEEXCLUDE /cgi-bin/script.pl" コマンド を使ったが、そのファイルは依然としてリクエストレポートに現れます。
   そのファイルがもし検索引数を持っているなら、FILEEXCLUDE コマンドを使うにはちょっとした注意が必要です。これについては、 検索引数 についての章に説明があります。
9. ２０個以下のリクエストのファイルも、リクエストレポートの一覧に載せたい ときには、どうしたらよいでしょう。
   REQFLOOR コマンドを使いな さい。
10. なぜ私のブラウザーとレファラーレポートは空欄なのでしょう。
    多分あなたのログファイルは、ブラウザーとレファラーについて何の情報も 含んでいないのでしょう。
11. なぜレファラーレポートは適切に並べ替えられないのでしょう。
    適切に並べ替えられています。しかし 検索引数 もファイルの右側についてきて、これが順番を狂わせているのです。もし REFARGSFLOOR を大きく 設定するなら、検索引数が見えなくなるでしょう。または、 N column を含めることに よって順番をより明白にすることができるでしょう。
12. なぜ REQCOLS あるいは REQSORTBY に P を使えないのでしょう。
    リクエストレポート中ではページリクエスト数は意味を持ちません。 なぜなら、それは（もしファイルがページなら）リクエスト数と同じになるし、 （もしそうでなければ）０になるからです。このレポートでページだけを 一覧にしたいなら、代わりにREQINCLUDE pages を使いなさい。
13. レファラーレポートにその検索引数をレファラーと一緒に一覧させたい （あるいはさせたくない）。
    検索引数を見られるようにするためには、 REFARGSFLOOR の値を小さ くし、現れないようにするためには、REFARGSFLOOR の値を大きくす るか、あるいは REFARGSEXCLUDE コマンドを 使って全てのファイルを無視するか特別のファイルだけを無視するかすればよい。
14. 各レファラーがどのファイルを指しているかを知りたい。
    または 各ホストがどのファイルを読んだか知りたい。
    または 毎日私のサイトを見にくるホスト数を知りたい。
    または 同じような多くの質問がある。
    これと同様の質問がたくさんあります。それらはすべて、analog に２種類の 項目を相互参照させたい場合です（例えば、最初の例ではファイルとレファラー ですし、最後の例ではホストと日付です）。当然これらは役に立ちます。しかし analog が個別に各項目のみの統計を取り、その後にそれらの相互参照をするため の十分な情報を記録しないことは、analog のスピードと最小のメモリを使用する という要求にとっては、根本的なことです。
    解決方法は、（例えば） REFINCLUDE コマンドを使ってある レファラーからのリクエストにのみ解析を限定するか、 FROM と TO を 使って特別な時間にのみ解析を限定するやり方がある。これでしばしば充分な 結果が得られる。
15. ２個のログファイルが完全に異なるリクエストを含んでいるにもかかわらず、 "logfiles overlap" （ログファイルの重複）というメッセ ージが出てくる。
    このメッセージは、中身ではなくファイルの時刻にのみ基づいて出力される。 もしあなたが確実に問題はないと判断できるなら、 WARNINGS -L コマンドでメッセージを 抑えることができる。
16. 私のサイトに対する個々の訪問者や訪問に関するデータを得られるだろう か。
    いいえ、技術的に不可能であり、それができるというプログラムを信じては いけません。詳細については、 Web の動作 の章を参照してください。
17. 出力結果の背景色を変えられますか。
    はい、できます。正確に行う方法は、スタイルシートを書いて、 STYLESHEET コマンドを 使ってください。

C. 出力結果の理解

1. データからどうやってヒット数を出せるのでしょう。
   私は、ヒット という言葉を使いたくない。なぜなら、人は様々な 意味でこの言葉を用い、従って取り違いやすいからである。私は、 リクエスト を各種のファイル（テキスト、グラフ、等）の転送数に対し て、また HTML ページの転送数に対しては ページリクエスト を使って いる。より詳しくは、analog の定義 の章を参照してください。
2. 私自身のサイトから、なぜ多くのレファラーがあるのでしょう。
   それらは、あなたのサイトの全ての内部リンクから、またあなたのページの 全てのグラフから来ています。より詳しくは、 Web の動作 の章を参照してくださ い。それらを見たくない場合には、 REFREPEXCLUDE を 使って除外することができます。
3. なぜ analog は私のホームページのカウンターの数と一致しない結果を出すの でしょう。
   沢山の理由が考えられます。それらは両方とも同じ日に動きましたか。 あなたは analog を使って、あなたの全てのページとグラフではなく、その１ ページだけに対するリクエストを見ていましたか。analog はそのページに対する 全てのリクエストを記録します。もし、そのページがグラフなら、あなたの カウンターはグラフを閲覧できるブラウザーからのそのページに対する リクエストだけを勘定するでしょう。
4. ドメインレポートで、なぜ私は "未解決アドレス" のメッセージだけを得るの でしょう。
   あなたのホストは、アクセスするホストの名前ではなく IP アドレスだけを 記録します。DNS 参照 の章を読んで 下さい。または、あなたのサーバの DNS 解決が働くようにしてください。
5. なぜ私の CGI スクリプトはリクエストレポートに載らないのでしょう。
   もしそれらが他のページへのリダイレクションを引き起こすなら、それらは リクエストレポートではなく、リダイレクションレポートに載ります。
6. なぜリクエストレポートにディレクトリが載っているのでしょう。
   それらはディレクトリではなく、ディレクトリと同じ名前をもったページ です。例えば、私は /analog/ というディレクトリと /analog/ というページ（これは /analog/index.html とたまたま同じです）を持っています。
7. 誰かが私の pdf ファイルを読むと、沢山のヒットとして勘定されます。
   PDF ファイルはしばしばダウンロードされ、一度に１ページずつ読まれます。 この各ページが別々のリクエストとして勘定されます。これは理想的ではないの ですが、どう対処したら良いのかは分かりません。analog は一回のダウンロード が何ページに相当しているのか分かりません。通常のように、サーバに対して リクエストが何回あったかのみを信頼して報告します。後でユーザがそのファイル をどうしたかなど推測はしません。

D. 進んだ使い方

1. コマンドラインのオプションでどのようなことができますか。
   コマンドラインでどの環境設定コマンドを設定するときにも、 +C オプションを使ってみなさい。
2. コマンドラインの全てのオプションを教えてください。
   索引に一覧があります。
3. analog は FTP のログを読めますか。
   はいできます。もしあなたが xferlog 書式を使っていれば、 examples のディレクトリに助けとなる設定ファイルがあります。さも なければ、自分の LOGFORMAT を書かなければなりません。 （多分あなたは、ファイル転送の行以外は読めないでしょう。）
4. どうしたら analog を自動的に毎日動かせますか。
   この質問はあなたのコンピュータに依存しています。Unix では、analog を cron のジョブ（"man cron" を見よ）として動かします。以下は私の 毎日 1:50am に動かしている cron 命令です。
   50 1 * * * $HOME/bin/analog
   Windows NT 上では、at コマンドを用いて同じ事ができますが、 administrator だけが実行できます。Windows 98 では、私はまだ試していませ んが、タスク スケジューラでできるはずです。Windows 95 では、私の知る限り できません。
   Mac では、 Cron または CronoTask と呼ばれるプログラムが同じ事をやってくれます。
5. IIS を使っていますが、どのログファイルの書式を使ったらよいでしょう。
   W3C の書式が多分最善でしょう。この書式では各項目のオンとオフができ、 記録できる全ての項目を含んでいますが、他の書式ではできません。しかし、 日付の項目をオンにする（初期設定では、オフになっています）ことは、単に 出力の最初に記録するだけでなく、出力自体に必要不可欠なことです。理由は ログファイル書式の問題点の章を参照 してください。
6. 私は多数のバーチャル ドメインを持っています。どのように analog を設定 すべきでしょうか。
   examples（例題） のディレクトリにこの問題を議論したファイ ルがあります。
7. ログファイルに一回だけアクセスして、多重レポートを作成できますか。
   現時点ではできません。将来これをやりたいのですが、とても大変な仕事に なりそうです。
8. analog を使用していてメモリを使い果たしてしまいました。どうすれば良い でしょうか。
   低メモリの対処法の章を見てください。
9. analog は１０分間に 20,000,000 個のリクエストを処理していますが、なぜ 私のコンピュータはひどくのろいのでしょうか。
   または analog は止まってしまったかのようです。
   DNS 参照 をオンにしているなら、動作は遅くなる でしょう。そうでなければ、多分あなたのコンピュータとハードディスクの スピードに依っています。それと、同時に何のプログラムが走っているかにも 依ります。PROGRESSFREQ コマンドを使えば、実際に止まっているのか、単に遅いだけなのかを判断でき ます。メモリを使い果たしているのなら、 LOWMEM コマンドが役に立つでしょう。
10. analog が動作しているページにどうやったらリンクを張れるでしょうか。
    anlgform プログラムに希望のオプションを付けて リンクを張りなさい。あなたのサーバの負荷にも注意してください。
11. 私の古いログファイルを全て保存しておかなければいけませんか。
    または analog は、ログファイル全体を読み直す代わりに、 古いレポートから統計を取ることができますか。
    これらの質問は、 キャッシュファイル の章で答えられています。

E. フォームインターフェース

1. 私のブラウザーは、動作しない anlgform.pl のプログラムそのものを表示し てしまいます。
   通常のファイルではないので、あなたのサーバに CGI プログラム を実行する設定をしてあげなければなりません。そのファイルを 特別な /cgi-bin/ ディレクトリに収めてあげることによって、 しばしば実行可能になります。
2. なぜフォームインターフェースは、"Document Returned no Data" （"ドキュメントはデータを含んでいません"）というメッセージを出力するので すか。
   メッセージを出力するまでしばらく時間が掛かるのなら、analog が動作を 終了する前に、サーバが多分終了してしまうのでしょう。サーバの一時中断時間 を増やしなさい。
3. フォームインタフェースから analog を走らせると画像が表示されませ ん。
   多分 IMAGEDIR を設定 する必要があります。画像ファイルが /cgi-bin/ にあるのなら、 サーバは通常それらを表示しようとしないで、実行しようとするでしょう。
4. フォームインターフェースからどうやって異なるログファイルを指定できるの しょうか。
   name=LOGFILE という新しい項目をフォームに増やしてください。
5. なぜフォームからリクエストしていない幾つかのレポートが得られるので
   もしレポートがフォームに含まれもせず、除外もされていないなら、システ ムの初期設定が使われたのでしょう。これは、あなたの設定ファイルとコンパイル 時の設定に依存しています。

F. プログラム設計の考え方

1. なぜ HEADERFILE は出力ファイル中の <head> 全体を置き換えないのですか。
   なぜならそのようにしたら、ほとんどと言ってよいほど、正しい HTML 出力 が得られないからです。代わりに スタイルシート を使いなさい。
2. なぜ HTML テーブルを使わないのですか。
   大部分の画像を使用しないブラウザーはテーブルについてはうまく動作しま せん。また HTML 2.0 ではテーブルは使用できません。このバージョンは analog が使用しているものです。
3. なぜあなたはまだ HTML 2.0 を使っているのですか。
   残念なことに、私の バーチャートは HTML 4.0 では動作しません。
4. なぜ、実際にホストレポートで使用しているホストの DNS 参照を行わないの ですか。
   一つ理論的な、またもう一つは実際的な問題があります。理論的には、DNS 参照が行われたときに、どのホストがホストレポートで DNS 参照を利用したかは 換わりうるという問題があります。そして実際問題として、これを利用したとして 実際のあなたが知りたい、どの国あるいはどの組織が最も忙しいかを知るのに 役に立ちません。しかし、 役立つソフト の章に、これを実行してくれ るパールのスクリプトがあります。
5. スレッドを使えば DNS 参照をもっと早くできませんか。
   問題は、DNS 参照に使われる標準のコマンドが多くのプラットフォームで スレッドの使用に対して安全ではなく、そのためプラットフォームに依存した多 くのコードが含まれてしまうことです。しかし、上と同様に 役立つソフト の章にプラットフォーム固有の プログラムがあります。
6. なぜ analog は error_log を解析しないのですか。
   これについては、 何が新しいか の章に詳細に答えられています。しかし一言で言えば、エラーログは各サーバに よって異なる書式を持っているために、解析は非常に難しい。種々の不成功 レポートは大部分の目的には充分だと思われます。
7. 私のサーバはログファイルにローカルな名前を出力します。それらに対して、 共通の接尾辞を付けられますか。
   これは初期設定としては良い考えとは言えません。なぜなら、 "unknown" のようなものに対しても接尾辞が付きます。 HOSTALIAS を使えば、いつ でも接尾辞を付けることができます。正規表現が使える OS では、 エイリアスについての章 に、これを実 行してくれる例があります。
8. 今月の１部のデータの伸び率を基にして、１月分のデータを予想できます か。
   いいえできません。特に月初めに近いときには敏感な項目を予想しようとす る試みには問題が多すぎます。１週間のうちの異なる曜日、１日のうちの異なる 時間帯は問題が多すぎます。私は、疑わしい予測値よりも、生の正確なデータを 出力するほうを選びます。
9. ドメインレポートを拡張して、アメリカのどの州の人が訪問したかを言え ますか。
   いいえできません。ある種のプログラムはできるように言いますが、ユーザが 使用しているコンピュータがどこにあるかを告げるることはできます。 しかしこれは、どの ISP あるいは他の大きな組織に対してユーザが実際に使用 している場所とは、まったく異なることです。
10. なぜ各言語ファイルの名称に、国別コードの代わりに言語コードを用いない のか。
    人々は国別コードによりなじんでいます。それに、全ての言語に言語コード があるわけではありません。
11. なぜ analog を販売しないのですか。
    私は analog をお金のために書いたのではありません。人が analog を使う のを見るだけで幸せです。また、これをオープンソースにすることで、多くの人 が、将来のバージョンのためにアイデアやコードを送ってくれます。私があの 多くの言語ファイルを得たことをどう思いますか。（もちろん、あなたが望むな らお金や、親切心からの贈り物や、単にはがきでも...）

[ 先頭 | 上へ | 前へ | 次へ | 目次 | 索引 ]