Repository files navigation

This tool makes configuringsyslog-ng a bit easier by listing the options of each available driver.

The options are generated fromsyslog-ng v4.6.0.

pipx install syslog-ng-cfg-helper

syslog-ng-cfg-helper

syslog-ng-cfg-helper --context parser

syslog-ng-cfg-helper --context parser --driver csv-parser

The tool is still in development, but most of the drivers are supported.

Missing features are:

• Properrewrite support.
• Properfilter support.
• Drivers defined inSCLs.
• Drivers defined with confgen.

Any contribution is welcome :)

The project usespoetry as a dependency management system.

Building of the option database needs theneologism pip package, which gets installed by poetry, however it has another dependency, which isbison. Make sure to install bison (at least 3.7.6) on you system if you wan't to develop locally.make bison can help with that.

TheMakefile consists of some useful commands:

• make venv prepares the venv.
• make bison downloads bison 3.7.6, builds it and installs it under/usr/local.
  • You can change the install path withmake bison BISON_INSTALL_PATH=...
• make check runs the unit tests, style-checkers and linters.
• make format formats the code.
• make db downloads the syslog-ng release tarball and generates the option database.
• make db SYSLOG_NG_SOURCE_DIR=/path/to/syslog-ng creates a tarball from the state of the syslog-ng source dir and generates the option database.
• make package creates the pip package.

This is a retro fork ofaxosyslog-cfg-helper, as that no longer supports syslog-ng.