New Relic for Python monitors your Python application to help you identify and solve performance issues. You can also extend your performance monitoring to collect and analyze business data to help you improve the customer experience and make data-driven business decisions. With flexible options for custom instrumentation and APIs, New Relic for Python offers multiple building blocks to customize the data you need from your app.
New Relic for Python works with a wide variety of web frameworks and hosting mechanisms, including Django, Gunicorn, WSGI, CherryPy, uWSGI, and more. You can also install the Python agent in a Google App Engine flexible environment.
Monitor app performance
After you install the Python agent, it begins to collect data about your app. You can view the data as charts and tables in New Relic's user interface.
View the big picture of your app.
- Monitor your app's Apdex (user satisfaction).
- Get a high-level summary of your app with Overview page.
- Create architectural maps of your app and its connections and dependencies, including databases and external services.
- Install New Relic Infrastructure and view detailed server/host data for your app.
Find errors and problems quickly.
- Track key transactions specific to your business.
- Create custom dashboards for important metrics.
- Alert your team when an error or problem occurs before it affects your users.
- View performance after a deployment.
Drill down into performance details.
- Examine code-level transaction traces.
- Examine database query traces.
- Examine error traces.
- Use thread profiler sessions to see detailed stack traces of sampled threads
Other helpful New Relic APM tools include:
|New Relic APM tools||Description|
|New Relic Browser||Integrate the Python agent with New Relic Browser to gain visibility into end-user browser activity.|
|Simple scripts and background tasks||Monitor job-based or task queuing systems, like Celery, or other standalone non-web functions.|
|Business data analysis with New Relic Insights||
Use the Python agent with Insights to organize, query, and visualize your data to answer key questions about application performance and customer experience.
Install New Relic
New Relic supports a number of web frameworks and libraries right out of the box, including Django, WSGI, and Gunicorn. If you use one of the supported web frameworks, installation is easy. If you use an unsupported framework, the process will involve some additions to your app code and/or web server files.
Here's an overview of the major install steps:
- Download and install the New Relic package
- Create config file
- Integrate the New Relic agent with your application
For a quick and simple install process that will work for the majority of setups, see the Quick Start guide.
Monitor non-web scripts, background tasks, and functions
New Relic for Python also lets you monitor non-web scripts, worker processes, tasks, and functions. The installation process for these non-web transactions is similar to the one used for a web app, with one major difference: instead of going through the standard integration process described in the install instructions, you would manually "wrap" any function you want to monitor. For more information, see Non-web tasks and processes. For instructions on monitoring Celery tasks, see Celery background tasks.
What's next after installation?
Once you get New Relic up and running, some suggested next steps are:
- Explore your data in New Relic and get comfortable with the user interface.
- Read some documentation about New Relic APM. For example, read about the Overview page, the Transactions page, and other performance monitoring features.
- Change your application's name, or other configuration options.
- Learn about setting up custom instrumentation for application activity not monitored by default.
After you complete the install process, your data should appear in the New Relic APM UI within five minutes. If it does not, use these troubleshooting resources:
- If no data appears, follow these troubleshooting steps.
- If you experience issues when installing or running the Python agent on a new host, test that the package is installed correctly and that it can contact New Relic's data collector service.
- For other problems, see the full list of troubleshooting documentation.