The rocket-fast system for log processing


Author: Pascal Withopf <>

Target audience are developers and users who need to debug an error with tests. For debugging with rsyslog.conf see troubleshooting.

Debugging with tests

When you want to solve a specific problem you will probably create a test
and want to debug with it instead of configuring rsyslog. If you want to
write a debug log you need to open the file ../rsyslog/tests/
and delete the # in front of the two lines:
export RSYSLOG_DEBUG=”debug nologfuncflow noprintmutexaction nostdout”
A debug log will be writen now, but remember to put the # back again
before commiting your changes. Otherwise it won’t work.

Memory debugging

You can’t use multiple memory debugger at the same time. This will resort
in errors. Also remember to undo all changes in after you are done,
because it will also resort in errors if you commit them with your work.


If you want to use Valgrind you need to enable it for tests.
To do that open the file ../rsyslog/tests/ and delete the #
in front of the line:
valgrind=”valgrind –malloc-fill=ff –free-fill=fe –log-fd=1”
This will enable valgrind and you will have extra debugging in your test-suite.log file.

Address sanitizer

If you want to use adress sanitizer you need to set your CFLAGS. Use this command:
export CFLAGS=”-g -fsanitizer=address”
After this is done you need to configure and build rsyslog again, otherwise it won’t work.

See also

If you would like to contribute to these docs, but are unsure where to start, please see the rsyslog-doc project README for an overview of the process. If you would like to contribute to the main source project, please review the contribution guidelines listed in the rsyslog project README.

If you have a question about these docs or Rsyslog in general, please see the following resources:

© 2008-2017, Rainer Gerhards and Others. This site uses the “better” theme for Sphinx.