Skip to main content

A common WSGI stack

Project description

https://img.shields.io/pypi/v/talisker.svg https://img.shields.io/travis/canonical-ols/talisker.svg Documentation Status

Talisker is a runtime for your wsgi app that aims to provide a common platform for your python services.

tl;dr

Simply run your wsgi app with talisker as if it was gunicorn.:

talisker app:wsgi -c config.py …

Talisker will wrap your app in a some simple WSGI middleware, and configure logging to output structured logging like so:

logger = logging.getLogger('app')
logger.info('something happened', extra={'context': 'I haz it'})

will output:

2016-01-13 10:24:07.357Z INFO app "something happened" svc.context="I can haz it" request_id=...

It also exposes some status endpoints you can use, go to the /_status/ url on your app to see them.

This all works out of the box by using the talisker runner instead of gunicorns, and there are many more features you can use too.

Elevator Pitch

Talisker is based on a number of standard python tools:

  • stdlib logging for logs

  • gunicorn for a wsgi runner

  • requests for http requests

  • statsd for metrics

  • raven for errors

  • werkzeug for thread locals and wsgi utilities

It is designed sepcifically to be used in both development and production, and aims to provide a default set of features out of the box:

  • standard log format, including ISO/UTC timestamps

  • structured logging with python stdlib

  • improved gunicorn access logs, with ms precision UTC timestamps

  • request id tracing

  • standard set of status endpoints for your app

  • easier statsd endpoint configuration

  • sentry/raven middleware (TODO)

All the above are available by just using the talisker entry point script, rather than gunicorn.

In addition, with a small amount of effort, your app can benefit from additional features:

  • simple deeper nagios checks - just implement a _status/check url in your app

  • per-thread requests connection pool managment (WIP)

  • automatic statsd metrics for outgoing HTTP requests (WIP)

  • more efficient statsd client management (WIP)

Additionally, talisker provides additional tools for integrating with your infrastructure:

  • grok filters for log parsing (WIP)

  • rsyslog templates and config for log shipping (TODO)

Talisker is opinionated, and derived directly from the authors’ needs and as such not currently very configurable. However, PR’s are very welcome!

For more information, see The Documentation, which should be found at:

https://talisker.readthedocs.io

0.5.7 (16-09-02)

  • Update publishing workflow

  • Add make changelog target

0.5.6 (2016-09-02)

  • more testing release process in prepartion for 0.6

0.5.5 (2016-09-02)

  • testing release process in prepartion for 0.6

0.5.4 (2016-08-10)

  • series of point release to fix various small bugs

0.5.0 (2016-08-10)

  • add grok filters for logstash

  • slight adjustment to logfmt serialisation: talisker now strips “ from tag values. This is due to a limitation in logstash.

0.4.1 (2016-08-05)

  • publish separate py2/py3 wheels, due to dependency differences

  • some doc changes

0.4.0 (2016-08-05)

  • First public release an PyPI.

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

talisker-0.5.7.tar.gz (52.3 kB view details)

Uploaded Source

Built Distributions

talisker-0.5.7-py3-none-any.whl (23.5 kB view details)

Uploaded Python 3

talisker-0.5.7-py2-none-any.whl (23.6 kB view details)

Uploaded Python 2

File details

Details for the file talisker-0.5.7.tar.gz.

File metadata

  • Download URL: talisker-0.5.7.tar.gz
  • Upload date:
  • Size: 52.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for talisker-0.5.7.tar.gz
Algorithm Hash digest
SHA256 19dbdb4fd525be1a15834e215ed72c5b4da91bd6f7c7261eb7208cebf26027ec
MD5 9e53729f3fcf1fdd8defe30d49dc59ee
BLAKE2b-256 01bbd57857cddbd2dfc5cd89357ad64a754035a4234111d07387f709ec5b1321

See more details on using hashes here.

File details

Details for the file talisker-0.5.7-py3-none-any.whl.

File metadata

File hashes

Hashes for talisker-0.5.7-py3-none-any.whl
Algorithm Hash digest
SHA256 63419db794c855e12171de256d83e1cbe6f593c7963e7de502799cc6b688a35c
MD5 0404afc3b5df635c75493b8e1dbca081
BLAKE2b-256 96643dec99ce584642a1fb28b1cd95a58fd49da066f5cccd0a1bd1d6b741a012

See more details on using hashes here.

File details

Details for the file talisker-0.5.7-py2-none-any.whl.

File metadata

File hashes

Hashes for talisker-0.5.7-py2-none-any.whl
Algorithm Hash digest
SHA256 0d1e07ee6994d3b0318bf321cc954b8854168a3612fbc0b26b1ca67bd7e72929
MD5 a8b74e348e2474584f3af47030fe513e
BLAKE2b-256 b775a382d01fb77d5528a1736f9179d68fc569705ebe11dc9e1af1b6f9f17fc9

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