newrelic
New Relic Python Agent
What it is and what it does
The newrelic package is a production-grade APM agent that instruments Python web applications to send performance data to New Relic's monitoring platform. It works by wrapping WSGI servers and application code to capture request traces, database queries, external API calls, and errors in real time. The agent runs as a background process with no runtime dependencies, collecting metrics on response times, throughput, and error rates.
Integration happens via either a wrapper script (prefixing your WSGI server startup with `newrelic-admin run-program`) or manual code initialization at the top of your WSGI application file. After configuration with your license key and environment variables, the agent automatically begins sending data to New Relic's UI where you can view dashboards, drill into slow transactions, and set up alerts. It supports Python 3.9 through 3.14 and both CPython and PyPy implementations.
Use it for:
- Monitor response times and identify slow endpoints in production WSGI applications.
- Trace database queries and third-party API calls to pinpoint performance bottlenecks.
- Capture and analyze application errors with stack traces and context for debugging.
- Track application scalability and throughput under production traffic loads.
- Set up alerts for performance degradation or error rate spikes in real time.
Worth the install?
AI-flagged interpretation of the facts on this page — verify before relying
Instruments Python web applications to collect performance metrics, traces, and errors for real-time monitoring and analysis through New Relic's APM platform.
Yes, if you run a Python WSGI application in production and need real-time performance visibility. The agent is actively maintained, has no external dependencies, and integrates cleanly with standard deployment patterns. Requires a New Relic account and license key; the medium install friction is offset by comprehensive platform integration and production-grade stability.
Install
newrelic on PyPI
pip
pip install newrelicuv
uv add newrelicpoetry
poetry add newrelicInstalling newrelic
Before you install
Medium install friction due to compiled wheels for multiple Python versions and architectures, but actively maintained with a recent release (15 days ago) and active repository status.
License in practice
Licensed under Apache 2.0, a permissive license allowing commercial and private use with minimal restrictions—safe to use in most projects.
Quickstart
pip install newrelic
newrelic-admin generate-config $YOUR_LICENSE_KEY newrelic.ini
NEW_RELIC_CONFIG_FILE=newrelic.ini newrelic-admin run-program gunicorn app.wsgi
Requires a New Relic license key and account; agent initialization must happen before application startup.
Verify before relying
- Whether the agent supports async frameworks beyond WSGI (e.g., FastAPI, Starlette) or only traditional WSGI applications.
- Performance overhead and memory footprint of the agent in production environments.
- Whether PyPy support listed in classifiers is fully tested and production-ready.
Package facts
| License | Apache-2.0 (permissive) |
| Python support | supports the current Python release (>=3.9) |
| Install friction | medium — platform-specific wheel |
| Runtime dependencies | none |
| Maintenance | actively maintained — 15 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 4,840,389/month — #2,217 on PyPI (30-day window, as of 2026-08-14) |
| Known vulnerabilities | none known (OSV.dev, checked 2026-08-14) |
Evidence: newrelic-13.4.0-cp310-cp310-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl; newrelic-13.4.0-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl; newrelic-13.4.0-cp310-cp310-musllinux_1_2_aarch64.whl; newrelic-13.4.0-cp310-cp310-musllinux_1_2_x86_64.whl; newrelic-13.4.0-cp311-cp311-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl; newrelic-13.4.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl; newrelic-13.4.0-cp311-cp311-musllinux_1_2_aarch64.whl; newrelic-13.4.0-cp311-cp311-musllinux_1_2_x86_64.whl; newrelic-13.4.0-cp312-cp312-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl; newrelic-13.4.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl; newrelic-13.4.0-cp312-cp312-musllinux_1_2_aarch64.whl; newrelic-13.4.0-cp312-cp312-musllinux_1_2_x86_64.whl; newrelic-13.4.0-cp313-cp313-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl; newrelic-13.4.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl; newrelic-13.4.0-cp313-cp313-musllinux_1_2_aarch64.whl; newrelic-13.4.0-cp313-cp313-musllinux_1_2_x86_64.whl; newrelic-13.4.0-cp313-cp313t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl; newrelic-13.4.0-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl; newrelic-13.4.0-cp313-cp313t-musllinux_1_2_aarch64.whl; newrelic-13.4.0-cp313-cp313t-musllinux_1_2_x86_64.whl
Tags
More Monitoring packages
Wraps any iterable to display a real-time…
copyleft · top 100 on PyPI
opentelemetry-semantic-conventionsProvides generated Python code for…
permissive · top 100 on PyPI
opentelemetry-sdkProvides the reference implementation of the…
permissive · top 100 on PyPI
opentelemetry-apiProvides the abstract API and interfaces for…
permissive · top 100 on PyPI
opentelemetry-exporter-otlp-proto-httpExports OpenTelemetry observability data to an…
permissive · top 1,000 on PyPI
opentelemetry-instrumentationProvides automatic instrumentation commands and…
permissive · top 1,000 on PyPI
newrelic-apiA Python client for interacting with New…
permissive · top 15,000 on PyPI
newrelic-telemetry-sdkSends custom metrics, events, logs, and…
permissive · top 5,000 on PyPI
elastic-apmElastic APM is the official Python agent for…
permissive · top 5,000 on PyPI
scout-apmScout APM is a Python application performance…
permissive · top 15,000 on PyPI
opentelemetry-instrumentation-fastapiAutomatically instruments FastAPI applications…
permissive · top 1,000 on PyPI
ddtraceddtrace instruments Python applications to send…
permissive · top 1,000 on PyPI
opentelemetry-instrumentation-openai-agentsAdds distributed tracing to OpenAI Agents…
permissive · top 5,000 on PyPI
opentelemetry-instrumentation-system-metricsCollects system performance metrics (CPU,…
permissive · top 5,000 on PyPI
opentelemetry-instrumentation-wsgiProvides WSGI middleware for OpenTelemetry that…
permissive · top 1,000 on PyPI
coralogix-opentelemetryProvides OpenTelemetry extensions for Python…
unclear · top 15,000 on PyPI