Get/Create a Logger

get_logger(name, class = Logger, reset = FALSE)

get_logger_glue(name)

Arguments

name

a character scalar or vector: The qualified name of the Logger as a hierarchical value.

class

An R6ClassGenerator object. Usually Logger or LoggerGlue are the only valid choices.

reset

a logical scalar. If TRUE the logger is reset to an unconfigured state. Unlike $config(NULL) this also replaces a LoggerGlue with vanilla Logger. Please note that this will invalidate Logger references created before the reset call (see examples).

Value

a Logger

Examples

lg <- get_logger("log/ger/test") # equivalent to lg <- get_logger(c("log", "ger", "test")) lg$warn("a %s message", "warning")
#> WARN [11:20:22.828] a warning message
lg
#> <Logger> [info] log/ger/test #> #> inherited appenders: #> console: <AppenderConsole> [all] -> console
lg$parent
#> <Logger> [info] log/ger #> #> inherited appenders: #> console: <AppenderConsole> [all] -> console
if (requireNamespace('glue')){ lg <- get_logger_glue("log/ger") } lg$warn("a {.text} message", .text = "warning")
#> WARN [11:20:22.837] a warning message
# completely reset 'glue' to an unconfigured vanilla Logger get_logger("log/ger", reset = TRUE)
#> <Logger> [info] log/ger #> #> inherited appenders: #> console: <AppenderConsole> [all] -> console
# WARNING: this invalidates existing references to the Logger try(lg$info("lg has been invalidated an no longer works"))
#> Warning: [2020-10-22 11:20:22.842] an error occurred during logging: Trying to log via a Logger reference that is no longer valid. Logger references become invalid when you reset a when you reset a Logger with `get_logger(reset = TRUE)`. Please re-create the Logger reference with with `get_logger(log/ger)`
lg <- get_logger("log/ger") lg$info("now all is well again")
#> INFO [11:20:22.845] now all is well again