This is a fork of CMRESHandler.py project. We didn't contribute to it as there's no maintenance of that project anymore.
Python Elasticsearch Log handler
This library provides an Elasticsearch logging appender compatible with the
python standard logging <https://docs.python.org/2/library/logging.html>_ library.
The code source is in github at https://github.com/cmanaha/python-elasticsearch-logger <https://github.com/cmanaha/python-elasticsearch-logger>_
Install using pip::
pip install eslogging
This library requires the following dependencies
- elasticsearch
- requests
Additionally, the package support optionally kerberos authentication by adding the following dependecy
- requests-kerberos
Additionally, the package support optionally AWS IAM user authentication by adding the following dependecy
- requests-aws4auth
To create the package follow the standard python setup.py to compile. To test, just execute the python tests within the test folder
In some cases is quite useful to provide all the information available within the LogRecords as it contains things such as exception information, the method, file, log line where the log was generated.
If you are interested on understanding more about the differences between the agent vs handler
approach, I'd suggest reading this conversation thread <https://github.com/cmanaha/python-elasticsearch-logger/issues/44/>_
The same functionality can be implemented in many other different ways. For example, consider the integration
using SysLogHandler <https://docs.python.org/3/library/logging.handlers.html#sysloghandler>_ and
logstash syslog plugin <https://www.elastic.co/guide/en/logstash/current/plugins-inputs-syslog.html>_.
Feel free to use this as is or even better, feel free to fork and send your pull requests over.
