Python agent release notesRSS

Notes

This release of the Python agent provides fixes for early activation in Django instrumentation, server side overrides for max_samples_stored being ignored, and guards against crashes from trace_cache.pop().

Install the agent using easy_install/pip/distribute via the Python Package Index or download it directly from the New Relic download site.

Bug fixes

• Prevents early activation in Django instrumentation

  • Remove calls to application_settings() in Django instrumentation to prevent issues with early activations in pre-fork applications.

• Fix server configuration to local configuration sync issues

  • This fixes a bug created when event_harvest_config.harvest_limits.* settings were deprecated in favor of *.max_samples_stored settings. Some server side configurations were not overriding the client side configurations, resulting in data being sent to the collector despite the user disabling this.

• Guard against crashes from trace_cache.pop()

  • In the ContextOf class, there was an unsafe access of the trace_cache via pop(key) without a default value. This caused crashes when the weakref in the dictionary was already garbage collected.

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 エージェントでは、次の変更が加えられています。

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

メモ

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

• Celeryのカスタムタスク
• Graphene-Django監視
• Djangoのミドルウェアフィルタリング
• AWS Bedrock コンバースAPI
• W3CTraceParent ヘッダーのサンプリングフラグ

このリリースでは、次の修正も提供されています。

• GraphQL における最も深いユニークパスの保護
• ウェブ URL リクエスト解析の安全策
• ElasticSearchとGraphQLのフォールバック trace.settings==None
• 非同期 ElasticSearch クライアント リストからoptionsメソッドを削除します

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

新機能

• Celeryのカスタムタスクのサポートを追加

  • Celeryのカスタム タスク クラスの監視サポートを追加します。以前は、デフォルトのタスク クラスを使用するタスクのみをモニターできました。 注意: このバージョンの Python エージェントは、 Celery バージョンv5.2.0未満をサポートしなくなります。

• Graphene-Djangoのサポートを追加

  • Graphene-Djangoで作成された同期スキーマの監視サポートを追加します。以前は、Graphene-Django で作成されたスキーマは部分的にしかモニターされず、 GraphQL関連の属性が欠落していました。

• Django のミドルウェアフィルタリングのサポートを追加

  • ユーザーは、どのDjangoミドルウェアを監視するかをフィルタリングできるようになりました。 追加設定が 3 つあります。

    • instrumentation.middleware.django.enabled (デフォルトはtrueです)
    • instrumentation.middleware.django.exclude
    • instrumentation.middleware.django.include

  詳細と例については、 Django ミドルウェア フィルタリング ページを参照してください。

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

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

• W3CTraceParent ヘッダーのサンプリングフラグのサポートを追加

  • アップストリーム サービスがサンプリング フラグを設定した W3CTraceParent ヘッダーを送信すると、New Relic は現在のトランザクションをサンプリングするかどうかを決定する際にそのサンプリング決定を考慮します。

• リモート親がサンプリングされるかどうかに基づくサンプリング決定のサポートを追加しました

  • 2 つの新しい設定オプションのサポートが追加されました。

    • distributed_tracing.sampler.remote_parent_sampled
    • distributed_tracing.sampler.remote_parent_not_sampled

  • default これはデフォルトの動作であり、この変更前と同じように動作します (サンプリングの決定を適応サンプリング アルゴリズムに渡して、トランザクションをサンプリングするかどうかを決定します)。

  • always_on リモート親がサンプリングされたトレースとリモート親がサンプリングされていないトレースが常にサンプリングされることを意味します。

  • always_off リモート親がサンプリングされたトレース、またはリモート親がサンプリングされていないトレースはサンプリングされないことを意味します。

バグ修正

• GraphQL の最も深いユニークパスに安全策を追加する

  • 一部のユーザーは、フィールド名がNoneを返すため、 GraphQLの最も深い一意のパスが生成されないという問題を経験していました。この問題は修正されました。

• Webリクエスト解析の安全策を追加する

  • request_uriが不正な形式であったり無効な文字が含まれていたりした場合に、一部のユーザーに解析エラーが発生しました。この時点で、リクエスト ヘッダーのrequest_uriが無効であり、最初に指定された (有効な) URL と一致しない場合にこれが発生する可能性があります。この安全対策は現在 New Relic に導入されていますが、 urllib 2025 年 1 月 31 日以降にリリースされた Python のバージョンに対してこの問題を解決しました。

• ElasticSearchとGraphQLのクラッシュを修正 trace.settings==None

  • trace.settingsがNoneの場合、ElasticSearch の計装によりアプリケーションがクラッシュしました。 global_settingsフォールバックが設定されました。これにより、GraphQL で見つかった同じ問題も解決されます。

• 非同期 ElasticSearch クライアント リストからoptionsメソッドを削除します

  • ElasticSearch の以前の計画では、 options非同期メソッドのリストにあったためクラッシュが発生しました。 このメソッドは、データストアの操作やrequestsを実行するものではないため、 DatastoreTraceにラップされなくなりました。

サポートステートメント

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

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

メモ

このリリースの Python エージェントでは、新しいRedis関数のサポートが追加され、すべての内部パスがos.pathからpathlib.Pathに変換され、JSON エンコード PosixPaths に関する問題が修正されました。

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

新機能

• 新しいRedis関数のサポートを追加

  • 新しいRedis関数の計装を追加します。

• すべての内部パスをos.pathから pathlib.Path

  • Windows パスをサポートするための準備として、文字列ベースのパスとos.pathのすべての内部使用をpathlib.Pathに変換します。

バグ修正

• JSON エンコード PosixPath の問題を修正

  • 一部のユーザーで JSON エンコードPosixPath構成設定に関する問題が発生していました。この問題は修正されました。

サポートステートメント

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

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

メモ

このリリースの Python エージェントでは、 oracledbのサポートが追加され、Kombu および Kafka でMessageTransactionオブジェクトに属性destination_nameがないバグが修正され、AWS での使用率メタデータの消失が修正されました。

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

新機能

• oracledbのサポートを追加

  • oracledbの計装を追加します。

バグ修正

• 「 MessageTransactionオブジェクトに属性destination_nameがありません」というバグを修正しました

  • MessageBroker モジュールの、シリアル化メソッドがMessageTransactionのdestination_nameプロパティを検索していたが、それが存在しないというバグを修正しました。

• AWS と K8s を一緒に実行する際における AWS 使用率メタデータの問題を修正

  • AWS EC2インスタンス上で動作するK8s Podの権限設定により、初めて使用状況メタデータを取得できるようになります。 ただし、アプリケーションが継続的に実行されたままになっていると、エージェントは再接続され、使用率メタデータの読み込みに失敗します。このような場合、使用率メタデータはエージェント インスタンスごとにキャッシュされ、取得できるようになります。

サポートステートメント

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

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