Skip to main content
Warning: You are using the test version of PyPI. This is a pre-production deployment of Warehouse. Changes made here affect the production instance of TestPyPI (
Help us improve Python packaging - Donate today!

New Relic Python Agent

Project Description

The newrelic package instruments your application for performance monitoring and advanced performance analytics with New Relic.

Pinpoint and solve Python application performance issues down to the line of code. New Relic APM is the only tool you’ll need to see everything in your Python application, from the end user experience to server monitoring. Trace problems down to slow database queries, slow 3rd party APIs and web services, caching layers, and more. Monitor your app in a production environment and make sure your app can stand a big spike in traffic by running scalability reports.

Visit Python Application Performance Monitoring with New Relic to learn more.


$ pip install newrelic


(These instructions can also be found online: Python Agent Quick Start.)

  1. Generate the agent configuration file with your license key.

    $ newrelic-admin generate-config <YOUR-LICENSE-KEY> newrelic.ini
  2. Validate the agent configuration and test the connection to our data collector service.

    $ newrelic-admin validate-config newrelic.ini
  3. Integrate the agent with your web application.

    If you control how your web application or WSGI server is started, you can use the newrelic-admin wrapper script. Modify the existing startup script, prefixing the existing startup command and options with newrelic-admin run-program.

    Also, set the NEW_RELIC_CONFIG_FILE environment variable to the name of the configuration file you created above:

    $ NEW_RELIC_CONFIG_FILE=newrelic.ini newrelic-admin run-program <YOUR-EXISTING-STARTUP-COMMAND>


    $ NEW_RELIC_CONFIG_FILE=newrelic.ini newrelic-admin run-program gunicorn -c test_site.wsgi
    $ NEW_RELIC_CONFIG_FILE=newrelic.ini newrelic-admin run-program uwsgi uwsgi_config.ini

    Alternatively, you can also manually integrate the agent by adding the following lines at the very top of your python WSGI script file. (This is useful if you’re using mod_wsgi.)

    import newrelic
  4. Start or restart your Python web application or WSGI server.

  5. Done! Check your application in the New Relic RPM UI to see the real time statistics generated from your application.


New Relic for Python is free-to-use, proprietary software. Please see the LICENSE file in the distribution for details on the New Relic License agreement and the licenses of its dependencies.

Release History

Release History

This version
History Node

History Node

History Node

History Node

History Node

History Node

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
newrelic- (725.2 kB) Copy SHA256 Checksum SHA256 Source Jul 6, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting