You will find links to detailed information about the Python agent here. For additional information about general issues and details of any missing features in this document, see Status of Python agent.
|Operating systems||UNIX-like operating systems including Linux, Solaris, FreeBSD and Mac OS X.|
|Python||Versions 2.6, 2.7, 3.3 (CPython/PyPy)|
|Web frameworks||Supported WSGI web frameworks include Bottle, CherryPy, Django, Flask, Pylons, Pyramid, and Web2Py.|
|Hosting||Web hosting mechanisms compliant with WSGI 1.0 (PEP 333).|
|Security requirements||As a standard security measure for data collection, your app server must support SHA-2 (256-bit). SHA-1 is not supported.|
Instrumentation is also provided for a range of other Python packages and modules. Such instrumentation covers areas such as database queries, memcache requests and external service requests. Results from these will also show up automatically within web transaction performance breakdowns and transaction traces for slow transactions.
Unsupported WSGI frameworks
Although a specific Python WSGI web framework may not be supported, the agent can still be used.
For unsupported frameworks, a breakout of time spent in key parts of the framework will not be available by default in Web transaction performance breakdowns and transaction traces for slow transactions. Web transactions handled by specific handlers in your code, which make it more useful and targeted, will not be meaningfully grouped. In these cases you can use our agent API to name web transactions or add custom instrumentation.
Downloading the agent
The package can also be installed using Python packaging tools such as pip, easy_install, distribute or buildout via the Python Package Index.
To use the Python agent, you first need to have a New Relic account.
For supported WSGI servers and web frameworks, follow the Python agent quick start guide. If you use Heroku, see Python agent and Heroku. If the quick start guides don't cover your web stack, or if you have special requirements around how the package needs to be installed, see the detailed Python agent installation instructions.
For more help
Additional documentation resources include:
- Python agent quick start (a quick Python installation usable for most configurations)
- Python agent installation (a detailed walkthrough of the Python installation process)
- Python agent integration (integrating the Python agent into your app)
- Python hosting mechanisms (a list of additional documentation by hosting mechanism)