9.17 gauche.logger - ユーザレベルのロギング

Module: gauche.logger ¶

プログラムからログを書き出す簡単なインタフェースを提供します。 情報は指定されたファイルへ書き出されるか、もしくはsyslog(3)を 使ってシステムログへと送られます。 ファイルに書き出される場合は、 syslogに似たプレフィクスが各メッセージの前に追加されます。 プレフィクスはカスタマイズすることもできます。 また、ログファイルの排他制御も行われます (下のlock-policyの説明を 参照して下さい)。

Class: <log-drain> ¶

{gauche.logger} ログメッセージの行き先を表現するオブジェクトです。 デフォルトのログの行き先として、グローバルな<log-drain>のインスタンスが ひとつ作られます。 ログをいくつかにわけて出力する場合などはmakeメソッドを使って いくつでも<log-drain>のインスタンスを作ることができます。

Instance Variable of <log-drain>: path ¶

ログの出力先を指定します。以下の値をとることができます。

文字列

ログファイルのパスを指定します。出力はそのファイルへと書き出されます。

current-error

#t

出力は現在のエラーポートに向かいます。

current-output

出力は現在の出力ポートに向かいます。

syslog

出力はシステムログへと送られます。

ignore

log-formatが何もしないようにします。

#f

出力は文字列になってlog-formatからの戻り値となります。

このスロットの初期値は#fです。

Instance Variable of <log-drain>: prefix ¶

各メッセージの前に追加されるプレフィクス文字列を指定します。 メッセージが複数行に渡る場合、プレフィクスは各行の頭に追加されます。 またこのスロットには手続きをセットすることもできます。 その場合、プレフィクス文字列が必要とされる度にその手続きが<log-drain> を引数として呼び出され、戻り値の文字列がプレフィクスとして使われます。

pathスロットの値がシンボルsyslogの場合は、 このスロットの値は無視されます。システムのログ機構が適切なプレフィクスを付けるからです。

prefixスロットの値が文字列の場合、以下に挙げる文字シーケンスは特別な意味を持ち、 log-formatによって置換されます。

~T

現在の時刻を"Mmm DD hh:mm:ss"という形式で表したもの。 ここで"Mmm" は英語の月名の省略形、"DD" は日、"hh"、"mm"、 "ss" は時間(24時間制)、分、秒です。 このフォーマットはシステムログと同じです。

~Y

4桁で表した現在の西暦。

~P

プログラム名。初期値は(car (command-line))の値のbasenameが使われます (コマンドライン引数参照)。 下に述べるprogram-nameスロットの値を変えれば ここに現れる文字列を変えることができます。

~$

このプログラムのプロセスID。

~U

このプロセスの実行ユーザ名。

~H

このプロセスが走っているホスト名。

このスロットの初期値は"~T ~P[~$]: "です。例えば "this is a log message.\nline 2\nline 3"というメッセージが 与えられると、次のようなログが書き出されます。

Sep  1 17:30:23 myprogram[441]: this is a log message
Sep  1 17:30:23 myprogram[441]: line 2
Sep  1 17:30:23 myprogram[441]: line 3

Instance Variable of <log-drain>: program-name ¶

プレフィクス文字列の~Pが置換されるプログラム名を指定します。

Instance Variable of <log-drain>: lock-policy ¶

ログファイルのロックの方法を指定します。 このスロットの値がシンボルfcntlだった場合は、 fcntl()によるファイルロックが使われます (gauche.fcntl - 低レベルファイル操作参照)。 このスロットの値がシンボルfileだった場合は、 ログファイルのパス名に ".lock" を追加したロックファイルを作成することによる 排他制御が行われます。この場合、ログを行うプロセスはログファイルの 置かれるディレクトリに書き込み権限が必要です。 また、プロセスがログファイル書き込み中に強制的に終了させられた場合、 ロックファイルが残ってしまう恐れがあります。 Log-formatはロックファイルが十分に古い場合(現在は10分をリミットとしています) ロックファイルを自動的に削除します。 このスロットの値が#fだった場合は、排他制御は行われません。

デフォルトの値はfcntlです。但しMacOSXではfcntlスタイルのロックが サポートされていないため、fileがデフォルト値となります。

ログの行き先がファイルでない場合は排他制御は行われません。

Instance Variable of <log-drain>: syslog-option ¶

Instance Variable of <log-drain>: syslog-facility ¶

Instance Variable of <log-drain>: syslog-priority ¶

これらのスロットの値は、ログの行き先がシステムログの場合にのみ使われます。 これらの値に関する説明はgauche.syslog - Syslogを参照して下さい。 デフォルトの値はそれぞれLOG_PID、LOG_USER、LOG_INFOです。

Function: log-open path :key prefix program-name ¶

{gauche.logger} デフォルトのログの行き先をpathに指定します。 pathは文字列かboolean値あるいはシンボルsyslogで、 上のpathスロットで述べたものと おなじ意味を持ちます。またプレフィクスとプログラム名をキーワード引数で 指定することもできます。 これらのパラメータの意味については上の<log-drain>の項を参照して下さい。

名前に"open"とありますが、この手続きは指定されたファイルをオープンしません。 ファイルはlog-formatが呼ばれるたびにオープンされクローズされます。

Parameter: log-default-drain ¶

{gauche.logger} 引数無しで呼ばれると、log-formatが使う、 現在のデフォルトのログの行き先が返されます。 まだデフォルトのログの行き先がlog-openで指定されていない場合は #fが返ります。

新たな<log-drain>オブジェクトか#fを引数にして呼び出すと、 デフォルトのログの行き先がそれに変更されます。 parameterize (パラメータ) を使えば、一時的にデフォルトの ログの行き先を変更できます。

Method: log-format (format <string>) arg … ¶

Method: log-format (drain <log-drain>) (format <string>) arg … ¶

{gauche.logger} ログメッセージをformat手続きでフォーマットし(出力参照)、 指定された行き先に書き出します。最初の形式ではデフォルトの行き先が使われます。

ファイルはこの手続きが呼ばれるたびにオープンされクローズされます。 したがって、ログファイルに書き出すプログラムが走っている最中でも ログファイルをmoveすることができます。 また、log-formatはsys-fcntl (gauche.fcntl - 低レベルファイル操作参照) を使ってファイルロックを獲得します。

log-openが呼ばれる前にlog-formatが最初の形式で呼ばれた場合、 log-formatは何もしません。したがって、log-formatをデバッグに 活用し、必要なくなったらlog-openだけをコメントアウトする、というような 使用法も可能です。