Python agent release notesRSS

Notes

This release of the Python agent adds additional model information to LangChain Chain LLM events, and fixes a bug in LangGraph streaming 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

• Add additional model information to LangChain Chain LLM events

  • Add request.model and response.model attributes to LLM events produced by LangChain Chains.
  • This information is pulled on a best effort basis and may not always be available.

Bugs

• Fix TypeError in LangGraph streaming instrumentation

  • Previously, when using a subset of streaming APIs in LangGraph, the agent would encounter a TypeError due to the use of weakref.WeakMethod by LangGraph. This has been fixed, and the agent should now work correctly with those LangGraph streaming methods.

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.

Notes

This release of the Python agent adds support for multiple new Redis commands, fixes a bug in LangGraph instrumentation, and improves handling and logging of harvest limit settings.

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

• Add instrumentation for new Redis v8.8.0 commands

  • Add instrumentation for the following new Redis commands from redis-py v8.8.0:
    • Misc commands: INCREX, XNACK
    • Array commands: ARCOUNT, ARDEL, ARDELRANGE, ARGET, ARGETRANGE, ARGREP, ARINFO, ARINSERT, ARLASTITEMS, ARLEN, ARMGET, ARMSET, ARNEXT, AROP, ARRING, ARSCAN, ARSEEK, ARSET

Bugs

• Fix crash in LangGraph instrumentation

  • Previously, when using LangGraph instrumentation, the agent would crash due to an issue with context propagation to jobs in AsyncBackgroundExecutor. This has been fixed, and the agent should now work correctly with LangGraph.

• Improved handling and logging of harvest limit settings

  • The agent now more accurately reports the list of harvest methods and limits to the Environment tab in New Relic One.
  • The agent now has more consistent debug logging on startup for harvest limit settings.

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および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 ポリシーを参照してください。

メモ

今回の Python エージェントのリリースでは、最初のトークンまでの時間のサポートが追加され、互換性のないFlask add_url_rule関数のシグネチャが修正されました。

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

新機能

• LLMレスポンスストリームの最初のトークンに時間を追加しました。

  • エージェントは、 OpenAIおよびBedrockの応答ストリームのLlmChatCompletionSummaryイベントで、新しい属性time_to_first_tokenを記録します。この属性は、最初の要求から応答で最初に受信したトークンまでの時間を測定します。

バグ修正

• Flask add_url_rule関数のシグネチャの不一致が解決されました

  • Flaskの計装を更新し、 add_url_rule関数のシグネチャをネイティブのFlask実装に合わせました。 この修正により、以前の署名不一致によって発生する可能性のあるアプリケーションのクラッシュを防ぎます。

サポートステートメント

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

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