To take full advantage of our latest features, enhancements, and important security patches, we recommend you update your Python agent to the latest version. For additional information about specific agent updates, refer to the Python agent release notes.
Update with Python package index (PyPi)
The Python agent package is listed on PyPi at http://pypi.python.org/pypi/newrelic. To update with a specific package, follow the corresponding instructions:
Python package | Installation procedures |
---|---|
pip | To update the
If you have New Relic in your
|
easy_install | To update using
TipWe recommend using |
buildout | Install the package by creating an appropriate section for the |
Download package manually
To manually download the New Relic Python package:
- Remove the current New Relic package.
- Download the new package, then follow the Python agent installation procedures.
Tip
We recommend using pip
rather than using manual installation, because pip
will correctly remove old versions when updating the agent software.
Python agent versions not supported
End of life notification: As of January 26, 2015, we will no longer accept data from Python agent versions earlier than 2.42.0.
These agent versions use an out-of-date protocol when communicating with our data collection services. In addition, many of these versions contain a potential security issue where they may incorrectly send sensitive data to our data collector.
Update unsupported agent versions
Important
If you are updating from an older agent version, including major version jumps, review the following list for changes in functionality.
Migration | Comments |
---|---|
4.2.0.100 and higher | Release notes: Python agent 4.2.0.100 Manual override for the path to your local CA bundle. This CA bundle will be used to validate the SSL certificate presented by our data collection service. Set with the Python agent config file. |
4.0.0.99 | Release notes: Python agent 4.0.0.99 Previously deprecated APIs removed:
|
3.0.0.89 | Release notes: Python agent 3.0.0.89 Previously deprecated APIs removed:
|
2.104.0.86 | Release notes: Python agent 2.104.0.86 SSL: Disabling SSL connections has been deprecated. SSL connections are enabled by default. In a future release, the option to disable SSL will be removed. |
2.56.0.42 | Release notes: Python agent 2.56.0.42 Deprecated config settings: Several configuration settings have been deprecated. The most commonly used of the deprecated settings are |
2.10.0.8 | Release notes: Python agent 2.10.0.8 Deprecated API: Do not use the agent API function Optional: To display these parameters in browser traces, enable the |
At or below 2.0.0 | Proxy settings: Python agent versions 2.0.0 or earlier do not provide the If you are updating from an older agent version and your config file doesn't include Proxies are usually only configured to accept proxy requests via the http protocol scheme. If you do not set |
1.11.0.55 | Release notes: Python agent 1.11.0.55 Thread profiling for WSGI servers: We have disabled the ability to get thread profiling information when a WSGI server uses coroutine libraries such as |
1.0.3.138 | Release notes: Python agent 1.0.3.138 Attributes from WSGI requests: Attributes captured from WSGI request environments such as |
For more help
If you need more help, check out these support and learning resources:
- Browse the Explorers Hub to get help from the community and join in discussions.
- Find answers on our sites and learn how to use our support portal.
- Run New Relic Diagnostics, our troubleshooting tool for Linux, Windows, and macOS.
- Review New Relic's data security and licenses documentation.