last.tryCatchLog.result: Gets the logging result of the last call to 'tryCatchLog' or...

In tryCatchLog: Advanced 'tryCatch()' and 'try()' Functions

Description

This funktion makes the logging results of all thrown conditions of the last tryCatchLog or tryLog call available in a structured form (data.frame).

Usage

last.tryCatchLog.result()

Details

The typical use case is to get and store the log output not only in a log file but also in another place that is not supported by the logging framework, e. g. in a data base table of your application or displaying it in a GUI (user interface).

Another use case is to review the last log output on the console during debugging.

Value

the logging result of the last call to tryCatchLog or tryLog as data.frame comprised of one row per logged condition with these columns:

1. timestamp - creation date and time of the logging entry

2. severity - the serverity level of the log entry (ERROR, WARN, INFO etc.)

3. msg.text - the message text of the log entry

4. execution.context.msg - text identifier (eg. the PID or a variable value) as passed as argument to tryCatchLog or tryLog to make it easier to identify the runtime state that caused a condition esp. in parallel execution scenarios

5. compact.stack.trace - the short stack trace containing only entries with source code references down to line of code that has thrown the condition

6. full.stack.trace - the full stack trace with all calls down to the line of code that has thrown the condition (including calls to R internal functions and other functions even when the source code in not available).

7. dump.file.name - name of the created dump file (if any)

If no condition is logged at all an empty data.table is returned.

See Also

tryCatchLog, tryLog

Examples

last.tryCatchLog.result()

tryCatchLog documentation built on Oct. 25, 2021, 9:08 a.m.