メモ

このリリースの Python エージェントでは、次の変更が加えられています。

• Python 3.7のサポートを削除
• さまざまなAPIと設定を削除または廃止します
• aioredis計装を廃止します
• setuptoolsのサポートされている最小バージョンを上げ、 setuptools_scm
• AutoGen用の新しい計装を追加
• Pyzeebe用の新しい計装を追加
• 新しいMCP（モデルコンテキストプロトコル）名前付きスパンを追加します
• psycopgのクラッシュを修正
• AIモニタリングが有効な場合にのみMCPスパンが記録されるようにします

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

削除された機能

• Python 3.7のサポートを削除

  • Python 3.7 は 2023 年 6 月 27 日に EOL となりました。Python エージェントでは、そのサポートが廃止されました。

• さまざまな非推奨APIを削除します

  • 次の API は削除されました:

    レガシーAPI	リプレースメントAPI
    accept_distributed_trace_payload	accept_distributed_trace_headers
    add_custom_parameter	add_custom_attribute
    add_custom_parameters	add_custom_attributes
    create_distributed_trace_payload	insert_distributed_trace_headers
    get_browser_timing_footer	この機能はget_browser_timing_header()にラップされています
    record_exception	notice_error()
    NewRelicLogHandler	NewRelicLogForwardingHandler
    lambda_handler ＆ LambdaHandlerWrapper	これらの API はnewrelic-lambdaパッケージに移動されました。

• さまざまな非推奨の設定を削除します

  • 以下の設定は削除されました:

    レガシー設定	置換設定
    transaction_tracer.capture_attributes	transaction_tracer.attributes.enabled
    error_collector.capture_attributes	error_collector.attributes.enabled
    browser_monitoring.capture_attributes	browser_monitoring.attributes.enabled
    analytics_events.enabled	transaction_events.enabled
    analytics_events.capture_attributes	transaction_events.attributes.enabled
    error_collector.ignore_errors	error_collector.ignore_classes
    strip_exception_messages.whitelist	strip_exception_messages.allowlist
    ssl	これは現在trueにハードコードされているため、設定オプションとしては削除されました。
    ignored_params	代わりにnewrelic.attributes.exclude = request.parameters.{name}使用してください。各リクエストのキーをカンマで区切ってnewrelic.attributes.excludeリストに追加します。 キーの先頭に必ずrequest.parametersを付けてください。
    agent_limits.merge_stats_maximum	これは、サーバー側の設定を優先して完全に無視されるようになりました。

非推奨の機能

• aioredisの計装は非推奨になりました

  • aioredisパッケージは非推奨となり、代わりにサブモジュールredis.asyncioが含まれるredisが推奨されます。その結果、 aioredisの計装も非推奨になりました。 代わりにredisライブラリを使用してください。この計装は将来のリリースで削除される予定です。

• 他の言語エージェントと一致するように、既存の収穫設定の一部を廃止します。

  • 他の言語エージェントの規則との一貫性を保つために、次の収集設定は非推奨になりました。

    レガシー設定	置換設定
    event_harvest_config.harvest_limits.analytic_event_data	transaction_events.max_samples_stored
    event_harvest_config.harvest_limits.span_event_data	span_events.max_samples_stored
    event_harvest_config.harvest_limits.error_event_data	error_collector.max_event_samples_stored
    event_harvest_config.harvest_limits.custom_event_data	custom_insights_events.max_samples_stored
    event_harvest_config.harvest_limits.log_event_data	application_logging.forwarding.max_samples_stored

    これは、これらの設定の名前を*.max_samples_storedからevent_harvest_config.harvest_limits.*フォームに変更した以前の変更を元に戻したものです。この決定は覆され、設定名を変更しなかった他の言語エージェントと一致するように、元の設定名が復元されました。非推奨の設定は今のところは引き続き機能しますが、将来のリリースでは削除される予定です。

• WSGI環境辞書によるエージェントの設定を非推奨にします

  • 以前は WSGI environ 辞書を通じて構成可能だった以下の設定は非推奨になりました。これらの設定は、環境変数または設定ファイルを通じて構成してください。

    • newrelic.set_background_task
    • newrelic.suppress_apdex_metric
    • newrelic.suppress_transaction_trace
    • newrelic.capture_request_params
    • newrelic.disable_browser_autorum

• setuptools<61.2または setuptools_scm<6.4

  • setuptoolsとsetuptools_scmのサポートされる最小バージョンがそれぞれ61.2と6.4に増加されました。これは、パッケージ メタデータとビルド手順を構成するためのpyproject.tomlの使用をサポートするためのものです。エージェントは、より新しいビルド ツールを使用してビルドできるようになり、 pyproject.tomlファイルがないことに関する警告がログに記録されなくなりました。
  • この変更により、パッケージに新しいバージョン属性newrelic.__version__とnewrelic.__version_tuple__が追加され、実行時にエージェントのバージョンをプログラムで確認できるようになります。

新機能

• AutoGen用の新しい計装を追加

  • AutoGenのエージェントとツールの計装 (名前付きスパンとカスタムLlmイベント) を追加します

• Pyzeebe用の新しい計装を追加

  • Pyzeebeに自動計装およびフレームワーク固有のエージェント プロパティを追加

• 新しいMCP（モデルコンテキストプロトコル）名前付きスパンを追加します

  • ツール マネージャー経由で行われる MCP (モデル コンテキスト プロトコル) ツール呼び出しに新しい名前付きスパンを追加して、ストリーミング可能な HTTP をサポートします。

バグ修正

• psycopg>=3.2.0を呼び出すときに発生するクラッシュを修正しました as_string()

  • as_string()メソッドで引数が不要になり、クラッシュが発生する可能性があるpsycopg>=3.2.0の問題を修正しました。この問題は修正され、このメソッドの両方のシグネチャがサポートされるようになりました。

• AIモニタリングが有効な場合にのみMCP（モデルコンテキストプロトコル）スパンが記録されるようにします

  • 設定ai_monitoring.enabledが有効になっている場合にのみ、MCP (モデル コンテキスト プロトコル) スパンが記録されるようにします。

サポートステートメント

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

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