Package index • logger

Key logging functions

log_level() log_fatal() log_error() log_warn() log_success() log_info() log_debug() log_trace(): Log a message with given log level

OFF FATAL ERROR WARN SUCCESS INFO DEBUG TRACE: Log levels

log_threshold(): Get or set log level threshold

Other logging helpers

log_eval(): Evaluate an expression and log results

log_failure(): Logs the error message to console before failing

log_tictoc(): Tic-toc logging

log_elapsed() log_elapsed_start(): Log cumulative running time

log_separator(): Logs a long line to stand out from the console

log_with_separator(): Logs a message in a very visible way

with_log_threshold(): Evaluate R expression with a temporarily updated log level threshold

log_chunk_time(): Automatically log execution time of knitr chunks

Appenders

Log appenders define where logging output should be sent to.

log_appender(): Get or set log record appender function

appender_async(): Delays executing the actual appender function to the future in a background process to avoid blocking the main R session

appender_console() appender_stderr(): Append log record to stderr

appender_file(): Append log messages to a file

appender_kinesis(): Send log messages to a Amazon Kinesis stream

appender_ntfy(): Send log messages to ntfy

appender_pushbullet(): Send log messages to Pushbullet

appender_slack(): Send log messages to a Slack channel

appender_stdout(): Append log record to stdout

appender_syslog(): Send log messages to the POSIX system log

appender_syslognet(): Send log messages to a network syslog server

appender_tee(): Append log messages to a file and stdout as well

appender_telegram(): Send log messages to a Telegram chat

appender_void(): Dummy appender not delivering the log record to anywhere

Formatters

Log formatters control how the inputs to the log_ functions are converted to a string. The default is formatter_glue() when glue is installed.

log_formatter(): Get or set log message formatter

formatter_cli(): Apply cli::cli_text() to format string with cli syntax

formatter_glue(): Apply glue::glue() to convert R objects into a character vector

formatter_glue_or_sprintf(): Apply glue::glue() and sprintf()

formatter_glue_safe(): Apply glue::glue_safe() to convert R objects into a character vector

formatter_json(): Transforms all passed R objects into a JSON list

formatter_logging(): Mimic the default formatter used in the logging package

formatter_pander(): Formats R objects with pander

formatter_paste(): Concatenate R objects into a character vector via paste

formatter_sprintf(): Apply sprintf() to convert R objects into a character vector

skip_formatter(): Skip the formatter function

Layouts

Logging layouts control what is sent to the appender. They always include the logged string, but might also include the timestamp, log level, etc.

log_layout(): Get or set log record layout

layout_blank(): Format a log record by including the raw message without anything added or modified

layout_gha(): Format a log record for github actions

layout_glue(): Format a log message with glue::glue()

layout_glue_colors(): Format a log message with glue::glue() and ANSI escape codes to add colors

layout_glue_generator(): Generate log layout function using common variables available via glue syntax

layout_json(): Generate log layout function rendering JSON

layout_json_parser(): Generate log layout function rendering JSON after merging meta fields with parsed list from JSON message

layout_logging(): Format a log record as the logging package does by default

layout_simple(): Format a log record by concatenating the log level, timestamp and message

layout_syslognet(): Format a log record for syslognet

Hooks for automated logging

log_shiny_input_changes(): Auto logging input changes in Shiny app

log_messages(): Injects a logger call to standard messages

log_warnings(): Injects a logger call to standard warnings

log_errors(): Injects a logger call to standard errors

Other helpers

colorize_by_log_level() grayscale_by_log_level(): Color string by the related log level

logger(): Generate logging utility

delete_logger_index(): Delete an index from a logger namespace

`%except%`: Try to evaluate an expressions and evaluate another expression on exception

Dev tools

as.loglevel(): Convert R object into a logger log-level

deparse_to_one_line(): Deparse and join all lines into a single line

fail_on_missing_package(): Check if R package can be loaded and fails loudly otherwise

get_logger_meta_variables(): Collect useful information about the logging environment to be used in log messages

log_namespaces(): Looks up logger namespaces

log_indices(): Returns number of currently active indices