Ruby agent release notesRSS

機能：HybridエージェントでSpanLinkイベントがサポートされるようになりました

OpenTelemetry APIによって作成されたスパンに、スパンリンクを関連付けることができるようになりました。リンクは、スパンの開始時にlinks引数に渡すか、OpenTelemetry::Trace::Span#add_link APIを呼び出すことで追加できます。PR#3586

機能：HybridエージェントでSpanEventイベントがサポートされるようになりました

OpenTelemetry APIによって作成されたスパンに、OpenTelemetry::Trace::Span#add_eventAPIを介してSpanEventイベントを関連付けることができるようになりました。SpanEventイベントは、スパン上のタイムスタンプ付きアノテーションをキャプチャし、親スパンと一緒にNew Relicに送信されます。PR#3587

機能：すべてのHybridエージェントスパンにスパンの種類を設定

以前は、外部リクエストセグメントまたはデータストアセグメントに変換されたOpenTelemetryスパンのみが、スパンの種類を属性として追加していました。現在、エージェントは、値が利用可能なすべてのOpenTelemetryスパンにスパンの種類を追加します。PR#3589

機能: OpenTelemetry::Tracer#start_root_spanのサポートを追加

スパンの種類が:serverまたは:consumerである場合、OpenTelemetry::Tracer#start_root_spanAPIを使用して、指定されたスパンのトランザクションを強制的に開始できるようになりました。その他のスパンの種類については、何もしません。このメソッドは、バックグラウンドジョブの計装で最も一般的に使用されます。PR#3588

バグ修正：instrumentation.rails_event_logger: falseが計装を無効にしない問題を修正

以前は、instrumentation.rails_event_loggerをfalseに設定しても、期待どおりにRails.eventの計装が無効になりませんでした；Railsの起動中に引き続きインストールされていました。現在は修正されています。PR#3564

バグ修正：計装設定キーのブール値のような値をdisabledに正規化

以前は、disabledのみがinstrumentation.*設定キーをオフにしていました。現在は、false、no、またはoffなどのブール値のような値もdisabledに解決され、計装がインストールされるのを防ぎます。PR#3579

バグ修正：ライブラリごとのロギングサポートアビリティメトリクスに、各ライブラリの計装状態が反映されるようになりました

以前は、Supportability/Logging/Ruby/{library}/{enabled|disabled}メトリクスは各ライブラリの実際の状態ではなく、すべてのライブラリに対してグローバルなapplication_logging.enabled設定の値を報告していました。その結果、特定のライブラリのロギング計装を無効にしていた場合や、そのライブラリのgemをまったく使用していなかった場合でも、メトリクスはenabledを報告していました。現在、各ライブラリのメトリクスは、自身のロギング計装が有効になっているかどうかを反映しています。PR#3571

機能：Dalli 5.0のサポートを追加し、メタプロトコルの計装を修正

エージェントは、メタプロトコルのみを使用するためにDalli::Protocol::Binaryを削除したDalli 5.0+をサポートするようになりました。Dalli 3.2.0以降の場合、pipelined_getの計装は、Dalli::Protocol::BinaryではなくDalli::Protocol::Base（メソッドが定義されている場所）を正しくターゲットにするようになり、メタプロトコルを使用する際にget_multiの呼び出しが計装されないというギャップが修正されました。Dalli 5.0+では、エージェントは、Dalliの単一サーバーのget_multi最適化によって呼び出されるDalli::Protocol::Meta#read_multi_reqを追加でインストゥルメントします。PR#3541

機能：active_record_use_table_name設定オプションを追加

新しい設定オプションactive_record_use_table_nameは、メトリクス、スパン、およびトランザクショントレースセグメントの名前を付ける際に、Active Recordモデルのクラス名ではなくテーブル名を使用します。これは、単一テーブル継承を使用するアプリケーションでカーディナリティを削減するのに特に役立ちます。既存の動作を維持するため、このオプションはデフォルトでfalseになります。PR#3540

機能：エージェントログ内のライセンスキーを部分的に秘匿化

以前は、エージェントはエージェントログ内のNew Relicライセンスキーを完全に秘匿化していました。これで、最初の10文字が表示され、残りは*に置き換えられます。これにより、キーのシークレット部分を公開することなく、リージョン関連の問題をトラブルシューティングするのに十分な情報が保持されます。PR#3547

バグ修正：Semantic ロガー計装の非互換性を修正 rails_semantic_logger

以前は、rails_semantic_loggerの使用中に例外がActionDispatch::DebugExceptionsに到達すると、ArgumentErrorが発生していました。これは修正されました。ご報告いただいた @jdelStrother に感謝します！ PR#3548

Feature: Add Rails.event instrumentation for structured logging

The agent now supports Rails.event as structured log events. When enabled, events published via Rails.event.notify are captured and forwarded to New Relic as log events. Event payloads, tags, context, timestamps, and source locations are automatically captured as log attributes.

This instrumentation can be configured with the following options:

• instrumentation.rails_event_logger - Controls whether Rails.event instrumentation is enabled. Defaults to use the value of application_logging.enabled.
• instrumentation.rails_event_logger.event_names - An array of specific event names to capture. When empty (default), all Rails.event notifications are captured. Use this to filter events by name, for example: ['user.signup', 'payment.processed'].

PR#3526

Feature: Add instrumentation for Rails Active Job Continuations

The agent now instruments Rails Active Job Continuations, providing visibility into individual step execution within long-running jobs. Step names are included in segment metrics (e.g., Ruby/ActiveJob/default/MyJob/step/process_records) and step-specific attributes like cursor position, resumed status, and interrupted status are captured. A new configuration option, disable_active_job_step_names, allows users to exclude step names from metric names to reduce metric cardinality if needed (defaults to false). PR#3493

Feature: Add sidekiq.separate_transactions configuration option

A new configuration option, sidekiq.separate_transactions, allows Sidekiq jobs executed during a web transaction to run in their own separate transaction. When enabled, this prevents Sidekiq job execution time from being included in web transaction metrics, providing more accurate performance data. The feature is opt-in (default: false) to maintain backward compatibility. This only affects jobs executed during active web transactions; jobs starting independently or nested within other background jobs are unaffected. Issue#3364 PR#3514

Bugfix: Update regexes that may have been vulnerable to ReDOS attacks

Previously, the agent had a few regexes identified as possible targets for polynomial time complexity (ReDOS) attacks. Those regexes are now updated to address the concerns. PR#3520

Bugfix: Prevent crashes during HTTPX segment creation

Previously, if start_external_request_segment encountered an error and returned nil, the agent would trigger a NoMethodError when attempting to add headers to the missing segment. We've added a guard check to ensure the instrumentation handles these cases gracefully.

Bravo to @thebravoman for the report! Issue#3509 PR#3510

Bugfix: Make Transaction#finish idempotent

Previously, if the Transaction#finish method was called multiple times, more than one transaction could be created for the same operation. Now, a mutex protects calls to Transaction#finish to make sure finish operations only run once. PR#3513

Bugfix: Log deprecation warning for Datastores.wrap API once

Previously, this warning was being logged on every call to Datastores.wrap. Now, it will be logged only on the first call. In addition, the documentation has been updated to note the deprecated status of the second and third callback arguments. Issue#3516 PR#3519

機能：SQLコメントによるデータベースクエリ命名機能を追加

データベースクエリにSQLコメントを使用して明示的に名前を付けることができるようになりました。クエリには、追跡と識別を容易にするために安定した名前を割り当てるための/* NewRelicQueryName: CustomName */コメントを含めることができます。これは、パフォーマンス低下やインシデント発生時に特定のデータベースクエリを追跡する際に特に役立ちます。PR#3480

機能: セマンティックロガー計装を追加

エージェントは、 semantic_logger gem バージョン 4.6.0 以降のセマンティック ロガーログ転送と装飾をサポートするようになりました。 以前 Semantic ロガーの組み込みNew Relicアペンダーを使用していた場合は、重複ログの送信を避けるために、いずれかの方法を選択することをお勧めします。 New Relicのセマンティック ロガー計装は、 instrumentation.semantic_loggerをdisabledに設定することで無効にできます。 PR#3467

この計装を形作る上で貴重なフィードバックを提供してくれた@jdelStrotherに感謝します。

機能: 新しい「ignored_middleware_classes」設定を追加

新しい設定オプションignored_middleware_classes使用すると、ユーザーは特定のミドルウェアを計装から除外できます。 ラック::Cors)。デフォルトでは空の配列になります。問題番号1814 PR番号3481

機能: 新しいNewRelic::Agent.add_transaction_log_attributes API を追加

新しいAPI NewRelic::Agent.add_transaction_log_attributes使用すると、ユーザーは、現在の場所のログイベントに、瞬間スコープのカスタムアトリビュートを追加できます。 これらの属性は、現在のトランザクションの範囲内で作成されたログにのみ適用されます。PR#3472

バグ修正：ActionCableブロードキャストメトリクスのカーディナリティを削減するための設定オプションを提供

デフォルトでは、Metrix for ActionCable ブロードキャスト メソッド呼び出しにはブロードキャストの値が含まれます。 この値は非常に高いカーディナリティを持つ可能性があります。 現在、 :simplify_action_cable_broadcast_metrics設定オプションにより、ユーザーはメトリクス名からブロードキャスト値を削除できるようになりました。 これにより、 Ruby/ActionCable/broadcastのようなメトリクスが作成されます。 この設定オプションを有効にすると、ブロードキャスト値がスパン属性として追加されます。PR#3463

バグ修正: FIPS/FedRAMP準拠のための不要な「digest/md5」要件を削除

エージェントのバージョン7.1.0では、FIPS準拠のためMD5の使用がSHA1に置き換えられました（PR） 。しかし、以前の「digest/md5」の要件は削除されませんでした。FIPS/FedRAMP の支援に関する要件を削除しました。 この件を指摘してくださった@ashleyboehsさんに感謝いたします！Issue#3469 PR#3470

バグ修正: シャットダウン遅延を回避するため、 rails testの間にエージェントが起動しないようにする

以前は、エージェントがrails testコマンドを実行すると、約3秒のシャットダウン遅延が発生していました。Railsのテスト実行中にエージェントが起動しないようにするため、定数Rails::Command::TestCommandがデフォルトのautostart.denylisted_constantsリストに追加されました。この件を指摘してくださった@varyformさんに感謝します。PR#3478

バグ修正: Falcon Web サーバーを使用する場合の「経過時間を計算できません」という警告を修正

エージェントは、 Falconで実行するときにThread.current.object_idの代わりにFiber.current.object_id使用して状態を追跡するようになり、同じスレッドを共有する同時requestsによる衝突を防ぎます。 また、Falcon使用時に発生する「NameError: uninitilized constant Async::HTTP::VERSION 」というエラーも修正します。この件を指摘してくださった@97jazさんと@gsarさんに感謝します。PR#3483

バグ修正: harvest.rb のタイプミスにより NoMethodError が発生する問題を修正しました。

lib/new_relic/agent/agent_helpers/harvest.rbタイプミスによりNoMethodError: undefined method 'agent' for NewRelic:Moduleが発生しました。この問題を報告してくれた@oakbowに感謝します。PR#3484

バグ修正: 非推奨の ObjectSpace._id2ref の使用を削除

エージェントは、非推奨のObjectSpace._id2refメソッドの代わりに別の方法を使用するようになり、Ruby 4.0 以降で実行する場合の非推奨警告が解消されます。PR#3490

バグ修正: ロギング計装の NoMethoError を修正

以前は、Logging gem 計装がローカル ログを装飾しようとしたときに、文字列以外のオブジェクトに遭遇するとNoMethodErrorが発生していました。 この問題は修正されました。PR#3501

機能: OpenTelemetry トレースのサポートのためのハイブリッド エージェントの導入

New Relic Rubyエージェントの新しいハイブリッドエージェント機能を使用して、 OpenTelemetry Tracing APIをNew Relicテレメトリーに変換できるようになりました。 これにより、 newrelic_rpm gem はOpenTelemetry SDK と同様に動作し、 OpenTelemetry APIコールを受け入れて、使い慣れた属性と名前を持つNew Relicトランザクションとセグメントに変換できるようになります。

次の設定オプションは、ハイブリッド エージェント機能に関連しています。

機能: 設定オプション error_collector.backtrace_truncate_location を追加

新しい設定オプションerror_collector.backtrace_truncate_locationが追加されました。これにより、フレーム数がerror_collector.max_backtrace_framesを超えた場合にバックトレース内のどこで切り捨てるかをユーザーが指定できるようになりました。 オプションは、 'top' (先頭からフレームを削除)、 'middle' (先頭と末尾を保持したまま中間からフレームを削除)、または'end' (末尾からフレームを削除) です。デフォルトは'middle'です。PR#3424

機能: Logging gem 計装を追加

エージェントは、 Logging gemによって生成されたログを記録するようになりました。PR#3420

機能: 設定オプション utilization.detect_in_parallel を追加

新しい設定オプションutilization.detect_in_parallelが追加されました。これは、エージェントの起動を高速化するためにcloudベンダー情報を検出するときにエージェントがスレッドを使用するかどうかを制御します。 falseに設定すると、ベンダー検出はスレッドを作成せずに順番に実行されます。デフォルトはtrueです。PR#3439