Readme for analog3.90beta2

エラーと警告

この章は、analogが生成する全てのエラーと警告についての出力を、短い説明と一緒に一覧にして見せます。

始めに、クラッシュ、エラー、警告とデバッグ用メッセージの違いを理解してください。最初にクラッシュは、analogが全出力ファイルを生成しないで、早めに終了してしまうことです。システムはメッセージを出力するかもしれませんが、analogはそれ自身の出力を何らしません。analogはクラッシュしないはずです。もしクラッシュしたなら、私に報告をしてください。

エラーは、analogが仕事を終了するのを妨げる何かのことです。エラーが起きたときには、analogは analog: Fatal error: という言葉で始まるメッセージを出力し、何が起きたかをあなたに告げるでしょう。

警告は、analog にとっては致命的ではない問題のことです。analog は動作しつづけるでしょう。これらは、ファイルが見つからないという危険なものから、単純に報告というものまであります。これらは、analog: Warning という言葉から始まるメッセージを出力します。注意の出力を止めるには、WARNINGS というコマンドを使えばできます。

最後に、デバッグのメッセージはプログラムの状態についての情報を与える。その情報は、１文字とコロンで始まる。デバッグをオンにしない限り、デバッグメッセージは得られない。

モニターの代わりにファイルにこれらのメッセージを保存しようとするなら、ERRFILE というコマンドを用いれば良い。モニターにこれらのメッセージを表示する文字幅を決めるには、ERRLINELENGTH というコマンドを用いれば良い。

さてこれから全ての可能なエラーと警告の詳細を述べよう。

エラー

Ran out of memory: cannot continue: analogはメモリを使い果たしてしまった。もし OS が許すなら、analog が使えるメモリを増やしてみよ。
あるいは、LOWMEM コマンドを使って見よ。
Cannot ignore mandatory configuration file: Readme の義務的な環境設定ファイル（mandatory configuration file）についての章を見よ。
Can't find language file Language file too short Language file contains excessively long lines: analog は正しい書式の言語ファイルを用いないと動作できない。言語ファイルについての記述を見よ。
Attempted to read more than 50 configuration files: これに対する最も可能性の高い説明は、 CONFIGFILE を用いてあなたが偶然無限ループを作ってしまったことです。例えば、環境設定ファイルがまた自分自身を含んでいるという場合です。
Incorrect default given in anlghead.h Default given in anlghead.h too short: あなたがコンパイル時に、anlghead.h のファイルに誤った環境を設定したとき、analog はあなたにそれを直せと告げている。
Failed to open output file for writing: analog はあなたが指定した出力ファイルを作れないか、書き込むことができない。
Cache output file already exists: won't overwrite: analog は古いキャッシュファイルを上書きできない。まずそのファイルを移動させるか、削除しなければならない。
OUTFILE and CACHEOUTFILE are the same
OUTFILE and CACHEOUTFILE both set to stdout: これはあなたが望むことではないはずである。なぜなら、一方のファイルは他方のファイルを上書きしてしまうからである。
OUTPUT NONE and CACHEOUTFILE none selected: 出力をしないことを選択したことになっている。

注意

注意は致命的ではないことを覚えて置いてください。実際いくつかの注意はほとんど問題にならない。注意のメッセージを抑制する (止める) ためには、 WARNINGS というコマンドを使えばよい。注意は幾つかの異なる種類に分類され、注意のメッセージ中の１文字で表される。分類は以下に与えられる。

C: 不正な設定がされた。
D: 疑問のある設定がされた。
E: コマンド ERRFILE が使われた
F: ファイルが無いか壊れている。
L: ログファイルに明らかな問題がある。
M: ログファイルに多分問題がある。
R: 空のレポートの出力を止める。

分類 C

この分野の警告は、不正な設定を意味する。analog はあなたの設定を無視するか、その設定で可能な限りベストを尽くす。この分野の警告を網羅するには、あまりにも数が多すぎる。エラーメッセージを与えたその特別な設定コマンドcommand についての記述を参照すべきである。以前のバージョンの analog で動作したコマンドがエラーを出力した場合には、古いバージョンからの改訂を参照すること。

分類 D

この分野は、意図したとおりに動作せずに設定が疑わしいときの警告である。analog はこの場合、勝手にあなたの設定を無視することはない。

LOGFORMAT with no subsequent logfile: LOGFORMAT コマンドを設定したが、その設定を行うログファイルが見当たらない。多分あなたは、 LOGFILE コマンドの後に LOGFORMAT コマンドを設定したはずである。あなたは、 LOGFILE コマンドの前に LOGFORMAT コマンドを設定するか、代わりに DEFAULTLOGFORMAT コマンドを使いなさい。詳細についてはログの書式指定についての章を参照しなさい。
Offset not a multiple of 30 Offset more than 25 hours: 時刻のオフセットは、時間帯の時差を修正する意味である。この時間差は、通常－２５から＋２５時間の間であり、それは３０分の整数倍である。多分あなたは、オフセットを誤って分の代わりに時間で設定したと思われる。
FROM time is later than the present: 通常これは、どの項目も計数されないことを意味する。analog は、あなたのコンピュータあるいはサーバの時刻が間違っている場合には、修正しようとしません。あなたは、コマンド TIMEOFFSET または LOGTIMEOFFSETを使用して時刻を修正するべきです。
SORTBY doesn't match FLOOR SORTBY doesn't match SUBSORTBY (or FLOOR/SUBFLOOR) SORTBY (or FLOOR or GRAPH) isn't included in COLS: １つのレポート内で、整理（sort）と階層（floor）が両立していることは必要なことであり、それら全ては COLS に含まれるべきである。（時刻と関連の無いレポートについての章を参照せよ。）
Column N with SORTBY ALPHABETICAL/RANDOM: 項目が忙しさの順番に並んでないのに、番号がついているのは多分誤りである。
Time reports have not all got same value of BACK: 通常全ての時刻レポートが同じ時間の向きに動作しているのは見やすい。
Report contains no COLS: １つのレポートに対して空の COLS の一覧が得られた。単に一覧名が並んでいるだけであり、それらについての情報は何も得られていない。
LOWMEM 3 prevents that item being cached: キャッシュファイルが作成されているが、１つの項が、 LOWMEM コマンドのために記録されておらず、従ってキャッシュファイルに保存されない。

分類 E

この分野にはたった１つの警告がある。

Redirecting future diagnostic messages: エラー、警告、デバッグそれに PROGRESSFREQ の診断の出力先を変更するために ERRFILE コマンドが使われている。この警告は、あなたがそれらのメッセージを見過ごさないようにするためのものである。

分類 F

この分野は、開いたり読んだりするのに失敗したファイルを診断するためのものである。これらは深刻なものであるが、大部分のメッセージは読めば分かるはずである。特に以下に挙げる２つのメッセージは説明するに値するものである。

Can't auto-detect format of logfile: LOGFORMAT コマンドは自動認識に設定されているが、ログファイルの最初の行がどの標準書式にもなっていない。このエラーは、あなた自身の設定した LOGFORMAT を LOGFILE コマンドの後ろに置き、そのためそのログファイル中では有効にならない場合にしばしば起きる。
DNS lock file already exists: ２個の analog が同時に DNS ファイルに書き込むのを防ぐために、空の "ロックファイル" が作成され、２番目の analog に DNS WRITE の代わりに、DNS LOOKUP を使うように指示する。もし analog がクラッシュしたとき、ロックファイルが削除されない場合がある。そのためもし他の analog が動作してないにもかかわらず、あなたが "already exists" （"すでに存在する" ）メッセージを受けたなら、あなた自身でそのロックファイルを削除するする必要がある。

分類 L

analog がログファイルを読み込んだとき、そのログファイルに何か誤りがあるかどうかを確認する。

Large number of corrupt lines: これはログファイルか LOGFORMAT の書式に問題があることを示している。その理由として、ログファイルの選択についての章に可能性が述べられている。
Logfiles overlap: possible double counting: 同じ項目を勘定している２個のログファイルにおいて、その項目の時刻が同じである。多分あなたは同一の２個のログファイルを読み込んでいるか、あるいは LOGFORMAT の設定で、 analog が幾つかの項目を無視するように指示するべきであった。あるいは、２個のログファイルは実際異なるものであり、問題はどこにも存在しなかった。 analog はログファイルの時刻を確認するだけで、それらの詳細については確認しない。この最後の場合には、生成された統計は依然として正しい。

分類 M

この分野は、analog が予期しない結果を生成するかもしれないログファイルの書式についての警告である。

Logfile contains lines with no [whatevers], which are being filtered: この注意は通常害は無い。これは多分例を挙げればうまく説明できよう。あなたがあるファイルを解析の対象から除外しているが、どのファイルをブラウザーが読んでいるかではなく、使用されているブラウザーについての情報を含んでいるブラウザー・ログも解析しているとしよう。このとき、除外されているファイルを読んでいるブラウザーを除外することはできない。なぜなら、どのブラウザーが何をしているかは分からず、従って全てのブラウザーが解析に含まれてしまうからである。
Logfile contains lines with no file names (or bytes): page (or byte) counts may be low: もしログファイルがファイル名を含んでいないときには、analog はリクエストはページを要求しているのではないと仮定する。同様に、転送されたバイト数が与えられていない場合には、analog は転送データ量をゼロバイトと仮定する。従って、その行に記述されていない他の項目に依存する、ページのリクエスト数あるいはバイト数は、低く見積もられる。

分類 R

この警告は、analog が空のレポートを止めたときに現れる。どのログファイルにも適切な項目が含まれていないからかもしれないし、 LOWMEM コマンドがそれらの項目の記録を禁止しているからかもしれない。

壊れたパイプ（Broken Pipe）

これは analog が生成した注意ではないが、analog がもはや必要としないと判断して、ログファイルの全部を読まずに閉じていることに、起因していると考えられる。

Stephen Turner
analogについての質問はanalog-helpのメーリングリストを読んでください。

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