Python agent release notesRSS

Notes

This release of the Python agent adds trace/span support for Hybrid Agent, New Relic's integration with OpenTelemetry. It also adds entity GUIDs to Agent Control health check files, subcomponent attributes to agentic AI instrumentation, support for new Redis client methods, fixes a bug where there may be duplicate ImportHookFinder instances and a bug in OracleDB Cursor.callproc() 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.

Features

• Add Hybrid Agent tracing support

  • Hybrid Agent is designed to bridge the gap for teams looking to adopt OpenTelemetry standards while maintaining backwards compatibility with their existing New Relic dashboards. Hybrid Agent offers a "best-of-both-worlds" experience by combining New Relic’s deep visibility with OpenTelemetry API compatibility. It provides an observability solution with integrated support for the following OpenTelemetry APIs:
    • Tracing
    • Standalone library and native framework instrumentation
  • Key enhancements like Span Links and Events on Spans are now available, ensuring seamless interoperability in mixed-mode environments.

• Introduces a new Trace ID Ratio based sampler

  • A new Trace ID Ratio based sampler. This sampling algorithm is based off the sampler of the same name from OpenTelemetry, and can be configured to sample a set percentage of transactions.

• Add subcomponent attributes to agentic AI instrumentation

  • Instrumentation for LangChain, MCP, and Strands now includes a subcomponent attribute on spans that represent tool or agent calls. This is used to provide more enhanced entity mapping in the New Relic UI.

• Add entity GUID to Agent Control health check files

  • When the agent is started within an Agent Control environment, a health check file is created at the configured file location for every agent process. This file now includes the GUID of the entity related to the agent when available.

• Add instrumentation for new Redis methods

  • Add instrumentation for the following methods new methods on Redis clients:
    • hotkeys_get
    • hotkeys_reset
    • hotkeys_start
    • hotkeys_stop
    • vrange
    • xcfgset

Bugs

• Fix duplicate ImportHookFinder instances

  • Previously it was possible for duplicates of the import hook finder to be added to sys.meta_path.

• Fix incorrect signature on OracleDB Cursor.callproc()

  • Previously attempting to use keyword arguments with Cursor.callproc() would cause crashes as the argument names were incorrect in our instrumentation. This has been fixed, and the additional argument keyword_parameters is now also supported.

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 LangGraph agents.

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.

Features

• Add support for LangGraph agents

  • Adds instrumentation for LangGraph agent invocations via create_agent() in LangChain. This includes agent calls to invoke(), ainvoke(), stream(), and astream().

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エージェントのこのリリースでは、エラーをnotice_error()に渡す新しい方法が追加され、 Strands- synchronous ツールのエラー キャプチャのサポートが追加され、 gpt-5および新しいOpenAI LLM モデルのサポートが追加され、 Azure Functionsの使用ロジックのクラッシュが修正されています。

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

特徴

• 例外インスタンスを引数としてサポートする notice_error()

  • notice_error() error引数として、 sys.exc_info()からの例外タプルではなく、キャッチされた例外インスタンス (try/except ブロックからのものなど) を受け入れることができるようになりました。

  • これは既存の動作に追加されるものであり、既存の動作に代わるものではありません。引数なしまたは例外タプルを使用したnotice_error()の以前の使用は、引き続き正常に機能するはずです。

• gpt-5以降の OpenAI LLM モデルのサポートを追加します

  • 新しいOpenAIモデルで使用される新しいプロパティ名をサポートするために、 OpenAI計装に更新を追加します。

• Strands-エージェント同期ツールのエラー キャプチャのサポートを追加

  • Strands-エージェントのツールとして使用される同期Python関数は、適切なエラー キャプチャを備え、データベース ルックアップなどのツール内でトレースをキャプチャできるようになりました。

バグ修正

• Azure Functions の利用におけるクラッシュを防ぐ

  • 以前は、一部のユーザーは、正規表現を一致させようとしたときに Azure Functions 使用率検出がクラッシュするというエッジケースを経験していました。クラッシュは修正されており、今後は発生しなくなるはずです。

サポートステートメント

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

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

メモ

このリリースの Python エージェントでは、以下のサポートが追加されました。

• ストランド
• AWS Bedrock コンバースストリーミング
• Redisメソッドhybrid_searchと msetex
• LLM イベントのLangChainロールの割り当て
• LLM 要求時にキャプチャされた LLM イベントのタイムスタンプ
• loop_factory 問題あり asyncio.Runner

このリリースでは、Web サーバーによってヘッダーが報告されない ASGI モジュールのバグも修正されています。

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

特徴

• ストランドのサポートを追加

  • 単一および複数エージェント (群、グラフなど) 設定にストランド ツールとエージェントの計装を追加します。

• AWS Bedrock Converse Streamingのサポートを追加

  • ストリーミング Converse API の監視サポートを追加します。これには、 converse_stream()を使用して boto3 および aioboto3 クライアントで行われた Converse チャット完了呼び出しのサポートが含まれます。

• Redisメソッドのサポートを追加

  • 次のメソッドのサポートを追加します。

    • hybrid_search
    • msetex

• loop_factoryのサポートを追加 asyncio.Runner

  • Python 3.11 では、 asyncio.Runner loop_factoryが追加されました。 loop_factory問題は、ループ ポリシーの代替手段を提供します。 これで、グローバル イベント ループ設定またはカスタムイベント ループのどちらを介したものであっても、作成されたループはインストゥルメント化されます。

• LLM イベントでLangChain のロール割り当てをキャプチャする

  • LangChain LlmChatCompletionMessageイベントには、 LangChainから割り当てられたロールが含まれるようになりました。

• LLM 要求時に LLM イベントのタイムスタンプをキャプチャします。

  • 以前は、LLM イベントのタイムスタンプはイベントの作成時にキャプチャされていました。現在では、LLM リクエスト時により正確にキャプチャされるようになりました。

バグ修正

• ASGIヘッダーの消費

  • ASGIWebTransactionがhttp.response.startイベントからヘッダーを使用する際、許容される入力タイプを考慮せずに使用していました。ヘッダーがジェネレーターである場合、ジェネレーターはprocess_response()呼び出しによって消費され、Web サーバーが送信するヘッダーが残っていません。これは修正されました。

サポートステートメント

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

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

メモ

このリリースの Python エージェントでは、Python 3.14 のサポート、属性フィルター設定用の新しい環境変数、トランザクション デコレータの非同期ジェネレータのサポート、 AWS Bedrockの追加モデル、 AWS Kinesisの新しいメソッドが追加されています。このリリースでは、 ConnectionPoolが複数回ラップされているときにRecursionError引き起こすaiomysqlのバグ、 kombuのプロデューサーでプロパティが適切に渡されないバグ、およびshutdown_agent収集スレッド内から呼び出されたときにエラーが発生するバグも修正されています。

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

特徴

• Python 3.14のサポートを追加

  • Python 3.14 のサポートを追加します。

• 属性フィルター設定用の環境変数を追加する

  • 以下の設定は、環境変数を通じて設定できるようになりました。

    構成設定	環境変数
    attributes.enabled	NEW_RELIC_ATTRIBUTES_ENABLED
    attributes.exclude	NEW_RELIC_ATTRIBUTES_EXCLUDE
    attributes.include	NEW_RELIC_ATTRIBUTES_INCLUDE
    browser_monitoring.attributes.enabled	NEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_ENABLED
    browser_monitoring.attributes.exclude	NEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_EXCLUDE
    browser_monitoring.attributes.include	NEW_RELIC_BROWSER_MONITORING_ATTRIBUTES_INCLUDE
    error_collector.attributes.enabled	NEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_ENABLED
    error_collector.attributes.exclude	NEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_EXCLUDE
    error_collector.attributes.include	NEW_RELIC_ERROR_COLLECTOR_ATTRIBUTES_INCLUDE
    span_events.attributes.enabled	NEW_RELIC_SPAN_EVENTS_ATTRIBUTES_ENABLED
    span_events.attributes.exclude	NEW_RELIC_SPAN_EVENTS_ATTRIBUTES_EXCLUDE
    span_events.attributes.include	NEW_RELIC_SPAN_EVENTS_ATTRIBUTES_INCLUDE
    transaction_events.attributes.enabled	NEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_ENABLED
    transaction_events.attributes.exclude	NEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_EXCLUDE
    transaction_events.attributes.include	NEW_RELIC_TRANSACTION_EVENTS_ATTRIBUTES_INCLUDE
    transaction_segments.attributes.enabled	NEW_RELIC_TRANSACTION_SEGMENTS_ATTRIBUTES_ENABLED
    transaction_segments.attributes.exclude	NEW_RELIC_TRANSACTION_SEGMENTS_ATTRIBUTES_EXCLUDE
    transaction_segments.attributes.include	NEW_RELIC_TRANSACTION_SEGMENTS_ATTRIBUTES_INCLUDE
    transaction_tracer.attributes.enabled	NEW_RELIC_TRANSACTION_TRACER_ATTRIBUTES_ENABLED
    transaction_tracer.attributes.exclude	NEW_RELIC_TRANSACTION_TRACER_ATTRIBUTES_EXCLUDE
    transaction_tracer.attributes.include	NEW_RELIC_TRANSACTION_TRACER_ATTRIBUTES_INCLUDE

• トランザクション デコレータに非同期ジェネレータのサポートを追加する

  • 以前は、トランザクション デコレータは非同期ジェネレータをラップすることをサポートしていませんでした。このサポートが追加され、非同期ジェネレーター トランザクションはイベント ループの待機時間やその他の統計を自動的に測定するようになりました。

• AWS Bedrock 計装に追加モデルのサポートを追加

  • botocoreおよびaiobotocoreを通じてAWS Bedrock 計装を更新し、以下の追加モデルをサポートします。

    • クロード・ソネット 3+ モデル
    • リージョンがプレフィックスとして付いたモデル（リージョン対応）

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

  • 新しいAWS Kinesis メソッドをサポートするためにbotocore計装を追加

    • describe_account_settings
    • update_account_settings
    • update_max_record_size
    • update_stream_warm_throughput

バグ修正

• aiomysql ConnectionPool での再帰エラーを防ぐ

  • 以前は、プールされた接続を使用すると、 aiomysqlでRecursionErrorが発生していました。繰り返しのラッピングにより、プールされた接続の周囲に深いObjectProxyチェーンが作成されました。これは修正されました。

• kombuのプロデューサーでプロパティが適切に渡されないバグを修正しました

  • kombu.messaging.Producer.publish()の計装により、プロパティが誤って辞書内にネストされ、プロパティが間違った場所に配置され、下流のパッケージによって読み取られなくなるバグを修正しました。

• shutdown_agentが収集スレッド内から呼び出されたときのエラーを修正しました

  • 以前は、 shutdown_agent収集スレッド内から呼び出されたときにRuntimeErrorが発生する可能性がありました。これにより、クラッシュを防ぐガードが追加され、問題が修正されます。

サポートステートメント

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

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