Python agent release notesRSS

Notes

This release of the Python agent adds instrumentation for OpenAI Responses, and the new hsetex command in Valkey.

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 OpenAI Responses

  • Instrumentation was added for the openai SDK's client.responses methods, which target the Responses API.
  • This is an addition to the existing instrumentation of the older client.chat.completions methods and Chat Completions API, which are still supported.

Enhanced features

• Added support for new Valkey command:

  • The hsetex command is now 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.

メモ

このPythonエージェントのリリースでは、Azure App Servicesの利用状況、Azure Service Busの計装、新しいKinesisメソッドのサポート、およびv2.10.0以降のGoogle ADKのサポートが追加されています。また、このリリースでは、httplibでディストリビューティッド（分散）トレーシングのトレースヘッダーが重複する問題、およびsetup.pyインストレーションファイルを修正しています。

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

削除された機能

• Python 3.9のサポートを削除しました。

  * Python 3.9は2025年10月31日にサポート終了となり、エージェントではサポートされなくなりました。Pythonエージェントのアップデートを引き続き受け取るには、アプリケーションをサポートされているバージョンのPythonにアップグレードすることをご検討ください。

新機能

• Azureアプリサービスの利用率

  • エンティティ関係のマッピングを有効にするため、Azure App Serviceの使用率が追加されました。
  • また、新しい設定も追加されます、 utilization.detect_azureappservice

• Azure Service Bus向けの新しい計装

  • Microsoft Azure Service Busの計装が追加されました。

• 新しいKinesisメソッド向けの新しい計装

  • Kinesisでupdate_stream_record_distribution_strategyメソッドがサポートされるようになりました。

セキュリティアップデート

• urllib3の現在のすべてのCVEを解決するために、内部のurllib3パッケージが2.8.0に更新されました。

  • これにより、現時点までのエージェントにおけるすべての既知のCVEが解決されます。

機能の拡充

• Google ADK v2.10.0以降をサポートしています。

  • バージョン2.10.0以上のGoogle ADK向けに計装が更新されました。

バグ

• httplibにおける重複したディストリビューティッド（分散）トレーシングヘッダー

  • httplibの計装がtraceparentに対して重複するヘッダーを生成し、不正な値になる問題を修正しました。

• setup.py サポートされているすべてのPythonバージョンでインストールファイルが動作するようになりました。

  • ユーザーがsetup.pyファイルを直接使用してPython 3.12以上にPythonエージェントをインストールしようとすると、ImportErrorが発生します。これは、distutilsがPython 3.10以降非推奨となり、Python 3.12の標準ライブラリから完全に削除されたためです。

サポートステートメント

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

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

メモ

Pythonエージェントの今回のリリースでは、botocore（SigV4）の署名付きヘッダーに関する問題が修正されています。

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

バグ

• botocore（SigV4）の署名付きヘッダーに関する問題を修正しました。

  • ヘッダーが重複して送信されるのを防ぐため、botocoreのディストリビューティッド（分散）トレーシングヘッダーに対する以前の変更は元に戻されました。
  • 以前は、他のトレーシングライブラリによって生成されたディストリビューティッド（分散）トレーシングヘッダーが、ヘッダーの署名によりbotocoreの計装に問題を引き起こす可能性がありました。この問題は、botocore内でこれらのヘッダーの署名を無効にすることで修正されました。

サポートステートメント

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

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

メモ

Pythonエージェントの今回のリリースでは、OpenSearch、Microsoft Azure SQL、新しいKinesisメソッド、および新しいbrowser_monitoring.version設定のサポートが追加されました。さらに、Anthropic、MCP、およびGoogle ADKの計装に改善が加えられました。このリリースでは、botocore（SigV4）の署名付きヘッダーとGeminiツールの解析に関する問題も修正されています。

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

新機能

• opensearch-pyの新しい計装

  • 公式のOpenSearchデータベースコネクタに計装が追加されました。

• mssql-python向けの新しい計装

  • Microsoft Azure SQLの計装が追加されました。

• 新しいKinesisメソッドの新しい計装

  • Kinesisで以下のメソッドがサポートされるようになりました：

    • create_channel
    • delete_channel
    • describe_channel
    • list_channels
    • update_channel

• の新しい設定 browser_monitoring.version

  • 新しい設定 browser_monitoring.version により、ユーザーは挿入されるブラウザ監視エージェントの特定のバージョンを指定できるようになります。
  • 選択可能なサポートされているBrowserエージェントのバージョンのリストをご覧ください。

改善された機能

• anthropicのサポートが改善されました。

  • バージョン1.0.0以上のAnthropic SDKにおけるリクエストパラメーターの解析が改善されました。
  • Messages.with_raw_response.create経由のレスポンスの新しい解析により、LangChainとの互換性が向上しました。

• mcp v2.0.0以降をサポートしました。

  • mcp v2.0.0で行われた大規模なリファクタリングに伴い、計装が更新され、再び期待通りに動作するはずです。

• Google ADK v2.9.0以上のサポート。

  • バージョン2.9.0以上のGoogle ADK向けに計装が更新されました。

バグ

• botocore（SigV4）の署名付きヘッダーに関する問題を修正しました。

  • 以前は、他のトレーシングライブラリによって生成されたディストリビューティッド（分散）トレーシングのヘッダーが、ヘッダーの署名が原因でbotocoreの計装に問題を引き起こす可能性がありました。この問題は修正され、ディストリビューティッド（分散）トレーシングのヘッダーは署名前に変更されるようになりました。

• Geminiツールの解析の修正

  • 以前は、Geminiで作成されたツールのいくつかのインスタンスが解析に失敗し、エラーを出さずに失敗して、その特定のリクエストに対するレスポンスが返されないことがありました。この問題は修正されました。

サポートステートメント

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

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

メモ

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