Metadata-Version: 1.0
Name: django-live-profiler
Version: 0.0.8
Summary: A database access profiler for Django-based applications that can be ran in production with minimal performace overhead.
Home-page: https://github.com/InviteBox/django-live-profiler
Author: Alexander Tereshkin
Author-email: atereshkin@invitebox.com
License: BSD
Description: ====================
        django-live-profiler
        ====================
        
        Profile Django-based applications running in production with minimal performance overhead.
        
        ---------
        Rationale
        ---------
        Profiling web applications on a development environment often produces misleading results due to different patterns in the data, different patterns in user behavior and differences in infrastructure. 
        
        All existing DB access profiling solutions for Django seem to be focusing on a single request. However, in the real world certain queries might be negligible in a single request while still putting a considerable strain the database across all requests.
        
        *django-live-profiler* aims to solve these issues by collecting database usage data from a live application.
        
        .. image :: https://github.com/InviteBox/django-live-profiler/raw/master/doc/screenshot1.png
           :alt: screenshot
        
        
        ------------
        Installation
        ------------
        1. Run `pip install django-live-profiler`
        2. Add `'profiler'` app to `INSTALLED_APPS` 
        3. Add `'profiler.middleware.ProfilerMiddleware'` to `MIDDLEWARE_CLASSES`
        4. Optionally add `'profiler.middleware.StatProfMiddleware'` to `MIDDLEWARE_CLASSES` to enable Python code statistical profiling (using statprof_). WARNING: this currently incurs a significant performance penalty.
        5. Add `url(r'^profiler/', include('profiler.urls'))` to your urlconf
        
        .. _statprof: https://github.com/bos/statprof.py
        
        In order to start gathering data you need to start the aggregation server::
        
          $ aggregated --host 127.0.0.1 --port 5557
        
        
        Visit http://yoursite.com/profiler/ for results.
        
Keywords: django profiler
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Topic :: Software Development
Classifier: Framework :: Django
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
