Notes
This release of the Python agent adds instrumentation for Microsoft Agent Framework and CrewAI, improves LaunchDarkly feature flag instrumentation and span forwarding support, and fixes several crashes.
Install the agent using easy_install/pip/distribute via the Python Package Index, using conda via the Conda-Forge Package Index, or download it directly from the New Relic download site.
New features
New instrumentation for Microsoft Agent Framework
- Instrumentation was added for tools and agents in the
agent-frameworkpackage. - Multi-agent configurations are not yet instrumented.
- Instrumentation was added for tools and agents in the
New instrumentation for CrewAI
- Instrumentation was added for agents, crews, and tools in the
crewaipackage.
- Instrumentation was added for agents, crews, and tools in the
Enhanced features
Improved LaunchDarkly feature flag integration.
preview
We're still working on this feature, but we'd love for you to try it out!
This feature is currently provided as part of a preview program pursuant to our pre-release policies.
To opt-in to our public preview integration with LaunchDarkly, enable the settings
launch_darkly_integration.enabledandopentelemetry.enabledin your config file.Improved feature flag instrumentation in ldclient.
- Added the new
feature_flag.url.fullattribute to enable deep UI linking. - Changed the case of the
inExperimentkey to match LaunchDarkly. - Added support for falsy values in feature flag attributes.
- Reduced all LaunchDarkly integration warnings to display only once.
- Added the new
Improved span forwarding for ldobserve.
- Added the
nr.entity.guidandnr.entity.urlspan attributes to enable deep UI linking. - Corrected span parenting to allow proper nesting in the UI.
- Added the
Bug fixes
- Fixed a crash in
TimeTracewhen attributes wasNonein_add_span_event_event. - Fixed a crash in the LaunchDarkly
Configwrapper when falling back to default values.
Support statement
We recommend updating to the latest agent version as soon as it's available. If you can't upgrade to the latest version, update your agents to a version no more than 90 days old. Read more about keeping agents up to date.
See the New Relic Python agent EOL policy for information about agent releases and support dates.
メモ
Pythonエージェントの今回のリリースでは、OpenAI Responsesの計装と、Valkeyの新しいhsetexコマンドが追加されました。
Python パッケージ インデックス経由でeasy_install/pip/distributeを使用するか、 Conda-Forge パッケージ インデックス経由でcondaを使用してエージェントをインストールするか、 New Relic ダウンロード サイトから直接ダウンロードします。
新機能
OpenAI Responsesの新しい計装
- Responses APIをターゲットとする、
openaiSDKのclient.responsesメソッドに計装が追加されました。 - これは、引き続きサポートされている古い
client.chat.completionsメソッドおよびChat Completions APIの既存の計装に対する追加です。
- Responses APIをターゲットとする、
機能の拡充
新しいValkeyコマンドのサポートを追加しました:
hsetexコマンドがサポートされるようになりました。
サポートステートメント
最新のエージェント バージョンが利用可能になったらすぐに更新することをお勧めします。最新バージョンにアップグレードできない場合は、エージェントを 90 日以内のバージョンに更新してください。エージェントを最新の状態に保つ方法の詳細については、こちらをご覧ください。
エージェントのリリースとサポート日については、New Relic Python エージェントのEOL ポリシーを参照してください。
メモ
このPythonエージェントのリリースでは、Azure App Servicesの利用状況、Azure Service Busの計装、新しいKinesisメソッドのサポート、およびv2.10.0以降のGoogle ADKのサポートが追加されています。また、このリリースでは、httplibでディストリビューティッド(分散)トレーシングのトレースヘッダーが重複する問題、およびsetup.pyインストレーションファイルを修正しています。
Python パッケージ インデックス経由でeasy_install/pip/distributeを使用するか、 Conda-Forge パッケージ インデックス経由でcondaを使用してエージェントをインストールするか、 New Relic ダウンロード サイトから直接ダウンロードします。
削除された機能
Python 3.9のサポートを削除しました。
- Python 3.9は2025年10月31日にEnd-of-Lifeを迎え、エージェントではサポートされなくなりました。Pythonエージェントのアップデートを引き続き受け取るには、アプリケーションをサポートされているバージョンのPythonにアップグレードすることをご検討ください。
新機能
Azureアプリサービスの利用率
- エンティティ関係のマッピングを有効にするため、Azure App Serviceの使用率が追加されました。
- また、新しい設定も追加されます、
utilization.detect_azureappservice
Azure Service Bus向けの新しい計装
- Microsoft Azure Service Busの計装が追加されました。
新しいKinesisメソッド向けの新しい計装
- Kinesisで
update_stream_record_distribution_strategyメソッドがサポートされるようになりました。
- Kinesisで
パブリックプレビュー版のLaunchDarklyインテグレーションを追加しました。
- LaunchDarklyとのパブリックプレビューのインテグレーションにオプトインするには、設定ファイルで
launch_darkly_integration.enabledおよびopentelemetry.enabledの設定を有効にしてください。
- LaunchDarklyとのパブリックプレビューのインテグレーションにオプトインするには、設定ファイルで
セキュリティアップデート
urllib3の現在のすべてのCVEを解決するために、内部のurllib3パッケージが2.8.0に更新されました。- これにより、現時点までのエージェントにおけるすべての既知のCVEが解決されます。
機能の拡充
Google ADK v2.10.0以降をサポートしています。
- バージョン2.10.0以上のGoogle ADK向けに計装が更新されました。
バグ
httplibにおける重複したディストリビューティッド(分散)トレーシングヘッダー
httplibの計装がtraceparentに対して重複するヘッダーを生成し、不正な値になる問題を修正しました。
setup.pyサポートされているすべてのPythonバージョンでインストールファイルが動作するようになりました。- ユーザーが
setup.pyファイルを直接使用してPython 3.12以上にPythonエージェントをインストールしようとすると、ImportErrorが発生します。これは、distutilsがPython 3.10以降非推奨となり、Python 3.12の標準ライブラリから完全に削除されたためです。
- ユーザーが
サポートステートメント
最新のエージェント バージョンが利用可能になったらすぐに更新することをお勧めします。最新バージョンにアップグレードできない場合は、エージェントを 90 日以内のバージョンに更新してください。エージェントを最新の状態に保つ方法の詳細については、こちらをご覧ください。
エージェントのリリースとサポート日については、New Relic Python エージェントのEOL ポリシーを参照してください。
メモ
Pythonエージェントの今回のリリースでは、botocore(SigV4)の署名付きヘッダーに関する問題が修正されています。
Python パッケージ インデックス経由でeasy_install/pip/distributeを使用するか、 Conda-Forge パッケージ インデックス経由でcondaを使用してエージェントをインストールするか、 New Relic ダウンロード サイトから直接ダウンロードします。
バグ
botocore(SigV4)の署名付きヘッダーに関する問題を修正しました。
- ヘッダーが重複して送信されるのを防ぐため、botocoreのディストリビューティッド(分散)トレーシングヘッダーに対する以前の変更は元に戻されました。
- 以前は、他のトレーシングライブラリによって生成されたディストリビューティッド(分散)トレーシングヘッダーが、ヘッダーの署名によりbotocoreの計装に問題を引き起こす可能性がありました。この問題は、botocore内でこれらのヘッダーの署名を無効にすることで修正されました。
サポートステートメント
最新のエージェント バージョンが利用可能になったらすぐに更新することをお勧めします。最新バージョンにアップグレードできない場合は、エージェントを 90 日以内のバージョンに更新してください。エージェントを最新の状態に保つ方法の詳細については、こちらをご覧ください。
エージェントのリリースとサポート日については、New Relic Python エージェントのEOL ポリシーを参照してください。
メモ
Pythonエージェントの今回のリリースでは、OpenSearch、Microsoft Azure SQL、新しいKinesisメソッド、および新しいbrowser_monitoring.version設定のサポートが追加されました。さらに、Anthropic、MCP、およびGoogle ADKの計装に改善が加えられました。このリリースでは、botocore(SigV4)の署名付きヘッダーとGeminiツールの解析に関する問題も修正されています。
Python パッケージ インデックス経由でeasy_install/pip/distributeを使用するか、 Conda-Forge パッケージ インデックス経由でcondaを使用してエージェントをインストールするか、 New Relic ダウンロード サイトから直接ダウンロードします。
新機能
opensearch-pyの新しい計装
- 公式のOpenSearchデータベースコネクタに計装が追加されました。
mssql-python向けの新しい計装
- Microsoft Azure SQLの計装が追加されました。
新しいKinesisメソッドの新しい計装
Kinesisで以下のメソッドがサポートされるようになりました:
create_channeldelete_channeldescribe_channellist_channelsupdate_channel
の新しい設定
browser_monitoring.version- 新しい設定
browser_monitoring.versionにより、ユーザーは挿入されるブラウザ監視エージェントの特定のバージョンを指定できるようになります。 - 選択可能なサポートされているBrowserエージェントのバージョンのリストをご覧ください。
- 新しい設定
改善された機能
anthropicのサポートが改善されました。
- バージョン1.0.0以上のAnthropic SDKにおけるリクエストパラメーターの解析が改善されました。
Messages.with_raw_response.create経由のレスポンスの新しい解析により、LangChainとの互換性が向上しました。
mcp v2.0.0以降をサポートしました。
mcpv2.0.0で行われた大規模なリファクタリングに伴い、計装が更新され、再び期待通りに動作するはずです。
Google ADK v2.9.0以上のサポート。
- バージョン2.9.0以上のGoogle ADK向けに計装が更新されました。
バグ
botocore(SigV4)の署名付きヘッダーに関する問題を修正しました。
- 以前は、他のトレーシングライブラリによって生成されたディストリビューティッド(分散)トレーシングのヘッダーが、ヘッダーの署名が原因でbotocoreの計装に問題を引き起こす可能性がありました。この問題は修正され、ディストリビューティッド(分散)トレーシングのヘッダーは署名前に変更されるようになりました。
Geminiツールの解析の修正
- 以前は、Geminiで作成されたツールのいくつかのインスタンスが解析に失敗し、エラーを出さずに失敗して、その特定のリクエストに対するレスポンスが返されないことがありました。この問題は修正されました。
サポートステートメント
最新のエージェント バージョンが利用可能になったらすぐに更新することをお勧めします。最新バージョンにアップグレードできない場合は、エージェントを 90 日以内のバージョンに更新してください。エージェントを最新の状態に保つ方法の詳細については、こちらをご覧ください。
エージェントのリリースとサポート日については、New Relic Python エージェントのEOL ポリシーを参照してください。
Notes
This release of the Python agent adds support for Azure CosmosDB, adds instrumentation for HTTPX2 and new LangChain/LangGraph streaming events APIs, adds support for newer OpenTelemetry database semantic conventions, and resolves several issues including incomplete package reporting, a package lookup performance penalty, and a MySQL database name reporting bug.
Install the agent using easy_install/pip/distribute via the Python Package Index, using conda via the Conda-Forge Package Index, or download it directly from the New Relic download site.
New features
Added support for Azure CosmosDB
- The Python agent now instruments Azure Cosmos DB client operations, reporting datastore metrics and traces for database, container, and user operations performed through the
azure-cosmosSDK.
- The Python agent now instruments Azure Cosmos DB client operations, reporting datastore metrics and traces for database, container, and user operations performed through the
Added support for HTTPX2
Added LangChain/LangGraph streaming events instrumentation
Added support for newer OpenTelemetry database semantic conventions
- When running the Python agent alongside OpenTelemetry (Hybrid Agent mode), the agent now reads both the legacy and newer OpenTelemetry database span attribute names (
db.name/db.namespace,db.statement/db.query.text,db.mongodb.collection/db.collection.name), so database tracing continues to work correctly regardless of which semantic convention version the OpenTelemetry instrumentation library emits.
- When running the Python agent alongside OpenTelemetry (Hybrid Agent mode), the agent now reads both the legacy and newer OpenTelemetry database span attribute names (
Bugs
Fixed incomplete package reporting to New Relic
- Previously, the Python agent could omit some installed packages from the Environment data reported to New Relic if module discovery took longer than the fixed time window allotted during the slow harvest cycle, and the package list wasn't refreshed after an agent restart. Package capture now runs during the fast harvest cycle and is fully re-captured on agent shutdown/restart, so the reported package list is complete.
Reduced overhead of package version lookups
- Previously, looking up installed package versions rescanned the filesystem for every package on every lookup, incurring an O(n^2) time penalty that scaled with the number of installed packages during agent initialization. The result of
importlib.metadata.packages_distributions()is now cached after the first lookup to avoid this overhead.
- Previously, looking up installed package versions rescanned the filesystem for every package on every lookup, incurring an O(n^2) time penalty that scaled with the number of installed packages during agent initialization. The result of
Fixed
get_linking_metadatato properly pass through the specified application- Previously, calling
newrelic.agent.get_linking_metadata(application=...)ignored theapplicationargument and always returned linking metadata for the default application. This affected processes reporting to more than one application. The specified application is now correctly passed through. - Thank you ckarnell for the contribution!
- Previously, calling
Fixed MySQL database name reporting when using the
databasekeyword argument- Previously, the agent only checked the legacy
dbkeyword argument when parsing the database name from mysql-connector-python connection arguments, so connections made using the moderndatabasekeyword argument reported no database name in datastore metrics. The agent now checksdatabasefirst, falling back todb.
- Previously, the agent only checked the legacy
Fixed warning when accessing LangGraph v1.1+
GraphOutputvalues- Previously, LangGraph v1.1+ instrumentation accessed
GraphOutputreturn values using deprecated item-access syntax, triggering a deprecation warning. The agent now readsGraphOutput.valuedirectly.
- Previously, LangGraph v1.1+ instrumentation accessed
Support statement
We recommend updating to the latest agent version as soon as it's available. If you can't upgrade to the latest version, update your agents to a version no more than 90 days old. Read more about keeping agents up to date.
See the New Relic Python agent EOL policy for information about agent releases and support dates.