NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #4953 most downloaded on PyPI
New Relic Telemetry SDK
Last release 11 months ago
23 Oct 2025
Release timing varies
gaps range from 5 weeks to 1.7 years
Most releases are documented
notes for 18 of 22 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
22 releases · first in 2019
Support for Python versions 3.7 and 3.8 have been removed.
Care has been taken to ensure this is not a breaking change for existing users. If for some reason these changes cause issues with installing this pac…
pyproject.toml based build metadata, and digital attestations.
One column per quarter.
Allow arbitrary kwargs configuration on all Client subclasses that passes to urllib3.HTTPSConnectionPool.
send_batch() to more appropriate TypeError.
urllib3.HTTPResponse.Support for Python 2 has been removed.
Support for Python 2 has been removed.
Support for urllib3 versions <1.26.0 has been removed.
Support for urllib3 major version 2 has been added.
Thank you to @pray and @thesuperzapper for contributing to the urllib3 changes!
Added classifiers for Python 3.12 support.
Previous references to the deprecated New Relic Insights Insert Keys have been replaced, going forward New Relic License Keys can be used in their pla…
Support for Python 3.11 has been added.
Previous references to the deprecated New Relic Insights Insert Keys have been replaced, going forward New Relic License Keys can be used in their place. References to keyword arguments that previously were named insert_key are now named license_key.
Python 3.6 support has been removed.
Support for Python 3.10 has been added.
Support for Python 3.10 has been added.
An optional timeout parameter has been added to all client's send and send_batch methods. Thank you to @julcsii for the contribution!
The telemetry SDK now includes the New Relic log formatter, which formats log messages that can later be forwarded with the New Relic infrastructure a
The telemetry SDK now includes the New Relic log formatter, which formats log messages that can later be forwarded with the New Relic infrastructure agent, or other log forwarders. In addition, support has been added so that log structures can be sent directly to New Relic via the Log HTTP API.
Support for Python 3.9 has been added.
A new header named x-request-id, which is a UUID4 value, has been added to all outbound payloads. This header may be used in the future by ingest serv
x-request-id header to outbound payloads (#32)A new header named x-request-id, which is a UUID4 value, has been added to all outbound payloads. This header may be used in the future by ingest services as described in the telemetry sdk specs repository.
Metric.from_value is removed, replaced with metric constructor
Metric.from_value is removed, replaced with metric constructorCountMetric / SummaryMetric interval_ms must be specifiedHarvester.record is removed and replaced with Harvester.batch.record (or simply Batch.record)MetricBatch.record method is removed, replaced with MetricBatch.record_gauge, MetricBatch.record_count, MetricBatch.record_summaryMetricBatch.create_identity interface has been changed to accept name(str), tags (dict), and metric type (str)The telemetry SDK now supports HTTP proxies specified via environment variable and for MacOS/Windows via the operating system registry.
When using the harvester, the client was not closed when the harvester was stopped via the Harvester.stop interface. Clients are now closed when the harvester is stopped.
Metric.from_value will be removed, replaced with metric constructor
Metric.from_value will be removed, replaced with metric constructorCountMetric / SummaryMetric interval_ms must be specifiedHarvester.record is removed and replaced with Harvester.batch.record (or simply Batch.record)MetricBatch.record method is removed, replaced with MetricBatch.record_gauge, MetricBatch.record_count, MetricBatch.record_summaryClient.close interface to force close the connection.All clients support explicitly closing the persistent TCP connection to New Relic via the Client.close method.
When using the harvester with an event client, the harvester crashed when attempting to flush the data. This issue has now been fixed.
The compression_threshold argument has been removed from SpanClient, MetricClient, and EventClient constructors. Code that omits compression_threshold
The compression_threshold argument has been removed from SpanClient, MetricClient, and EventClient constructors. Code that omits compression_threshold from the client argument list will not be impacted.
import os
from newrelic_telemetry_sdk import MetricClient
metric_client = MetricClient(os.environ['NEW_RELIC_INSERT_KEY'])
import os
from newrelic_telemetry_sdk import MetricClient
# compression_threshold has been removed, so the following code will result in an exception
metric_client = MetricClient(os.environ['NEW_RELIC_INSERT_KEY'], compression_threshold=0)
Port can now be overridden via arguments to clients.
import os
from newrelic_telemetry_sdk import SpanClient
span_client = SpanClient(os.environ['NEW_RELIC_INSERT_KEY'], port=8000)
In a future release, all payloads will be gzip compressed. When using the compression_threshold argument, a DeprecationWarning will be printed. For fo…
compression_threshold argument to all clients is now deprecated (#18)In a future release, all payloads will be gzip compressed. When using the compression_threshold argument, a DeprecationWarning will be printed. For forward compatibility, use of the compression_thresold argument in SpanClient, MetricClient, and EventClient should be discontinued.
Events can now be sent to New Relic via the SDK! 🎉 See the documentation for details!
Events can now be sent to New Relic via the SDK! 🎉 See the documentation for details!
Using a custom mapping class without a copy method for tags within batches resulted in a crash. Custom mapping classes are now properly converted to a dict for internal use by batches in the New Relic Python SDK.
SpanBatch, MetricBatch, and Harvester classes have been added. The Harvester will send data aggregated in a batch to a Client's send_batch method at a
SpanBatch, MetricBatch, and Harvester classes have been added. The Harvester will send data aggregated in a batch to a Client's send_batch method at a periodic interval. These classes may be used as helpers to send batch data to New Relic without blocking the application thread. All network activity in the Harvester occurs on a separate thread.
Using a custom mapping class without a copy method for tags on a Span type resulted in a crash. Custom mapping classes are now properly converted to a
copy method raise an AttributeError (#9)Using a custom mapping class without a copy method for tags on a Span type resulted in a crash. Custom mapping classes are now properly converted to a dict for internal use by the New Relic Python SDK.
This telemetry SDK version implements a new Client.add_version_info API as described in the telemetry SDK specification. This API will append a versio
Client.add_version_info API as described in the telemetry SDK specification. This API will append a version string to the user agent header sent to New Relic. See #8 for details.urllib3 is now used as an HTTP client instead of requests. This allows for fewer install dependencies and removes install-time LGPL dependencies. See
urllib3 is now used as an HTTP client instead of requests. This allows for fewer install dependencies and removes install-time LGPL dependencies. See #5 for details.
Default values for CountMetric and SummaryMetric class constructors have been removed. Values must now be explicitly specified when constructing any type of metric. See #6 for details.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Your coding agent can read these notes before it upgrades. Set up the MCP server →