internal package Foswiki::Logger::PlainFile

internal package Foswiki::Logger::PlainFile is a Foswiki::Logger

Plain file implementation of the Foswiki Logger interface. Mostly compatible with TWiki (and Foswiki 1.0.0) log files, except that dates are recorded using ISO format, and include the time, and it dies when a log can't be written (rather than printing a warning).

• debug messages are output to $Foswiki::cfg{Log}{Dir}/debug.log
• info messages are output to $Foswiki::cfg{Log}{Dir}/events.log
• warning, error, critical, alert, emergency messages are output to $Foswiki::cfg{Log}{Dir}/error.log.
• error, critical, alert, and emergency messages are also written to standard error (the webserver log file, usually)

ObjectMethod log($level, @fields)

ObjectMethod eachEventSince($time, \@levels, $version) → $iterator

• $time - a time in the past
• \@levels - log levels to return events for. Individual level or array reference.
• $version - Version 1 of API returns a hash instead of an array.