Skip to main content

Redis pub/sub logging handler for python

Project description

A logging handler for Python that publishes log messages using redis’s pub/sub system. You can use this to read or respond to streaming log data in real time.

Installation

The current stable release

easy_install python-redis-log

The latest from github

git clone git://github.com/jedp/python-redis-log.git
cd python-redis-log
python setup.py build
python setup.py install --prefix=$HOME  # for example

Requirements

Usage

>>> from redislog import handlers, logger
>>> l = logger.RedisLogger('my.logger')
>>> l.addHandler(handlers.RedisHandler.to("my:channel"))
>>> l.info("I like pie")
>>> l.error("Trousers!", exc_info=True)

Redis clients subscribed to my:channel will get a json log record like the following (sent from function foo() in file test.py:

{ username: 'jed',
  args: [],
  name: 'my.logger',
  level: 'info',
  line_no: 6,
  traceback: null,
  filename: 'test.py',
  time: '2011-06-02T14:50:08.237052',
  msg: 'winning',
  funcname: 'foo',
  hostname: 'smoothie.local' }

If an exception is raised, and exc_info is True, the log will include a formatted traceback in traceback.

The date is stored as an ISO 8601 string in GMT.

You can use the redis-cli shell that comes with redis to test this. At the shell prompt, type subscribe my:channel (replacing with the channel name you choose, of course). You will see subsequent log data printed in the shell.

Serving Suggestion

Redis pub/sub messages are not persistent; they are just messages. So you will probably wish to use this handler in conjunction with other handlers that actually save your data, like the standard python FileHandlers, or Andrei Savu’s MongoDB logging handler.

Contributors

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python-redis-log-0.1.2.tar.gz (4.7 kB view details)

Uploaded Source

Built Distribution

python_redis_log-0.1.2-py2.6.egg (7.8 kB view details)

Uploaded Egg

File details

Details for the file python-redis-log-0.1.2.tar.gz.

File metadata

File hashes

Hashes for python-redis-log-0.1.2.tar.gz
Algorithm Hash digest
SHA256 2b470f31f1481336d596e6d9e850ad3e6cbfebc0425f189b3309a98d2eaf3dfa
MD5 36abbdf554ae03b7770300f322116656
BLAKE2b-256 daa30c6108ea0978a9533bac4f645171dcdacf7e89a67baa56c228fb795f0c0e

See more details on using hashes here.

File details

Details for the file python_redis_log-0.1.2-py2.6.egg.

File metadata

File hashes

Hashes for python_redis_log-0.1.2-py2.6.egg
Algorithm Hash digest
SHA256 c4ceca42c726042b8f69b57bf04a036456937815f2cadaba7b3eced01e5ab81c
MD5 36451d2f63f43f7224c7bc399137430b
BLAKE2b-256 89f27f60d083d21e97551d1be7c049ec4c756e7ad2e6c70eacde148dcbecaa27

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page