Skip to content

systemd/systemd-coredump-python

Repository files navigation

sys.excepthook helper for Python to send backtraces to the journal

GIT: git@github.com:systemd/systemd-coredump-python.git https://github.com/systemd/systemd-coredump-python.git

BUG REPORTS: https://github.com/systemd/systemd-coredump-python/issues

LICENSE: GPLv2.1+ for all code

REQUIREMENTS: Python 2.x or 3.x. Tested with CPython, PyPy, PyPy3.

(Does not work with Jython: 2.5 is too old, and 2.7 is broken,
see http://bugs.jython.org/issue2405.)

systemd v. 233 or later is required.

USAGE:

For this module provides a function which may be installed as the
`sys.excepthook` exception handler. It will generate a backtrace
and invoke systemd-coredump(8) to send it to off to the journal
along with some additional metadata about the python process.

When installed, a .pth file is also installed which loads this
module and checks if it should handle `sys.excepthook`. It will be
automatically enabled if /proc/sys/kernel/core_pattern specifies
systemd-coredump.

It is also possible to unconditionally install this module as
`sys.excepthook` by calling
`systemd_coredump_exception_handler.install(True)`.

SEE ALSO: https://github.com/abrt/abrt/blob/master/src/hooks/abrt_exception_handler.py.in