Metadata-Version: 1.1
Name: django-mongolog
Version: 0.1.7
Summary: A simple mongo based logger
Home-page: https://github.com/gnulnx/django-mongolog
Author: John Furr
Author-email: john.furr@gmail.com
License: GPL V3
Download-URL: https://github.com/gnulnx/django-mongolog/tree/0.1.7
Description: MongoLog
        ========
        
        MongoLog is a simple mongo based log handler that can be used easly used
        with standard python/django logging
        
        Quick start
        -----------
        
        **Note:** If you are viewing this from PyPI you may find copy and paste works better from the github `README <https://github.com/gnulnx/django-mongolog/>`__  
        
        1. Add "mongolog" to your INSTALLED_APPS setting like this::
        
            INSTALLED_APPS = (
                ...
                'mongolog',
            )
        
        2. Add the MongoLoggerHandler to your LOGGING config::
        
            LOGGING = {
                'handler': {
                    'mongolog': {
                        'level': 'WARN',
                        'class': 'mongolog.MongoLogHandler',
                        'connection': 'mongodb://localhost:27017/'
                    },
                },
                'loggers': {
                    'django': {
                        'handlers': ['console', 'mongolog'],
                        'level': 'DEBUG',
                        'propagate': True
                    },
                },
            }
        
        3) Start you management shell::
        
            ./manage.py shell
        
        4) Create a a couple of log entries::
            
            import logging
            logger = logging.getLogger(__name__)
        
            logger.debug("A debug message")
            logger.info("An info message")
            logger.warning("A Serious warning")
            logger.error("We have an ERROR")
            try:
                raise ValueError("Bad Value")
            except ValueError as e:
                logger.exception("This is the worste exception ever")
        
        5) Now log into your mongo shell::
        
            mongo
            > use mongolog
            > db.mongolog.find().sort({created: 1}).limit(5).pretty()
        
            If you setup your logger with level 'WARN' like the example then
            you should now see three log entries corresponding to the warning, 
            error, and exception log statements.  However, you will not see the 
            debug and info statements unless you adjust the level down to 'DEBUG'.
        
Platform: UNKNOWN
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
