/py3syslog2elasticsearch

Python 3 implementation of a simple UDP syslog server which inserts the received messages into an Elasticsearch index

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

py3syslog2elasticsearch

Python 3 implementation of a simple UDP syslog server which inserts the recieved messages into a Elasticsearch [1] index.

About

The Python script will start a syslog server which inserts the recieved messages into a Elasticsearch [1] index.

Every time the script is executed it will check if the index for current date exists and if not create them. Then the script is executed until it will be manually closed. Every time a message is recieved on the defined port the data will be decoded as UTF-8, inserted in the index and printed out in the terminal.

Be aware that the UDP packages are not encypted. Set up security (authentication and/or SSL) for Elasticsearch.

The script uses the python module socketserver [2] and the external module mysql-connector-python [3] . See requirements.txt for installed packages and the used versions. The file is created with pip3 freeze > requirements.txt.

Usage

First install the required mysql-connector-python module in the global Python 3 environment or in a virtual Python 3 environment. The latter has the advantage that the packages are isolated from other projects and also from the system wide installed global once. If things get messed up, the virtual environment can just be deleted and created from scratch again. For more informations about virtual environments in Python 3, see venv1 [4] and venv2 [5] .

pip3 install mysql-connector-python

Then modify the PORT, db_name, table_name, db_user, db_password, db_host and db_port parameters in the syslogserver.py script and execute it.

python3 syslogserver.py

Or use e.g. tmux [6] to execute it in the background.

Systemd service

An example .service file is also included to show how to run the syslog server as a systemd service at startup. For more informations, see systemd.service [7] . In the example .service file a virtual Python 3 environment is used to execute the script. Also the script will be automatically restarted if it crashes to ensure that the syslog server is always running. The local user name and the path to the virtual Python 3 environment needs to be adjusted before it can be used.

To activate the systemd service execute the following commands.

sudo cp syslogserver.service /etc/systemd/system/

sudo systemctl daemon-reload

sudo systemctl start syslogserver.service

sudo systemctl enable syslogserver.service

Credits

https://github.com/choeffer/py3syslog

https://gist.github.com/marcelom/4218010

References

[1](1, 2) https://www.elastic.co/elasticsearch/
[2]https://docs.python.org/3/library/socketserver.html
[3]https://pypi.org/project/mysql-connector-python/
[4]https://docs.python.org/3/tutorial/venv.html
[5]https://docs.python.org/3/library/venv.html
[6]https://en.wikipedia.org/wiki/Tmux
[7]https://www.raspberrypi.org/documentation/linux/usage/systemd.md