Introduction | Quickstart | Logging to the console | Logging to plaintext files | Logging to JSON files | Structured Logging (custom fields) | What Else | Usage | Structure of the logging system | On R6 classes | Log levels | Logging with the Root Logger | Logging syntax | Formatting strings | LogEvents: The atomic unit of logging | Thresholds & Filters: controlling output detail | Appenders: Managing log destinations | Inheritance: Hierarchical Loggers | Log flow | Logging with LoggerGlue | Configuration | With setters | With a list object | With YAML or JSON | Examples | Logging to rotating files | Logger hierarchies | Buffered logging | Logging to databases | Adding default extra fields to messages | Temporarily disable logging | Adding a custom logger to a package | Creating a Layout that mimics NodeJS Winston logstash | Adding the source file / R-script to the log event | References
Package: lgr 0.5.2.9000
lgr: A Fully Featured Logging Framework
A flexible, light-weight logging framework based on 'R6' classes. It supports hierarchical loggers, structured logging, output to plaintext, 'JSON', (rotating) files, and memory buffers. Additional appenders for 'Elasticsearch', 'Dynatrace', databases, email and push notifications, and more are available in the 'lgrExtra' package.
Authors:
lgr_0.5.2.9000.tar.gz
lgr_0.5.2.9000.zip(r-4.7)lgr_0.5.2.9000.zip(r-4.6)lgr_0.5.2.9000.zip(r-4.5)
lgr_0.5.2.9000.tgz(r-4.6-any)lgr_0.5.2.9000.tgz(r-4.5-any)
lgr_0.5.2.9000.tar.gz(r-4.7-any)lgr_0.5.2.9000.tar.gz(r-4.6-any)
lgr_0.5.2.9000.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
lgr/json (API)
| # Install 'lgr' in R: |
| install.packages('lgr', repos = c('https://s-fleck.r-universe.dev', 'https://cloud.r-project.org')) |
Bug tracker:https://github.com/s-fleck/lgr/issues
Pkgdown/docs site:https://s-fleck.github.io
Last updated from:23a8c4fbb6. Checks:9 OK. Indexed: yes.
| Target | Result | Time | Files | Syslog |
|---|---|---|---|---|
| linux-devel-x86_64 | OK | 148 | ||
| source / vignettes | OK | 204 | ||
| linux-release-x86_64 | OK | 152 | ||
| macos-release-arm64 | OK | 127 | ||
| macos-oldrel-arm64 | OK | 121 | ||
| windows-devel | OK | 101 | ||
| windows-release | OK | 97 | ||
| windows-oldrel | OK | 97 | ||
| wasm-release | OK | 104 |
Exports:.objadd_appenderadd_log_levelsAppenderAppenderBufferAppenderConsoleAppenderFileAppenderFileRotatingAppenderFileRotatingDateAppenderFileRotatingTimeAppenderJsonAppenderMemoryAppenderTableas_event_listas_LogEventas_logger_configas.data.table.event_listbasic_configCannotInitializeAbstractClassErrorcolorize_levelsconsole_thresholddefault_exception_handlerevent_listEventFilterFilterableFilterForceLevelFilterInjectget_callerget_log_levelsget_loggerget_logger_glueget_useris_filteris_log_levelis_log_levelsis_thresholdlabel_levelsLayoutLayoutFormatLayoutGlueLayoutJsonlgrlog_exceptionLogEventLoggerlogger_indexlogger_treeLoggerGluepad_leftpad_rightread_json_linesremove_appenderremove_log_levelsshow_datashow_dtshow_logstandardize_log_levelstandardize_log_levelsstandardize_thresholdstring_reprsuspend_loggingthresholdunlabel_levelsunsuspend_logginguse_loggerwith_log_levelwith_log_valuewith_loggingwithout_logging
Dependencies:R6
Readme and manuals
Help Manual
| Help page | Topics |
|---|---|
| Log to a memory buffer | AppenderBuffer |
| Log to the console | AppenderConsole |
| Log to a file | AppenderFile AppenderJson |
| Log to a rotating file | AppenderFileRotating |
| Log to a date-stamped rotating file | AppenderFileRotatingDate |
| Log to a time-stamped rotating file | AppenderFileRotatingTime |
| Abstract class for logging to memory buffers | AppenderMemory |
| Abstract class for logging to tabular structures | AppenderTable |
| Coerce objects to LogEvent | as_LogEvent as_LogEvent.data.frame as_LogEvent.list |
| Coerce LogEvents to Data Frames | as.data.frame.LogEvent as.data.table.LogEvent as_tibble.LogEvent |
| Basic Setup for the Logging System | basic_config |
| Logger Error Conditions | CannotInitializeAbstractClassError |
| Colorize Levels | colorize_levels |
| Demote an exception to a warning | default_exception_handler |
| A List of LogEvents | as.data.frame.event_list as.data.table.event_list as_event_list as_event_list.data.frame as_event_list.list as_event_list.LogEvent event_list |
| Event Filters | .obj EventFilter Filter |
| Abstract Class for Filterables | Filterable |
| Override the log level of all events processed by a Logger/Appender | FilterForceLevel |
| Inject values into all events processed by a Logger/Appender | FilterInject |
| Information About the System | get_caller get_user system_infos |
| Manage Log Levels | add_log_levels get_log_levels log_level log_levels remove_log_levels |
| Get/Create a Logger | get_logger get_logger_glue |
| Check if an R Object is a Filter | is_filter |
| Label/Unlabel Log Levels | label_levels unlabel_levels |
| Abstract Class for Layouts | Layout Layouts |
| Format Log Events as Text | LayoutFormat |
| Format Log Events as Text via glue | LayoutGlue |
| Format LogEvents as JSON | LayoutJson |
| LogEvents - The atomic unit of logging | LogEvent LogEvents |
| Loggers | Logger Loggers |
| Logger Configuration Objects | as_logger_config as_logger_config.character as_logger_config.list logger_config |
| Return a data.frame of all registered loggers | logger_index |
| Logger Tree | logger_tree |
| LoggerGlue | LoggerGlue |
| Pad Character Vectors | pad_left pad_right |
| Print an Appender object | print.Appender |
| Print or Format Logging Data | format.LogEvent print.LogEvent |
| Print a Logger Object | format.ancestry format.Logger print.ancestry print.Logger |
| Print Logger Trees | format.logger_tree print.logger_tree |
| Read a JSON logfile | read_json_lines |
| Simple Logging | add_appender console_threshold log_exception remove_appender show_data show_dt show_log simple_logging threshold |
| Standardize User-Input Log Levels to Their Integer Representation | is_log_level is_log_levels is_threshold standardize_log_level standardize_log_levels standardize_threshold |
| Short string representation for R objects | string_repr string_repr.data.frame string_repr.default string_repr.function string_repr.matrix string_repr.numeric |
| Suspend All Logging | suspend_logging unsuspend_logging without_logging with_logging |
| Convert a LogEvent to a character string | toString.LogEvent |
| Setup a Simple Logger for a Package | use_logger |
| Inject Values into Logging Calls | with_log_level with_log_value |
