メモ
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]エクストラを使用してエージェントをインストールできます。
- 環境に証明書が必要な場合は、OS のパッケージマネージャを介して証明書をインストールするか、オプションの
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 のパッケージマネージャから証明書をインストールできないユーザーを対象としています。
- エージェントは、バンドルされているSSL証明書をインストールするために使用できるオプションの追加機能
フリースレッド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型にカプセル化された後、重複したエラーが報告される可能性がありました。 この問題は修正され、根本的なエラーは一度だけ報告されるはずです。
- Strandsエージェントのアップデートにより、一部の例外が新しい
サポートステートメント
最新のエージェント バージョンが利用可能になったらすぐに更新することをお勧めします。最新バージョンにアップグレードできない場合は、エージェントを 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 計装に追加しますエンティティ 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()へのエージェント呼び出しが含まれます。
- LangChainの
サポートステートメント
最新のエージェント バージョンが利用可能になったらすぐに更新することをお勧めします。最新バージョンにアップグレードできない場合は、エージェントを 90 日以内のバージョンに更新してください。エージェントを最新の状態に保つ方法の詳細については、こちらをご覧ください。
エージェントのリリースとサポート日については、New Relic Python エージェントのEOL ポリシーを参照してください。
メモ
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 チャット完了呼び出しのサポートが含まれます。
- ストリーミング Converse API の監視サポートを追加します。これには、
Redisメソッドのサポートを追加
次のメソッドのサポートを追加します。
hybrid_searchmsetex
loop_factoryのサポートを追加asyncio.Runner- Python 3.11 では、
asyncio.Runnerloop_factoryが追加されました。loop_factory問題は、ループ ポリシーの代替手段を提供します。 これで、グローバル イベント ループ設定またはカスタムイベント ループのどちらを介したものであっても、作成されたループはインストゥルメント化されます。
- Python 3.11 では、
LLM イベントでLangChain のロール割り当てをキャプチャする
- LangChain
LlmChatCompletionMessageイベントには、 LangChainから割り当てられたロールが含まれるようになりました。
- LangChain
LLM 要求時に LLM イベントのタイムスタンプをキャプチャします。
- 以前は、LLM イベントのタイムスタンプはイベントの作成時にキャプチャされていました。現在では、LLM リクエスト時により正確にキャプチャされるようになりました。
バグ修正
ASGIヘッダーの消費
ASGIWebTransactionがhttp.response.startイベントからヘッダーを使用する際、許容される入力タイプを考慮せずに使用していました。ヘッダーがジェネレーターである場合、ジェネレーターはprocess_response()呼び出しによって消費され、Web サーバーが送信するヘッダーが残っていません。これは修正されました。
サポートステートメント
最新のエージェント バージョンが利用可能になったらすぐに更新することをお勧めします。最新バージョンにアップグレードできない場合は、エージェントを 90 日以内のバージョンに更新してください。エージェントを最新の状態に保つ方法の詳細については、こちらをご覧ください。
エージェントのリリースとサポート日については、New Relic Python エージェントのEOL ポリシーを参照してください。