module Syslog (Ruby 3.4 リファレンスマニュアル)

要約

UNIXのsyslogのラッパーモジュール。 syslog の詳細については syslog(3) を参照してください。

require 'syslog'

Syslog.open("syslogtest")
Syslog.log(Syslog::LOG_WARNING, "the sky is falling in %d seconds!", 100)
Syslog.close
# 書き込まれているか確かめる。
# 但し、実行環境によってログの場所が違う。くわしくはsyslog.confを参照。
File.foreach('/var/log/system.log'){|line|
  line.chomp!
  if /syslogtest/ =~ line
    puts line
  end
}

継承しているメソッド

モジュール関数

emerg(message, *arg) -> self[permalink][rdoc][edit]

alert(message, *arg) -> self

crit(message, *arg) -> self

err(message, *arg) -> self

warning(message, *arg) -> self

notice(message, *arg) -> self

info(message, *arg) -> self

debug(message, *arg) -> self

Syslog#log()のショートカットメソッド。システムによっては定義されていないものもあります。

例えば、Syslog.emerg(message, *arg) は、Syslog.log(Syslog::LOG_EMERG, message, *arg) と同じです。

[PARAM] message:: フォーマット文字列です。Kernel.#sprintf と同じ形式の引数を指定します。
[PARAM] arg:: フォーマットされる引数です。
[EXCEPTION] ArgumentError:: 引数が1つ以上でない場合に発生します。
[EXCEPTION] RuntimeError:: syslog がopen されていない場合発生します。

例:

require 'syslog'
Syslog.open("syslogtest") {|syslog|
  syslog.crit("the sky is falling in %d seconds!",5)
}

close -> nil[permalink][rdoc][edit]

syslogを閉じます。

[EXCEPTION] RuntimeError:: syslog がopen されていない場合発生します。

使用例

require 'syslog'

Syslog.open("syslogtest")
Syslog.log(Syslog::LOG_WARNING, "the sky is falling in %d seconds!", 100)
Syslog.close

ident -> String | nil[permalink][rdoc][edit]

options -> Integer | nil

facility -> Integer | nil

最後のopenで与えられた対応する引数を返します。

使用例

require 'syslog'

Syslog.open("syslogtest")
p Syslog.ident    #=> "syslogtest"
p Syslog.options  #=> 3
p Syslog.facility #=> 8

instance -> self[permalink][rdoc][edit]

selfを返します。(旧版との互換性のため)

log(priority, format, *arg) -> self[permalink][rdoc][edit]

syslogにメッセージを書き込みます。

priority は優先度を示す定数(Syslog::Constants参照)です。また、facility(Syslog::Constants参照)を論理和で指定することで open で指定した facility を切替えることもできます。

format 以降は Kernel.#sprintf と同じ形式の引数を指定します。

但し、syslog(3) のように format に %m は使用できません。

メッセージに改行を含める必要はありません。

[PARAM] priority:: priority は優先度を示す定数を指定します。詳しくは、Syslog::Constantsを参照してください。
[PARAM] format:: フォーマット文字列です。
[PARAM] arg:: フォーマットされる引数です。
[EXCEPTION] ArgumentError:: 引数が２つ以上でない場合に発生します。

例:

require 'syslog'
Syslog.open("syslogtest") {|syslog|
  syslog.log(Syslog::LOG_CRIT, "the sky is falling in %d seconds!", 10)
}

mask -> Integer | nil[permalink][rdoc][edit]

mask=(mask)

ログの優先度のマスクを取得または設定します。マスクは永続的であり、 Syslog.openやSyslog.close ではリセットされません。

[PARAM] mask:: ログの優先度のマスクを設定します。
[EXCEPTION] RuntimeError:: syslog がオープンされていない場合、発生します。

使用例

require 'syslog'
include Syslog::Constants
# ログの場所は実行環境によって異なる。詳しくはsyslog.conf を参照
log = '/var/log/ftp.log'

Syslog.open('ftpd', LOG_PID | LOG_NDELAY, LOG_FTP)
Syslog.mask = Syslog::LOG_UPTO(LOG_ERR)

[ LOG_CRIT, LOG_ERR, LOG_WARNING,
  LOG_NOTICE, LOG_INFO, LOG_DEBUG ].each_with_index { |c, i|
  Syslog.log(c, "test for syslog FTP #{c}, #{i}")
}
Syslog.close
File.foreach(log){|line|
  print line if line =~ /FTP/
}

open(ident=$0, options=Syslog::LOG_PID|Syslog::LOG_CONS, facility=Syslog::LOG_USER) -> self[permalink][rdoc][edit]

open(ident=$0, options=Syslog::LOG_PID|Syslog::LOG_CONS, facility=Syslog::LOG_USER) { |syslog| ... } -> self

与えられた引数でsyslogを開きます。以降、他の Syslog モジュール関数が使用可能となります。

ブロック付きで呼ばれた場合は、self を引数としてブロックを実行し、最後に Syslog.#close を行います。

syslog の詳細については syslog(3) を参照してください。

[PARAM] ident:: すべてのログにつく識別子で、どのプログラムから送られたログなのかを識別するために使われる文字列を指定します。指定しない場合はプログラム名が使われます。
[PARAM] options:: Syslog.open や Syslog.log の動作を制御するフラグを指定します。指定しない場合は、Syslog::LOG_PID|Syslog::LOG_CONSの値が使われます。使用できる値はSyslog::Constants を参照してください。
[PARAM] facility:: ログ出力を行うプログラムの種別を指定します。syslog はこの値にしたがって出力先となるログファイルを決定します。詳しくは、 syslog.conf(5), Syslog::Constants を参照してください。
[EXCEPTION] RuntimeError:: syslogを既に開いていた場合はRuntimeErrorが発生します。
[RETURN]: self を返します。

syslogを既に開いていた場合はRuntimeErrorが発生します。

require 'syslog'

Syslog.open("syslogtest")
Syslog.log(Syslog::LOG_WARNING, "the sky is falling in %d seconds!", 100)
begin
  Syslog.open("syslogtest2")
rescue RuntimeError => err
  puts err #=> "syslog already open"
end

options と facility に指定できる値については Syslog::Constants を参照してください。

指定例:

require 'syslog'
Syslog.open('ftpd', Syslog::LOG_PID | Syslog::LOG_NDELAY,
            Syslog::LOG_FTP)

open!(ident=$0, options=Syslog::LOG_PID|Syslog::LOG_CONS, facility=Syslog::LOG_USER) { |syslog| ... } -> self[permalink][rdoc][edit]

reopen(ident=$0, options=Syslog::LOG_PID|Syslog::LOG_CONS, facility=Syslog::LOG_USER) { |syslog| ... } -> self

開いていた syslog を最初にクローズする点を除いてSyslog.#open と同じです。

[PARAM] ident:: すべてのログにつく識別子で、どのプログラムから送られたログなのかを識別するために使われる文字列を指定します。指定しない場合はプログラム名が使われます。
[PARAM] options:: Syslog.open や Syslog.log の動作を制御するフラグを指定します。指定しない場合は、Syslog::LOG_PID|Syslog::LOG_CONSの値が使われます。使用できる値はSyslog::Constants を参照してください。
[PARAM] facility:: ログ出力を行うプログラムの種別を指定します。syslog はこの値にしたがって出力先となるログファイルを決定します。詳しくは、 syslog.conf(5), Syslog::Constants を参照してください。

使用例

require 'syslog'

Syslog.open("syslogtest")
Syslog.log(Syslog::LOG_WARNING, "the sky is falling in %d seconds!", 100)
begin
  Syslog.open!("syslogtest2")
  Syslog.log(Syslog::LOG_WARNING, "the sky is falling in %d seconds!", 200)
rescue RuntimeError => err
  # RuntimeError は発生しない。
  puts err
end
File.foreach('/var/log/system.log'){|line|
  print line if line =~ /the sky is/
}

[SEE_ALSO] Syslog.#open

opened? -> bool[permalink][rdoc][edit]

syslog をオープンしていれば真を返します。

使用例

require 'syslog'

p Syslog.opened? #=> false
Syslog.open("syslogtest")
Syslog.log(Syslog::LOG_WARNING, "the sky is falling in %d seconds!", 100)
p Syslog.opened? #=> true

要約

目次

継承しているメソッド

モジュール関数