メモ
このリリースのPythonエージェントでは、AIモニタリングのサーバーサイドコンフィグレーションのサポートが追加され、Microsoft Agentフレームワークを介して行われるBedrock呼び出しのコンテキスト伝搬が追加され、リモートMCPサーバーをバックエンドとするLangChainツールの重複するツールエンティティが修正され、ガベージコレクションデータサンプラーの競合状態のリスクが軽減され、Wagtail使用時の不整合なトランザクション名が修正され、送信されるKombuのディストリビューティッド(分散)トレーシングヘッダーからバイトエンコーディングが削除されました。
Python パッケージ インデックス経由でeasy_install/pip/distributeを使用するか、 Conda-Forge パッケージ インデックス経由でcondaを使用してエージェントをインストールするか、 New Relic ダウンロード サイトから直接ダウンロードします。
新機能
AIモニタリングのサーバーサイドコンフィグレーションのサポートを追加
- Pythonエージェントは、AIモニタリングのサーバーサイドコンフィグレーションに対応しました。設定された場合、サーバーサイドの
ai_monitoring.enabled、ai_monitoring.record_content.enabled、およびai_monitoring.streaming.enabledの値がローカル設定よりも優先されます。
- Pythonエージェントは、AIモニタリングのサーバーサイドコンフィグレーションに対応しました。設定された場合、サーバーサイドの
エージェントフレームワークを介したBedrock呼び出しのコンテキスト伝搬を追加
- Microsoft エージェントフレームワークのBedrockインテグレーションによって作成されたスレッド境界を越えて、トレースコンテキストを伝播します。これにより、エージェントの既存のbotocore計装が、エージェントフレームワークを通じて行われたBedrock呼び出しのLLMイベントをキャプチャできるようになります。これは、エージェントフレームワーク自体の完全な計装を追加するものではありません。
バグ
Wagtail使用時の一貫性のないトランザクション名を修正
- 以前は、Wagtail上に構築されたアプリのトランザクション名は一貫性がなく、異なるページビューで同じになることがありました。これは修正されました。
リモートMCPサーバーをバックエンドとするLangChainツールの重複するツールエンティティを修正
- 以前は、LangChainツールが、個別にインストゥルメントされたリモートMCPサーバーをバックエンドとしている場合、重複したツールエンティティがUIに表示されていました。これは、既知のリモートツールが検出された場合に、LangChainツールからサブコンポーネント属性を除外することで修正されました。
LangChainおよびLangGraph MCPツール呼び出しでユーザー入力フィールドが欠落する問題を修正
- 以前は、LangChainまたはLangGraphがMCPサーバーのツールを使用した場合、入力メッセージがストリーミングされたシーケンスの最後のメッセージでないと、AIモニタリングデータからユーザー入力フィールドが欠落する可能性がありました。これは修正され、エージェントはこれらのケースで入力メッセージを正しく抽出するようになりました。
ガベージコレクションデータサンプラーにおける競合状態のリスクを軽減します。
- 以前は、設定に関係なく、エージェントはガベージコレクターのオブジェクト数をサンプリングするために常に
gc.get_objects()を呼び出していました。これは変更され、top_object_count_limitが0より大きく設定されている場合にのみgc.get_objects()が呼び出されるようになり、ガベージコレクターによって収集されたオブジェクトタイプを追跡しない顧客にとって不要なヒープの反復を回避するようになりました。
- 以前は、設定に関係なく、エージェントはガベージコレクターのオブジェクト数をサンプリングするために常に
アウトバウンドのKombuディストリビューティッド(分散)トレーシングヘッダーからバイトエンコーディングを削除
- 以前は、Kombuの計装によって追加されたディストリビューティッド(分散)トレーシングヘッダーがバイトエンコードされていたため、標準ライブラリの
jsonモジュールを使用してペイロードをシリアライズするトランスポート(たとえば、SQLAlchemyをバックエンドとするトランスポート)が正常に動作しなくなっていました。これらのトランスポートが正しく機能するように、バイトエンコーディングは削除されました。
- 以前は、Kombuの計装によって追加されたディストリビューティッド(分散)トレーシングヘッダーがバイトエンコードされていたため、標準ライブラリの
サポートステートメント
最新のエージェント バージョンが利用可能になったらすぐに更新することをお勧めします。最新バージョンにアップグレードできない場合は、エージェントを 90 日以内のバージョンに更新してください。エージェントを最新の状態に保つ方法の詳細については、こちらをご覧ください。
エージェントのリリースとサポート日については、New Relic Python エージェントのEOL ポリシーを参照してください。
メモ
Pythonエージェントのこのリリースでは、Google ADKの計装サポートを追加し、複数のAIプロバイダー(Anthropic、Google生成AI、OpenAI、およびAWS Bedrock)のトークンカウントを追加し、アウトバウンドのtracestateヘッダーサイズを縮小し、graphql-core計装のクラッシュを修正しました。
Python パッケージ インデックス経由でeasy_install/pip/distributeを使用するか、 Conda-Forge パッケージ インデックス経由でcondaを使用してエージェントをインストールするか、 New Relic ダウンロード サイトから直接ダウンロードします。
改善された機能
Google ADKの計装を追加
Pythonエージェントは、Google ADK(Agent Development Kit)AIエージェントのワークフローを計装するようになりました。
インストゥルメントされたコンポーネントとしては、次のものがあります:
LlmAgentgoogle.genai経由でGeminiまたはVertexAIバックエンドにリンクされています- ユーザー定義の
FunctionToolインスタンス - 子エージェントおよび
AgentToolインスタンスを含むサブエージェントのワークフロー Workflowクラス、および非推奨のLoopAgent、ParallelAgent、SequentialAgentクラスを含むマルチエージェントワークフロー
Anthropic、Gemini、OpenAI、およびBedrockのトークンカウントを追加
Pythonエージェントは、複数のAIプロバイダーにわたるすべてのLLM呼び出しのトークンカウントを報告するようになりました:
- Anthropic SDK
- Google生成AI SDK
- OpenAI SDK
- botocoreおよびaiobotocore経由のAWS Bedrock
バグ
graphql-core v3.2.10 の計装のクラッシュを修正しました
- 以前は、graphql-core v3.2.10で
ExecutionContextのerrors属性がcollected_errorsに名前変更されたため、エージェントがクラッシュしていました。この問題は修正され、エージェントはgraphql-core v3.2.10以降で正常に動作するようになりました。
- 以前は、graphql-core v3.2.10で
アウトバウンドの
tracestateヘッダーからspanIdを削除- 以前は、エージェントはアウトバウンドの
tracestateヘッダーにspanIdを含めていました。spanIdはすでにtraceparentヘッダーに存在するため、これは不要な重複でした。アウトバウンドのヘッダーサイズを縮小するため、spanIdはtracestateから削除されました。
- 以前は、エージェントはアウトバウンドの
サポートステートメント
最新のエージェント バージョンが利用可能になったらすぐに更新することをお勧めします。最新バージョンにアップグレードできない場合は、エージェントを 90 日以内のバージョンに更新してください。エージェントを最新の状態に保つ方法の詳細については、こちらをご覧ください。
エージェントのリリースとサポート日については、New Relic Python エージェントのEOL ポリシーを参照してください。
メモ
Pythonエージェントのこのリリースでは、LangChainチェーンLLMイベントに追加のモデル情報を追加し、LangGraphストリーミング計装のバグを修正しました。
Python パッケージ インデックス経由でeasy_install/pip/distributeを使用するか、 Conda-Forge パッケージ インデックス経由でcondaを使用してエージェントをインストールするか、 New Relic ダウンロード サイトから直接ダウンロードします。
改善された機能
LangChain チェーン LLM イベントに追加のモデル情報を追加する
- LangChainチェーンによって生成されたLLMイベントに
request.modelおよびresponse.model属性を追加します。 - この情報はベストエフォートで取得されるため、常に利用可能であるとは限りません。
- LangChainチェーンによって生成されたLLMイベントに
バグ
LangGraphストリーミング計装におけるTypeErrorを修正
- 以前は、LangGraphでストリーミングAPIのサブセットを使用する際、LangGraphによる
weakref.WeakMethodの使用が原因で、エージェントでTypeErrorが発生していました。この問題は修正され、エージェントはそれらのLangGraphストリーミングメソッドで正しく動作するはずです。
- 以前は、LangGraphでストリーミングAPIのサブセットを使用する際、LangGraphによる
サポートステートメント
最新のエージェント バージョンが利用可能になったらすぐに更新することをお勧めします。最新バージョンにアップグレードできない場合は、エージェントを 90 日以内のバージョンに更新してください。エージェントを最新の状態に保つ方法の詳細については、こちらをご覧ください。
エージェントのリリースとサポート日については、New Relic Python エージェントのEOL ポリシーを参照してください。
メモ
Pythonエージェントの今回のリリースでは、複数の新しいRedisコマンドのサポートを追加し、LangGraph計装のバグを修正し、ハーベスト制限設定の処理とロギングを改善しています。
Python パッケージ インデックス経由でeasy_install/pip/distributeを使用するか、 Conda-Forge パッケージ インデックス経由でcondaを使用してエージェントをインストールするか、 New Relic ダウンロード サイトから直接ダウンロードします。
改善された機能
新しいRedis v8.8.0コマンドの計装を追加
redis-py v8.8.0 の 以下の新しいRedisコマンド の計装を追加:
- その他のコマンド:INCREX、XNACK
- 配列コマンド:ARCOUNT、ARDEL、ARDELRANGE、ARGET、ARGETRANGE、ARGREP、ARINFO、ARINSERT、ARLASTITEMS、ARLEN、ARMGET、ARMSET、ARNEXT、AROP、ARRING、ARSCAN、ARSEEK、ARSET
バグ
LangGraph計装でのクラッシュを修正
- 以前は、LangGraphの計装を使用すると、AsyncBackgroundExecutor内のジョブへのコンテキスト伝搬の問題により、エージェントがクラッシュしていました。この問題は修正され、エージェントはLangGraphで正常に動作するはずです。
ハーベスト制限設定の処理とロギングを改善
- エージェントは、New Relic OneのEnvironmentタブにハーベストメソッドと制限のリストをより正確に報告するようになりました。
- エージェントの起動時におけるハーベスト制限設定のデバッグログが、より一貫性を持つようになりました。
サポートステートメント
最新のエージェント バージョンが利用可能になったらすぐに更新することをお勧めします。最新バージョンにアップグレードできない場合は、エージェントを 90 日以内のバージョンに更新してください。エージェントを最新の状態に保つ方法の詳細については、こちらをご覧ください。
エージェントのリリースとサポート日については、New Relic Python エージェントのEOL ポリシーを参照してください。
メモ
Pythonエージェントのこのリリースでは、LangChainおよびLangGraphにおけるコンテキスト伝搬の問題、OpenAIのチャット補完の記録に関する問題、およびLiteLLMをプロキシとして介してOpenAI(https://pypi.org/project/openai)ストリーミングを使用する際の問題が修正されています。
Python パッケージ インデックス経由でeasy_install/pip/distributeを使用するか、 Conda-Forge パッケージ インデックス経由でcondaを使用してエージェントをインストールするか、 New Relic ダウンロード サイトから直接ダウンロードします。
バグ
LangChainおよびLangGraphにおけるコンテキスト伝搬を修正
OpenAIチャットコンプリーションの記録に関する問題を修正
- OpenAI は、消費者がすべてのデータを読み取っていなくてもストリーミングレスポンスを閉じるロジックを再導入しました。以前は、チャットコンプリーションデータはストリームの終端に達したときにのみ記録されていたため、ストリームのクローズ時にチャットコンプリーションデータが記録されない結果となっていました。ストリームが完全に読み取られていない場合でも、チャット完了データをキャプチャするロジックが追加されました。
プロキシとしてLiteLLMを経由してOpenAIストリーミングを使用する際の問題を修正
サポートステートメント
最新のエージェント バージョンが利用可能になったらすぐに更新することをお勧めします。最新バージョンにアップグレードできない場合は、エージェントを 90 日以内のバージョンに更新してください。エージェントを最新の状態に保つ方法の詳細については、こちらをご覧ください。
エージェントのリリースとサポート日については、New Relic Python エージェントのEOL ポリシーを参照してください。
Notes
This release of the Python agent removes support for Python lambda function in the config file, excludes the newrelic header by default, adds support for exclude and include settings for Hybrid Agent traces, anthropic instrumentation, gemini response streaming, improves caching of IS_PYPY in gc_data.py for performance, and adds http.statusCode attribute in transaction events. This release also resends modules during reconnect ensuring they are recorded, guards garbage collection metrics against re-entrant calls, fixes task propagation in async generators and starlette context propagation in StreamingResponse.
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.
Removed features
Remove support for Python lambda functions in the config file
- Previously, the agent allowed specifying a Python lambda function to dynamically name transactions, background task, database trace, profile trace, external trace url and method, function trace, generator trace, and memcache trace. Since support for this feature exposes a security vulnerability in the agent this feature is being removed.
Deprecations
- The
response.statusattribute inWebTransactions is considered deprecated and will be removed in the upcoming 14.0.0 release. It is being replaced byhttp.statusCode. We recommend replacing all references toresponse.statuswithhttp.statusCode.
New features
Exclude the
newrelicheader by default- The
newrelicdistributed tracing header is now no longer sent by default. Only the W3Ctraceparentandtracestateheaders will be sent.
- The
Add exclude and include settings for Hybrid Agent traces
opentelemetry.traces.includefor the configuration file orNEW_RELIC_OPENTELEMETRY_TRACES_INCLUDEto be used as an environment variableopentelemetry.traces.excludefor the configuration file orNEW_RELIC_OPENTELEMETRY_TRACES_EXCLUDEto be used as an environment variable
The Hybrid Agent's default behavior will be different as well. Now, only libraries and tracers that are supported by OpenTelemetry but not already supported by New Relic will utilize OpenTelemetry's instrumentation. Otherwise, the agent will default to the New Relic instrumentation hooks.
More information about these settings can be found in the Python Agent configuration page as well as the OpenTelemetry API support page.
Add Anthropic streaming instrumentation
- Adds instrumentation support for anthropic.
Improve caching of IS_PYPY in gc_data.py for performance
Now checks and caches IS_PYPY once when the module is loaded.
Add Gemini response streaming
- Add response streaming support to Gemini through the google-genai package.
Add
http.statusCodeattribute to transaction events- To conform with the rest of the language agents, the Python agent now sends the http status to the
WebTransactionattributehttp.statusCode. The Python agent will continue to send the attribute toresponse.statusas well, but theresponse.statusattribute will be removed in the future.
- To conform with the rest of the language agents, the Python agent now sends the http status to the
Bugs
Resend modules during reconnect
- The agent previously only sent the module list periodically after the first connect cycle. If the agent reconnected to the collector, this data would not be resubmitted, so the UI would no longer show the module data. This has now been fixed.
Guard garbage collection metrics against re-entrant calls
- Adds a flag to prevent re-entrant calls to
_GCDataSource.record_gc()to prevent infinite recursion on Python 3.13+.
- Adds a flag to prevent re-entrant calls to
Enable task propagation in async generators
- Fixes an issue where
AsyncGeneratorProxywould not properly handle transaction context propagation if spread over multiple tasks.
- Fixes an issue where
Fix Starlette context propagation in
StreamingResponse- Adds trace context propagation to starlette
StreamingResponsefor both synchronous and asynchronous generators.
- Adds trace context propagation to starlette
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.