Registers a logger instance in a given logging namespace.
Source:R/register_logger.R
register_logger.Rd
Arguments
- namespace
(
character(1)
orNA_character_
)
the name of the logging namespace- layout
(
character(1)
)
the log layout. Alongside the standard logging variables provided by thelogging
package (e.g.pid
) thetoken
variable can be used which will write the last 8 characters of the shiny session token to the log.- level
(
character(1)
orcall
) the log level. Can be passed as character or one of thelogger
's objects. Seelogger::log_threshold()
for more information.
Details
Creates a new logging namespace specified by the namespace
argument.
When the layout
and level
arguments are set to NULL
(default), the function
gets the values for them from system variables or R options.
When deciding what to use (either argument, an R option or system variable), the function
picks the first non NULL
value, checking in order:
Function argument.
System variable.
R option.
layout
and level
can be set as system environment variables, respectively:
teal.log_layout
asTEAL.LOG_LAYOUT
,teal.log_level
asTEAL.LOG_LEVEL
.
If neither the argument nor the environment variable is set the function uses the following R options:
options(teal.log_layout)
, which is passed tologger::layout_glue_generator()
,options(teal.log_level)
, which is passed tologger::log_threshold()
The logs are output to stdout
by default. Check logger
for more information
about layouts and how to use logger
.