Eliot provides a structured logging and tracing system for Python that generates log messages describing a forest of nested actions. Actions start and eventually finish, successfully or not. Log messages thus tell a story: what happened and what caused it.
Here's what your logs might look like before using Eliot: Going to validate http://example.com/index.html. Started download attempted. Download succeeded! Missing <title> element in "/html/body". Bad HTML entity in "/html/body/p[2]". 2 validation errors found! After switching to Eliot you'll get a tree of messages with both message contents and causal relationships encoded in a structured format: * {"action_type": "validate_page", "action_status": "started", "url": "http://example.com/index.html"} o {"action_type": "download", "action_status": "started"} o {"action_type": "download", "action_status": "succeeded"} o {"action_type": "validate_html", "action_status": "started"} + {"message_type": "validation_error", "error_type": "missing_title", "xpath": "/html/head"} + {"message_type": "validation_error", "error_type": "bad_entity", "xpath": "/html/body/p[2]"} o {"action_type": "validate_html", "action_status": "failed", "exception": "validator.ValidationFailed"} * {"action_type": "validate_page", "action_status": "failed", "exception": "validator.ValidationFailed"} Features: * Structured, typed log messages. * Ability to log actions, not just point-in-time information: log messages become a trace of program execution. * Excellent support for unit testing your logging code. * Emphasis on performance, including no blocking I/O in logging code path. * Optional Twisted support. * Designed for JSON output, usable by Logstash/Elasticsearch. * Supports CPython 2.7, 3.3 and PyPy. Eliot is released by HybridCluster <https://hybridcluster.github.io> under the Apache 2.0 License. To install: $ pip install eliot Downloads are available on PyPI <https://pypi.python.org/pypi/eliot>. Documentation can be found on Read The Docs <https://eliot.readthedocs.org/>. Bugs and feature requests should be filed at the project Github page <https://github.com/hybridcluster/eliot>. -- https://mail.python.org/mailman/listinfo/python-announce-list Support the Python Software Foundation: http://www.python.org/psf/donations/
