AppenderConsole now accept a connection argument. If called from a
{knitr} rendering process, log messages are now output to stderr instead
of stdout by default, to avoid polluting markdown documents (#62, thx @gadenbuie).%k and %K parameters in format.LogEvent now work as expected when using
crayon terminal colours (#52).
Fix default format string for LayoutGlue which was using msg
instead of {msg} (#54, thx @mmuurr)
Update docs to use the more common term "structured logging" instead of "custom fields" where appropriate
as_event_list.data.frame now really returns a list of LogEvents
added as_LogEvent() to coerce various event-like objects to LogEvents
rebuild docs for R 4.2.0
logger_index() returns a data.frame with metadata on all registered
loggers (#47) (thanks @Fuco1)
export new string_repr() generic that is used to layout R objects for
formatted log message output (#48, thanks @mmuurr)
The $log() method of Logger and LoggerGlue now unpacks conditions (except
if they are supplied as a named argument) (#45, thanks @mmuurr)
Fix some timezone related tests for CRAN
Deprecated the create_file argument of AppenderFileRotating*. This
is now hardcoded to TRUE (because FALSE doesn't really make sense here).
default_exception_handler() now throws more informative warnings if an
error is encountered during logging.
drop tests for deprecated future plans to ensure compatibility with upcoming versions of future (#43)
Moved more complex Appenders to package
lgrExtra. This includes database
Appenders, email and push notifications and AppenderDt (in-memory
data.tables).
AppenderFile$show() can now filter log files formatted by LayoutFormat
by log level. Be aware that this just greps through the file and therefore
will return false positives on lines where the log message contains strings
that can be interpreted as log levels.
AppenderFile$show() and AppenderFile$data now dispatches to
Layout$read() and Layout$parse(). This makes it possible to tie
reading/parsing of log files to Layouts.
Loggers gain a list_log() method. See https://github.com/s-fleck/joblog for
an R package that leverages this feature to create custom log event types for
tracking the status of cron jobs.
Export more utility functions that are useful for creating custom Appenders;
such as standardize_threshold() and event_list().
AppenderBuffer now defaults to flush_threshold = NULL
(never flush because of the log level of an event)
basic_config() now works as documented for .jsonl files
AppenderMemory gains a $clear() method that clears the buffer without
sending the events to it's attached appenders
LayoutJson gains a timestamp_fmt field that can be used for custom
timestamp formats (#34)
added toString.LogEvent() for compact representations of LogEvents
lgr is now automatically tested for all major R version >= 3.2.0
AppenderMemory/AppenderBuffer: flush_threshold is now independent of
should_flush function. default_should_flush() is no longer necessary
and has been removed.
Updated AppenderFileRotating and co for compatibility with rotor 0.3.0
Most errors now have appropriate subclasses
Logger$log() dispatches to all appenders - even if some throw an error -
instead of aborting after the first Appender that throws an error
complete rewrite of the documentation to use the new roxygen2 features for R6 classes.
Added logger_tree() which provides an overview of all registered loggers
Added print() and format() methods for Appenders
AppenderMemory: added data and dt active fields (which return the
log as a data.frame or data.table)
Removed deprecated functions FATAL(), ERROR(). Use lgr$fatal(),
lgr$error(), ... instead.
AppenderMemory: $buffer_dt() and $show() now handle custom fields
containing atomic vectors correctly
Added support for rotating log files via AppenderFileRotating,
AppenderFileRotatingDate and AppenderFileRotatingTime. Requires the
package rotor.
functions like show_log(), show_data(),... now accept logger names as
well as Logger or Appender objects as target.
AppenderFile$new() now creates an empty file, or fails if it can't
Improved support for RMariaDB and dropped support for RMySQL
Improved support for RPostgres and dropped support for RPostgreSQL
added reset argument to get_logger(). This completely resets the
configuration of the logger and also replaces special loggers (such as
LoggerGlue) with vanilla ones.
The root logger can now be configured via options() and/or environment
variables (see ?lgr)
basic_config() now accepts thresholds ("info", "fatal") as arguments to
console and memory.
The default config of the root logger has changed. It now only has a
console appender and a default threshold of "info". To get
back the old behaviour run
basic_config(threshold = "all", console = "info", memory = "all").
$config(NULL) now resets a Logger to its default/unconfigured state
$config() now accepts YAML as well as JSON files (or YAML/JSON as a
character string)
with_log_level() and with_log_value() now accept logger names as well as
Logger objects as the logger argument
get_logger_glue() now works as intended
Deprecated FATAL(), ERROR(). Use lgr$fatal(), lgr$error(), ... instead.
Emergency fix that ensures test suite cleans up temporary files
Removed .rd file for the unexported LoggerRoot class
get_loggers() registers new loggers in the lgr::loggers namespace, this
is a more global and decoupled approach similar to how python logging handles
loggers.
removed full_name active binding for loggers. Loggers now only have
qualified names and name is now identical to what full_name was before.
For consistency the format method of ancestry has also been revised.
Logger inheritance is now derived from the qualified name of a logger.
Consequently lg$parent is now derived from lg$name, lg$set_parent()
is no longer possible.
If no threshold is set for a new Logger, it now inherits the threshold of its parent
Depend on R6 >= 2.4.0 which includes relevant fixes to finalizers. finalize methods are now private.
Logger now have a config method that allows configuring Loggers with config
objects and YAML files (experimental)
added with_logging(), the opposite of without_logging(). This can be
handy for automated tests where you might want so switch logging off/on only
for specific unit tests.
Added show_data() and show_dt() for quick access to the root loggers
in memory log as data.frame or data.table respectively
numerous small fixes
removed non-breaking-spaces from .RD files. This caused unforeseen problems with the compiling the .pdf manual during the CRAN submission process.