Compatibility and requirements for the Python agent

Before you install the New Relic Python agent, make sure your system meets these requirements.

Basic requirements

New Relic supports many of the most common Python WSGI web frameworks. Additional configuration may be required depending on your specific hosting mechanism, hosting service, web framework, or back-end services.

Resource Requirements
Operating systems UNIX-like operating systems including Linux, Solaris, FreeBSD and Mac OS X.
Python Versions 2.6, 2.7, 3.3, 3.4, 3.5, 3.6 (CPython/PyPy)
Supported web frameworks

Supported WSGI web frameworks include:

Unsupported frameworks

Some WSGI servers, frameworks, and apps have special requirements. Although a specific Python WSGI web framework may not be supported, you can still use the agent. For unsupported frameworks, a breakout of time spent in key parts of the framework will not appear in web transaction performance breakdowns and transaction traces.

In addition, New Relic will not be able to meaningfully group any web transactions handled by specific handlers in your code that you use to make them more useful and targeted. In these situations you can use New Relic's Python agent API to name web transactions or add custom instrumentation.

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.

Python package instrumentation

New Relic also provides instrumentation for a range of other Python packages and modules. Instrumentation includes database queries, memcache requests, external service requests, and more. The results will appear automatically in New Relic APM's user interface within web transaction performance breakdowns and transaction traces for slow transactions.

For more help

Additional documentation resources include:

Join the discussion about Python in the New Relic Online Technical Community! The Technical Community is a public platform to discuss and troubleshoot your New Relic toolset.

If you need additional help, get support at