syslog-ng Open Source Edition 3.16 - Release Notes

python-blocks

• Available in syslog-ng OSE version 3.10 and later.

• Currently only Python 2.7 is supported.

• The Python block must be a top-level block in the syslog-ng OSE configuration file. If you store the Python code in a separate Python file and only include it in the syslog-ng OSE configuration file, make sure that the PYTHON_PATH environment variable includes the path to the Python file, and export the PYTHON_PATH environment variable. For example: export PYTHONPATH=/opt/syslog-ng/etc

• The Python object is initiated only once, when syslog-ng OSE is started or reloaded. That means it keeps the state of internal variables while syslog-ng OSE is running.

• The Python block can contain multiple Python functions.

• Using Python code in syslog-ng OSE can significantly decrease the performance of syslog-ng OSE, especially if the Python code is slow.

• Validate and lint the Python code before using it. The syslog-ng OSE application does not do any of this.