Python agent release notesRSS

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.status attribute in WebTransactions is considered deprecated and will be removed in the upcoming 14.0.0 release. It is being replaced by http.statusCode. We recommend replacing all references to response.status with http.statusCode.

New features

• Exclude the newrelic header by default

  • The newrelic distributed tracing header is now no longer sent by default. Only the W3C traceparent and tracestate headers will be sent.

• Add exclude and include settings for Hybrid Agent traces

  • opentelemetry.traces.include for the configuration file or NEW_RELIC_OPENTELEMETRY_TRACES_INCLUDE to be used as an environment variable
  • opentelemetry.traces.exclude for the configuration file or NEW_RELIC_OPENTELEMETRY_TRACES_EXCLUDE to 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.statusCode attribute to transaction events

  • To conform with the rest of the language agents, the Python agent now sends the http status to the WebTransaction attribute http.statusCode. The Python agent will continue to send the attribute to response.status as well, but the response.status attribute will be removed in the future.

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+.

• Enable task propagation in async generators

  • Fixes an issue where AsyncGeneratorProxy would not properly handle transaction context propagation if spread over multiple tasks.

• Fix Starlette context propagation in StreamingResponse

  • Adds trace context propagation to starlette StreamingResponse for both synchronous and asynchronous generators.

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 エージェントのリリースでは、最初のトークンまでの時間のサポートが追加され、互換性のない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 ポリシーを参照してください。

メモ

Pythonエージェントのこのリリースでは、クロスアプリケーション トレーシング (CAT)、 Python 3.8、およびバンドルされている SSL 証明書のサポートが削除されます。 また、ベンダー提供のすべてのパッケージを最新バージョンに更新し、フリースレッド対応のCPython、 Windows OSのサポートを追加し、Microsoft AG2（Autogen）の計測機能を改善します。 さらに、このリリースには、certifi を通じて SSL 証明書をインストールするための新しいオプションの追加機能が含まれています。 このリリースでは、重複した例外が報告される原因となった Strands エージェントインストゥルメンテーションのバグも修正されています。

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

削除された機能

• クロスアプリケーション トレーシング (CAT) は削除され、ディストリビューティッド（分散）トレーシング (DT) が使用されます。

  • クロスアプリケーショントレーシング（CAT）は、エージェントバージョン7.0.0.166で非推奨となり、今回のリリースで削除されました。まだクロスアプリケーション トレーシング (CAT) を使用している場合は、中断を避けるためにできるだけ早くディストリビューティッド（分散）トレーシング (DT) に移行することをお勧めします。

• 同梱されていたSSL証明書は削除されました。

  • 環境に証明書が必要な場合は、OS のパッケージマネージャを介して証明書をインストールするか、オプションのnewrelic[certificates]エクストラを使用してエージェントをインストールできます。

• Python 3.8のサポートは削除されました。

  • Python 3.8は2024年10月7日にサポート終了となり、エージェントによるサポートは終了しました。Pythonエージェントの更新を引き続き受け取るには、アプリケーションをサポートされているバージョンのPythonにアップグレードすることを検討してください。

セキュリティ

• すべての内部パッケージが最新バージョンにアップデートされました。

  • urllib3 バージョン2.6.3にアップデートしました
    • このリリースにより、 urllib3における、このリリース日時点での未解決のすべての CVE が修正されます。
  • opentelemetry_proto バージョン1.40.0にアップデートしました
  • wrapt バージョン2.1.2にアップデートしました
  • asgiref バージョン3.11.1にアップデートしました。

新機能

• certifiを通じて SSL 証明書をインストールするための新しいnewrelic[certificates]追加機能。

  • エージェントは、バンドルされているSSL証明書をインストールするために使用できるオプションの追加機能newrelic[certificates]を提供するようになりました。これは、証明書が必要だが、OS のパッケージマネージャから証明書をインストールできないユーザーを対象としています。

• フリースレッドCPythonのサポート

  • Python 3.13以降、CPythonはグローバルインタプリタロック（GIL）を無効にしたPythonビルドをリリースし、真のマルチスレッド処理を可能にしました。
  • 今回のリリースでは、この動作に対するサポートが追加され、エージェントがフリースレッド環境で安全に実行できるようになります。
  • このリリースには、Linux およびWindows上のフリースレッド CPython 用のビルド済みバイナリも含まれており、これらの環境で簡単にインストレーションを行うことができます。

• Windowsサポート

  • このリリースには、Windows 上の CPython 3.13 以降に対応したビルド済みバイナリが含まれています。
  • タイマーの解像度に大きなばらつきがあるため、Python 3.12以前のバージョンはWindowsでは公式にはサポートされていませんのでご注意ください。エージェントをソースからインストールして使用することは引き続き可能ですが、ユーザーは不正確なタイミング データに関する問題が発生する可能性があるため、最高のエクスペリエンスを得るにはPython 3.13 以降にアップグレードする必要があります。

• Microsoft AG2 (Autogen)用の計装の改善

  • 非同期ジェネレータメソッドon_messages_stream()によるストリーミング応答のサポートを追加しました。
  • 計装には、ツールまたはエージェントの呼び出しを表すスパンのsubcomponentプロパティが含まれるようになりました。 これは、New RelicのUIにおいて、より高度なエンティティマッピングを提供するために使用されます。

バグ

• Strandsエージェントでの重複例外

  • Strandsエージェントのアップデートにより、一部の例外が新しいEventLoopException型にカプセル化された後、重複したエラーが報告される可能性がありました。 この問題は修正され、根本的なエラーは一度だけ報告されるはずです。

サポートステートメント

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

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

メモ

Pythonエージェントのこのリリースでは、ハイブリッド エージェントのトレース/スパン サポート、 New RelicとOpenTelemetryの統合が追加されています。 また、 Agent Controlヘルス チェック ファイルにエンティティ GUID を追加し、エージェント AI 計装にsubcomponentプロパティを追加し、新しいRedisクライアント メソッドをサポートし、ImportHookFinder インスタンスが重複する可能性があるバグとOracleDB Cursor.callproc()計装のバグを修正します。

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

特徴

• ハイブリッドエージェントのトレースサポートを追加

  • Hybrid エージェントは、既存のNew Relicダッシュボードとの下位互換性を維持しながら、 OpenTelemetry標準の採用を検討しているチームのギャップを埋めるように設計されています。 ハイブリッド エージェントは、New Relic の高度な可視性と OpenTelemetry API の互換性を組み合わせることで、「両方の長所を兼ね備えた」エクスペリエンスを提供します。次のOpenTelemetry API の統合サポートを備えたオブザーバビリティ ソリューションを提供します。

    • トレース
    • スタンドアロン ライブラリとネイティブ フレームワーク計装

  • Span リンクや Span 上のイベントなどの主要な機能強化が利用できるようになり、混合モード環境でのシームレスな相互運用性が保証されます。

• 新しいトレース ID 比率ベースのサンプラーを導入

  • 新しいトレース ID 比率ベースのサンプラー。このサンプリング アルゴリズムは、OpenTelemetry の同じ名前のサンプラーに基づいており、設定された割合のトランザクションをサンプリングするように構成できます。

• subcomponentプロパティをエージェント AI 計装に追加します

  • LangChain 、 MCP 、 Strandsの計装に、ツールまたはエージェント呼び出しを表すスパンのsubcomponentプロパティが含まれるようになりました。 これは、New Relic UI でより強化されたエンティティ マッピングを提供するために使用されます。

• エンティティ GUID をAgent Controlヘルス チェック ファイルに追加する

  • Agent Control環境内でエージェントが開始されると、各プロセスの構成されたファイルの場所にヘルス チェック ファイルが作成されます。 このファイルには、利用可能な場合、エージェントに関連するエンティティの GUID が含まれるようになりました。

• 新しいRedisメソッドの計装を追加

  • Redisクライアントに次の新しいメソッドの計装を追加します。

    • ホットキー取得
    • ホットキーリセット
    • ホットキー_開始
    • ホットキー停止
    • 範囲
    • xcfgセット

バグ

• 重複する ImportHookFinder インスタンスを修正

  • 以前は、インポートフックファインダーの重複がsys.meta_pathに追加される可能性がありました。

• OracleDBの不正な署名を修正 Cursor.callproc()

  • 以前は、 Cursor.callproc()でキーワード引数を使用しようとすると、計算で引数名が間違っていたためクラッシュが発生していました。 これは修正され、追加の引数keyword_parametersもサポートされるようになりました。

サポートステートメント

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

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

メモ

Pythonエージェントのこのリリースでは、 LangGraphエージェントのサポートが追加されています。

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

特徴

• LangGraphエージェントのサポートを追加

  • LangChainのcreate_agent()を介した LangGraph エージェント呼び出しの計装を追加します。 これには、 invoke() 、 ainvoke() 、 stream() 、およびastream()へのエージェント呼び出しが含まれます。

サポートステートメント

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

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