Python agent release notesRSS

Notes

This release of the Python agent adds instrumentation support for Google ADK, adds token counting for multiple AI providers (Anthropic, Google GenAI, OpenAI, and AWS Bedrock), reduces outbound tracestate header size, and fixes a crash in graphql-core instrumentation.

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.

Improved Features

• Added instrumentation for Google ADK

  • The Python agent now instruments Google ADK (Agent Development Kit) AI agent workflows.
  • Instrumented components include:
    • LlmAgent linked to Gemini or VertexAI backends via google.genai
    • User-defined FunctionTool instances
    • Sub-agent workflows including child agents and AgentTool instances
    • Multi-agent workflows including the Workflow class and deprecated LoopAgent, ParallelAgent, and SequentialAgent classes

• Added token counting for Anthropic, Gemini, OpenAI, and Bedrock

  • The Python agent now reports token counts for all LLM invocations across multiple AI providers:
    • Anthropic SDK
    • Google GenAI SDK
    • OpenAI SDK
    • AWS Bedrock via botocore and aiobotocore

Bugs

• Fixed instrumentation crash for graphql-core v3.2.10

  • Previously, graphql-core v3.2.10 renamed the errors attribute to collected_errors in ExecutionContext, causing the agent to crash. This has been fixed, and the agent now works correctly with graphql-core v3.2.10 and later.

• Removed spanId from outbound tracestate header

  • Previously, the agent included spanId in the outbound tracestate header. Because spanId is already present in the traceparent header, this was unnecessary duplication. The spanId has been removed from tracestate to reduce outbound header size.

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エージェントのこのリリースでは、LangChainチェーンLLMイベントに追加のモデル情報を追加し、LangGraphストリーミング計装のバグを修正しました。

Python パッケージ インデックス経由でeasy_install/pip/distributeを使用するか、 Conda-Forge パッケージ インデックス経由でcondaを使用してエージェントをインストールするか、 New Relic ダウンロード サイトから直接ダウンロードします。

改善された機能

• LangChain チェーン LLM イベントに追加のモデル情報を追加する

  • LangChainチェーンによって生成されたLLMイベントにrequest.modelおよびresponse.model属性を追加します。
  • この情報はベストエフォートで取得されるため、常に利用可能であるとは限りません。

バグ

• LangGraphストリーミング計装におけるTypeErrorを修正

  • 以前は、LangGraphでストリーミングAPIのサブセットを使用する際、LangGraphによるweakref.WeakMethodの使用が原因で、エージェントでTypeErrorが発生していました。この問題は修正され、エージェントはそれらの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におけるコンテキスト伝搬を修正

  • より幅広いアプリケーション構造をサポートするために、LangChainおよびLangGraphに追加のトランザクションコンテキスト伝搬を追加します。

• OpenAIチャットコンプリーションの記録に関する問題を修正

  • OpenAI は、消費者がすべてのデータを読み取っていなくてもストリーミングレスポンスを閉じるロジックを再導入しました。以前は、チャットコンプリーションデータはストリームの終端に達したときにのみ記録されていたため、ストリームのクローズ時にチャットコンプリーションデータが記録されない結果となっていました。ストリームが完全に読み取られていない場合でも、チャット完了データをキャプチャするロジックが追加されました。

• プロキシとしてLiteLLMを経由してOpenAIストリーミングを使用する際の問題を修正

  • 以前は、OpenAI SDKをLiteLLMプロキシサーバー経由で接続する際、終了理由が欠落しているためにLLMレスポンスデータのレポートが失われる可能性がありました。この問題は修正され、レスポンスが常に記録されるようになりました。

サポートステートメント

最新のエージェント バージョンが利用可能になったらすぐに更新することをお勧めします。最新バージョンにアップグレードできない場合は、エージェントを 90 日以内のバージョンに更新してください。エージェントを最新の状態に保つ方法の詳細については、こちらをご覧ください。

エージェントのリリースとサポート日については、New Relic Python エージェントのEOL ポリシーを参照してください。

メモ

Pythonエージェントの今回のリリースでは、設定ファイルでのPython Lambda関数のサポートを削除し、デフォルトでnewrelicヘッダーを除外し、Hybridエージェントトレースの除外および包含設定、anthropicの計装、geminiのレスポンスストリーミングのサポートを追加し、パフォーマンス向上のためにgc_data.pyでのIS_PYPYのキャッシュを改善し、トランザクションイベントにhttp.statusCode属性を追加します。このリリースではまた、再接続時にモジュールを再送信して確実に記録されるようにし、ガベージコレクションのメトリクスをリエントラント呼び出しから保護し、非同期ジェネレーターでのタスク伝搬、およびStreamingResponseでのstarletteのコンテキスト伝搬を修正します。

Python パッケージ インデックス経由でeasy_install/pip/distributeを使用するか、 Conda-Forge パッケージ インデックス経由でcondaを使用してエージェントをインストールするか、 New Relic ダウンロード サイトから直接ダウンロードします。

削除された機能

• 設定ファイル内のPython Lambda関数のサポートを削除

  • 以前は、エージェントでPythonのLambda関数を指定して、トランザクション、バックグラウンドタスク、データベーストレース、プロファイルトレース、外部トレースのURLとメソッド、関数トレース、ジェネレータートレース、およびmemcacheトレースに動的に名前を付けることができました。この機能のサポートにより、エージェントにセキュリティの脆弱性が生じるため、この機能は削除されます。

廃止予定

• WebTransactionsのresponse.status属性は非推奨とみなされており、今後の14.0.0リリースで削除される予定です。http.statusCodeに置き換えられます。response.statusへのすべての参照をhttp.statusCodeに置き換えることを推奨します。

新機能

• デフォルトでnewrelicヘッダーを除外する

  • newrelicのディストリビューティッド（分散）トレーシングヘッダーは、デフォルトでは送信されなくなりました。W3Cのtraceparentおよびtracestateヘッダーのみが送信されます。

• Hybrid エージェントのトレースの除外および包含設定を追加する

  • opentelemetry.traces.include 設定ファイル用、または環境変数として使用するNEW_RELIC_OPENTELEMETRY_TRACES_INCLUDE
  • opentelemetry.traces.exclude 設定ファイル用、または環境変数として使用するNEW_RELIC_OPENTELEMETRY_TRACES_EXCLUDE

  ハイブリッドエージェントのデフォルトの動作も異なります。現在、OpenTelemetryでサポートされているが、New Relicではまだサポートされていないライブラリとトレーサーのみが、OpenTelemetryの計装を利用します。そうでない場合、エージェントはデフォルトでNew Relicの計装フックを使用します。

  これらの設定の詳細については、Pythonエージェント設定ページおよびOpenTelemetry APIサポートページを参照してください。

• Anthropicストリーミング計装を追加

  • anthropicの計装サポートを追加します。

• パフォーマンス向上のため、gc_data.pyにおけるIS_PYPYのキャッシュを改善

• モジュールがロードされたときに IS_PYPY を1回チェックしてキャッシュするようになりました。

• Geminiレスポンスストリーミングの追加

  • google-genai パッケージを通じて、Gemini にレスポンス ストリーミング サポートを追加します。

• トランザクションイベントにhttp.statusCode属性を追加する

  • 他の言語エージェントに合わせるため、PythonエージェントはhttpステータスをWebTransaction属性http.statusCodeに送信するようになりました。Pythonエージェントは引き続きresponse.statusにも属性を送信しますが、response.status属性は将来的に削除されます。

バグ

• 再接続中にモジュールを再送信する

  • エージェントは以前、最初の接続サイクル後にのみ定期的にモジュールリストを送信していました。エージェントがコレクターに再接続した場合、このデータは再送信されないため、UIにはモジュールデータが表示されなくなります。これは修正されました。

• ガベージコレクションのメトリクスをリエントラント呼び出しから保護する

  • Python 3.13以降での無限再帰を防ぐため、_GCDataSource.record_gc()への再入呼び出しを防止するフラグを追加します。

• 非同期ジェネレーターでのタスク伝播を有効にする

  • 複数のタスクにまたがる場合にAsyncGeneratorProxyがトランザクションコンテキスト伝搬を適切に処理しない問題を修正します。

• Starletteのコンテキスト伝搬を修正: StreamingResponse

  • 同期および非同期ジェネレーターの両方に対して、starletteStreamingResponseにトレースコンテキスト伝搬を追加します。

サポートステートメント

最新のエージェント バージョンが利用可能になったらすぐに更新することをお勧めします。最新バージョンにアップグレードできない場合は、エージェントを 90 日以内のバージョンに更新してください。エージェントを最新の状態に保つ方法の詳細については、こちらをご覧ください。

エージェントのリリースとサポート日については、New Relic Python エージェントのEOL ポリシーを参照してください。