Python agent release notesRSS

Notes

This release of the Python agent adds support for elasticsearch 8, redis.asyncio, and exposes apdexPerfZone.

Install the agent using easy_install/pip/distribute via the Python Package Index or download it directly from the New Relic download site.

New features

• Add support for eleasicsearch 8 Add instrumentation support for elasticsearch version 8.

• Add support for redis v4.4.1 and v4.4.2 Add support for new methods in the latest versions of redis.

• Add support for redis.asyncio aioredis is included to redis-py since version 4.2.0rc1 as redis.asyncio. Support this new location. Thank you @pauk-slon for your contribution!

• Add apdexPerfZone to web transaction event attribute intrinsics Expose nr.apdexPerfZone as apdexPerfZone in Web transaction event attribute intrinsics.

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 5.6.0.135. More information can be found in the EOL Policy Page.

Notes

This release of the Python agent adds the record_log_event API and includes some bug fixes.

Install the agent using easy_install/pip/distribute via the Python Package Index or download it directly from the New Relic download site.

New features

• Add support for redis v4.3.5 and v4.4.0 methods

  New methods added in redis v4.3.5 and v4.4.0 will now be automatically instrumented.

• Add record_log_event API

  This records a log event that can be viewed and queried in the New Relic UI. See record_log_event for details.

Bug fixes

• Fix RuntimeError: dictionary changed size during iteration

  Properly guard trace_cache from RuntimeErrors raised due to concurrent iteration and size changes of the TraceCache.

• Fix confluent-kafka producer arguments

  Fixes a bug where topic provided as a keyword argument can crash Confluent Kafka producers.

• Patch sentry SDK to correct ASGI v2/v3 detection

  Patches sentry-sdk to fix a bug that causes incorrect ASGI application version detection with our wrapt function wrappers. To fix this, we now instrument the _looks_like_asgi3() function to bind out the wrapped app in sentry in order to unwrap it to be able to detect the proper ASGI version.

• Fix missing information issue with Celery workers when using MAX_TASKS_PER_CHILD

  A bug was introduced in v7.8.0.174 when Celery was run with the --loglevel=INFO flag to not report any data after the original worker processes shut down. This has been fixed.

• Fix support for dynamically generated types in Code Level Metrics

  A bug in code level metrics attribute extraction prevented attributes from being applied to types created using the 3 argument type constructor. This has been fixed.

• Fix external node properties initialization

  A bug caused by uninitialized external node properties when making web requests has been fixed. Thank you @kmorey for your contribution!

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 5.4.1.134. More information can be found in the EOL Policy Page.

Notes

This release of the Python agent increases the custom event limit and includes a bug fix.

Install the agent using easy_install/pip/distribute via the Python Package Index or download it directly from the New Relic download site.

Changes

• Increase custom event limit

  This agent version increases the default limit of custom events from 1,200 events per minute to 3,600 events per minute. In the scenario that custom events were being limited, this change will allow more custom events to be sent to New Relic. There is also a new configurable maximum limit of 100,000 events per minute. To change the limits, see the docs for event_harvest. To learn more about the change and how to determine if custom events are being dropped, see our Explorers Hub post.

Bug fixes

• Fix NewRelicContextFormatter attribute error

  A bug was introduced in v8.3.0 that caused an AttributeError when using the NewRelicContextFormatter. This has been corrected in this release version.

Notes

This release of the Python agent adds Python 3.11 support, deprecates the add_custom_parameter(s) API, adds usage metrics for multiple libraries, and includes bug fixes.

Install the agent using easy_install/pip/distribute via the Python Package Index or download it directly from the New Relic download site.

Deprecations

• add_custom_parameter(s) API is now deprecated The add_custom_parameter(s) API has been renamed to add_custom_attribute(s). A deprecation warning will be emitted when calling add_custom_parameter() from this agent version and higher.

New features

• Add support for Python 3.11 The agent now supports applications running in Python 3.11.

• Add usage metrics for Kafka clients, Daphne, and Hypercorn The agent now emits a messagebroker metric for Kafka clients and a dispatcher metric for Daphne and Hypercorn. This metric is similar to the framework metric already being emitted for all web frameworks supported by the agent.

Bug fixes

• Fix Flask view support for Code Level Metrics The agent was previously reporting the class name for the code.function attribute in the case of Flask method dispatching. This has been corrected to report the instrumented function name.

• Fix aioredis version crash A fix has been implemented to address a crash in aioredis in cases where the agent was initialized before importing aioredis on aioredis>=2.0.1.

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 5.2.2.130. More information can be found in the EOL Policy Page.

Notes

This release of the Python agent provides numerous bug fixes, including several community contributions, provides updates to Sanic instrumentation, Protobuf v4 compatiblity, and updates internal packages for Python 3.11 support.

Install the agent using easy_install/pip/distribute via the Python Package Index or download it directly from the New Relic download site.

Version numbering change

The version number of the agent did not previously follow Semantic Versioning properly. This has been changed. Going forward build numbers have been removed from the version number, and version increments will follow semantic versioning fully. No retroactive changes will be made to previous version numbers.

Instrumentation updates

• Update Sanic middleware support

  Sanic recently changed their APIs surrounding middleware, and instrumentation has been updated to support it.

Package updates

• Update wrapt to v1.14.1

  The internal copy of the wrapt library used by the agent has been updated to v1.14.1 for Python 3.11 compatibility.

• Add support for Protobuf v4

  The agent is now fully compatible with Protobuf v4 when using Infinite Tracing. Backwards compatibility with Protobuf v3 has been preserved.

Bug fixes

• Fix a RuntimeError in the trace cache when using the coroutine profiler

  A RuntimeError occurred if traces were started or stopped while the coroutine profiler was sampling the active traces. This should no longer be possible.

  Thank you @lovmat for your contribution!

• Fix an issue with case sensitivity in record-deploy

  Previously application names were incorrectly being treated as case-sensitive when running newrelic-admin record-deploy.

  Thank you @michalborkowski96 for your contribution!

• Fix an issue with newer installers failing to install the agent

  Due to the inclusion of both scripts and entry_points configuration options, the agent would fail to install with newer installers. This has been corrected and newer PEP compliant installers should have no trouble installing the agent.

  Thank you @admp-fh for your contribution!

• Fix instrumentation for aioredis interfering with transactions

  The agent does not currently support transactions for Redis clients, and previous instrumentation broke transaction functionality in AioRedis. This has been fixed to provide no instrumentation within transactions at this time.

• Fix a crash when completing various kinds of traces inside a stopped transaction

  Previously certain types of traces could throw exceptions and fail to complete when inside stopped transactions. This has been corrected and should no longer be possible.

• Fix a bug where instrumentation caused certain arguments to confluent-kafka producers to stop working

  Previously callback and on_delivery arguments were passed through improperly leading to them not working as expected.

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 5.2.2.130. More information can be found in the EOL Policy Page.

Notes

This release of the Python agent adds automatic instrumentation for Kafka Python as well as Confluent Kafka.

Install the agent using easy_install/pip/distribute via the Python Package Index or download it directly from the New Relic download site.

New features

• Add kafka-python instrumentation

  Instrumentation has been added for Kafka Python.

• Add confluent-kafka instrumentation

  Instrumentation has been added for Confluent Kafka.

More information can be found in the Message Queue documentation

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 5.2.0.127. More information can be found in the EOL Policy Page.

Notes

This release of the Python agent adds automatic instrumentation for Hypercorn, and includes bug fixes for Sanic v21.9+, memory sampler reporting, and database traces.

Install the agent using easy_install/pip/distribute via the Python Package Index or download it directly from the New Relic download site.

New features

• Add Hypercorn instrumentation

  Instrumentation has been added for Hypercorn, an ASGI web server.

Bug fixes

• Fix instrumentation for Sanic v21.9+

  Instrumentation for newer versions of Sanic (>=21.9) have either not reported data or crashed due to an incompatibility with Sanic's internal metaprogramming.

• Fix incorrect PID reported by memory sampler

  The PID reported by the memory sampler when sampling processes was incorrectly attributed to the process the agent was initialized from.

• Fix issue with database traces causing crashes

  In rare instances a database trace could result in a setting not being found, causing a crash.

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 5.2.0.127.

Notes

This release of the Python agent removes support for Python 3.6. It also includes new instrumentation for Daphne, reporting installed module versions, and a fix for a bug affecting Loguru file paths.

Install the agent using easy_install/pip/distribute via the Python Package Index or download it directly from the New Relic download site.

Deprecations

• Removed support for Python 3.6

  Python 3.6 is no longer supported by the agent. Please consider upgrading your application to a supported version of Python in order to continue to receive updates to the Python Agent.

New features

• Add Daphne instrumentation

  Instrumentation has been added for Daphne, a Django project ASGI web server and the recommended server for Django Channels.

• Add module version reporting

  Installed python packages now have their versions reported and are visible in the Environment tab for your application in New Relic One.

Bug fixes

• Fix a bug in file path detection for Loguru

  Wrappers from the agent interfered with Loguru file path detection for templating messages. This has been corrected on all versions. Thank you to @rafaelclp for your contribution!

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 5.0.2.126.

Notes

This release of the Python agent enables log forwarding to New Relic by default. It also addresses a bug related to compressed bytes calculations and adds a new top level data usage supportability metric to the agent.

Install the agent using easy_install/pip/distribute via the Python Package Index or download it directly from the New Relic download site.

New features

• Add APM logs in context

  Automatic application log forwarding is now enabled by default. This version of the agent will automatically send enriched application logs to New Relic. To learn more about about this feature, see the APM logs in context documentation. For additional configuration options, see the Python logs in context documentation. To learn about how to toggle log ingestion on or off by account, see our documentation to disable automatic logging via the UI or API.

• Add top level aggregated data usage supportability metric

  The agent now reports a top level data usage supportability metric: Supportability/Python/Collector/Output/Bytes. This aggregates all uncompressed bytes across all agent methods sent to New Relic.

Changes

• Change data usage supportability metric name

  Previously, the agent reported data usage supportability metrics in the format Supportability/Python/Collector/Output/Bytes/<agent_method>. This has been changed to be in the format Supportability/Python/Collector/<agent_method>/Output/Bytes to align with the agent specification.

Bug fixes

• Fix data usage supportability metric compression payload calculation

  Previously, the agent was reporting the compressed bytes for the Supportability/Python/Collector/Output/Bytes metric group and uncompressed bytes for the Supportability/Python/Collector/ZLIB/Bytes metric group. This was incorrect and has been fixed in this release.

Support statement

New Relic recommends that you upgrade the agent regularly and at a minimum every 3 months. As of this release, the oldest supported version is 5.0.0.124.