Python agent release notesRSS

Notes

This release of the Python agent fixes issues with signed headers in botocore (SigV4).

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.

Bugs

• Fix issues with signed headers in botocore (SigV4)

  • The previous change to botocore distributed tracing headers has been reverted to avoid duplicate headers being sent.
  • Previously any distributed tracing headers that were generated by other tracing libraries could cause issues with instrumentation in botocore due to header signing. This has been fixed by disabling signing for these headers within botocore.

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 OpenSearch, Microsoft Azure SQL, new Kinesis methods, and a new browser_monitoring.version setting. Additionally, improvements have been made to Anthropic, MCP, and Google ADK instrumentation. Issues with signed headers in botocore (SigV4) and Gemini tools parsing have also been fixed for this release.

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.

New Features

• New instrumentation for opensearch-py

  • Instrumentation was added for the official OpenSearch database connector.

• New instrumentation for mssql-python

  • Instrumentation was added for Microsoft Azure SQL.

• New instrumentation for new Kinesis methods

  • The following methods are now supported in Kinesis:
    • create_channel
    • delete_channel
    • describe_channel
    • list_channels
    • update_channel

• New setting for browser_monitoring.version

  • The new setting browser_monitoring.version enables users to specify specific versions of our Browser Monitoring Agent to be injected.
  • See the list of Supported Browser Agent Versions to choose from.

Improved Features

• Improved support for anthropic.

  • Improved parsing of request parameters for the Anthropic SDK on versions 1.0.0 and above.
  • New parsing for responses via Messages.with_raw_response.create enabling improved compatibility with LangChain.

• Support for mcp v2.0.0 and above.

  • Instrumentation has been updated following the major refactor done in mcp v2.0.0 and should once again work as expected.

• Support for Google ADK v2.9.0 and above.

  • Instrumentation has been updated for Google ADK on versions 2.9.0 and above.

Bugs

• Fix issues with signed headers in botocore (SigV4)

  • Previously any distributed tracing headers that were generated by other tracing libraries could cause issues with instrumentation in botocore due to header signing. This has been fixed, and distributed tracing headers are now mutated before signing.

• Fix Gemini tools parsing

  • Previously, some instances of tools created with Gemini would fail to parse and would silently fail, resulting in no response for that specific request. This has been fixed.

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エージェントのこのリリースでは、Azure CosmosDBのサポートを追加し、HTTPX2および新しいLangChain/LangGraphストリーミングイベントAPIの計装を追加し、新しいOpenTelemetryデータベースセマンティック規則のサポートを追加し、不完全なパッケージレポート、パッケージ検索のパフォーマンスの低下、MySQLデータベース名のレポートのバグを含むいくつかの問題を解決しています。

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

新機能

• Azure CosmosDBのサポートを追加しました

  • Pythonエージェントは、Azure Cosmos DBクライアント操作をインストゥルメントするようになり、azure-cosmos SDKを通じて実行されるデータベース、コンテナ、およびユーザー操作のデータストアメトリクスとトレースをレポートします。

• HTTPX2のサポートを追加しました

  • Pythonエージェントは、Pydanticチームによって積極的にメンテナンスされているHTTPX2のフォークであるHTTPXをサポートするようになりました。HTTPX2の外部呼び出しの計装は、同期クライアントと非同期クライアントの両方に対するエージェントの既存のHTTPXサポートを反映しています。

• LangChain/LangGraphストリーミングイベントの計装を追加しました

  • LangChainエージェントのastream_events計装サポートを追加しました。
  • LangChain/LangGraph v3のstream_events/astream_events計装を追加し、GraphRunStreamオブジェクトの反復処理をカバーしました。

• 新しいOpenTelemetryデータベースセマンティック規則のサポートを追加しました

  • PythonエージェントをOpenTelemetryと並行して実行する場合（ハイブリッドエージェントモード）、エージェントはレガシーおよび新しいOpenTelemetryデータベーススパン属性名（db.name/db.namespace、db.statement/db.query.text、db.mongodb.collection/db.collection.name）の両方を読み取るようになったため、OpenTelemetry計装ライブラリが出力するセマンティック規則のバージョンに関係なく、データベーストレースが引き続き正しく機能します。

バグ

• New Relicへの不完全なパッケージレポートを修正しました

  • 以前は、モジュールの検出に遅い収集サイクル中に割り当てられた固定時間枠よりも長くかかり、エージェントの再起動後にパッケージリストが更新されなかった場合、PythonエージェントはNew Relicにレポートされる環境データから一部のインストール済みパッケージを除外する可能性がありました。パッケージのキャプチャは速い収集サイクル中に実行されるようになり、エージェントのシャットダウン/再起動時に完全に再キャプチャされるため、レポートされるパッケージリストは完全になります。

• パッケージバージョン検索のオーバーヘッドを削減しました

  • 以前は、インストールされているパッケージのバージョンを検索する際、検索のたびにすべてのパッケージについてファイルシステムを再スキャンしていたため、エージェントの初期化時にインストールされているパッケージの数に比例してO(n^2)のタイムペナルティが発生していました。このオーバーヘッドを回避するため、importlib.metadata.packages_distributions()の結果は最初の検索後にキャッシュされるようになりました。

• 指定されたアプリケーションを適切にパススルーするようにget_linking_metadataを修正しました

  • 以前は、newrelic.agent.get_linking_metadata(application=...)を呼び出すとapplication引数が無視され、常にデフォルトのアプリケーションのリンクメタデータが返されていました。これは、複数のアプリケーションにレポートするプロセスに影響を与えていました。指定されたアプリケーションが正しくパススルーされるようになりました。
  • 貢献してくださったckarnellに感謝します！

• databaseキーワード引数を使用した場合のMySQLデータベース名のレポートを修正しました

  • 以前は、mysql-connector-pythonの接続引数からデータベース名を解析する際、エージェントはレガシーなdbキーワード引数のみをチェックしていたため、モダンなdatabaseキーワード引数を使用して行われた接続では、データストアメトリクスにデータベース名がレポートされませんでした。エージェントは最初にdatabaseをチェックし、dbにフォールバックするようになりました。

• LangGraph v1.1+のGraphOutput値にアクセスする際の警告を修正しました

  • 以前は、LangGraph v1.1+の計装は、非推奨のアイテムアクセス構文を使用してGraphOutputの戻り値にアクセスしていたため、非推奨の警告がトリガーされていました。エージェントはGraphOutput.valueを直接読み取るようになりました。

サポートステートメント

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

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

メモ

Pythonエージェントのこのリリースでは、Redis v8.10.0およびredis-py v8.1.0で導入されたRedisコマンドのサポートが追加されています。このリリースでは、MCPツールの使用時にLangChainでLlmChatCompletionイベントが欠落する問題も解決されています。

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

新機能

• Redis v8.10.0 および redis-py v8.1.0 で導入された Redis コマンドを追加しました

  • Pythonエージェントは、Redisで最近追加された次のコマンドをサポートするようになりました。

    • himport_discard_all
    • himport_discard
    • himport_prepare
    • lmovem
    • nrange
    • nrevrange
    • querylabels
    • read
    • sdiffcard
    • sunioncard
    • aliaslist

バグ

• MCPツールを使用する際にGeminiでLlmChatCompletionイベントが欠落する問題を修正しました。

  • 以前は、応答フォーマットがデフォルトのJSONではない場合、 LangChain LlmChatCompletionMessagesエージェントでツールを使用すると、LlmChatCompletionSummary Gemini で および イベントが欠落していました。これは解決されました。

• LangChainおよびAgentフレームワークでトレースキャッシュIDにスワップしました

  • コンテキスト伝搬の目的で、LangChainおよびAgentフレームワークの計装をスワップし、参照属性に完全なトレースではなくトレースキャッシュIDのみを保存するようにしました。これは、リークが発生した場合にこれらのオブジェクトが予期せずシリアル化されるのを防ぐためです。トレースには数MBのデータが含まれる可能性がありますが、IDははるかに小さなオブジェクトです。

サポートステートメント

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

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

メモ

このリリースの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の値がローカル設定よりも優先されます。

• エージェントフレームワークを介した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をバックエンドとするトランスポート）が正常に動作しなくなっていました。これらのトランスポートが正しく機能するように、バイトエンコーディングは削除されました。

サポートステートメント

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

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