Ruby agent release notesRSS

機能: 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

Feature: Add support for forking processes in Parallel gem instrumentation

Parallel gem instrumentation has been added to allow more consistent monitoring in processes forked using the Parallel gem. PR#3405

Feature: Add support for Grape v3.1.0

Grape's release of v3.1.0 introduced changes that were incompatible with the agent's instrumentation, causing issues when collecting transaction names. The agent has been updated to properly extract class names for transaction naming in the updated Grape API structure. PR#3413

Bugfix: Create health check files in forked processes

The agent now properly initializes health check loops after forking, ensuring each process generates its own health check file. This fix also has the effect of correctly including entity.guid values in the health check files. PR#3409 Issue#3408

Bugfix: Fix sidekiq.ignore_retry_errors

The configuration option sidekiq.ignore_retry_errors: true was continuing to report retry errors. The agent now correctly ignores retry errors and only reports when jobs permanently fail. PR#3399

重大な変更: Ruby 2.4 および 2.5 のサポートを削除

Ruby バージョン 2.4 および 2.5 のサポートは削除されました。新しい最低限必要な Ruby バージョンは 2.6 になりました。PR#3314

重大な変更: クロスアプリケーショントレース (CAT) の削除

以前は、クロスアプリケーション トレーシング (CAT) が非推奨となり、ディストリビューティッド（分散）トレーシングが使用されました。 CAT 機能は削除されました。設定オプションcross_application_tracer.enabledは削除されました。 パブリック API メソッドNewRelic::Agent::External.process_request_metadata 、 NewRelic::Agent::External.get_response_metadata 、 NewRelic::Agent::Transaction::ExternalRequestSegment#process_response_metadata 、 NewRelic::Agent::Transaction::ExternalRequestSegment#get_request_metadata 、およびNewRelic::Agent::Transaction::ExternalRequestSegment#read_response_headersも削除されました。PR#3333

重大な変更: ActiveJob メトリクスとセグメントの名前を変更する

ActiveJob メトリクスが更新され、より具体的なレポートを作成するためにジョブのクラス名が含まれるようになりました。 これは重大な変更であり、カスタムダッシュボードまたはアラートの更新が必要になる場合があります。 PR#3370 PR#3320

• 古い形式: Ruby/ActiveJob/<QueueName>/<Method>
• 新しいフォーマット: Ruby/ActiveJob/<QueueName>/<ClassName>/<Method>

さらに、アクティブ ジョブのキュー登録アクション用に作成されたセグメントにジョブ クラスが含まれるようになりました。

• 古い形式: ActiveJob/<QueueAdapter>/Queue/<Event>/Named/<QueueName>
• 新しいフォーマット: ActiveJob/<QueueAdapter>/Queue/<Event>/Named/<QueueName>/<ClassName>

変更点: bin/newrelicコマンドの名前を次のように変更します bin/newrelic_rpm

エージェントの CLI の実行可能ファイルの名前がbin/newrelicからbin/newrelic_rpmに変更されました。この変更により、スタンドアロンの New Relic CLI ツールとの名前の競合が解決されます。PR#3323

変更点: newrelic deployments CLI コマンドを削除します

非推奨のnewrelic deployments CLI コマンドは削除されました。New Relicの変更とデプロイメントを追跡するには、利用可能なオプションのリストについては、変更追跡 (変更追跡機能)のガイドを参照してください。 PR#3299

重大な変更: NewRelic::エージェント::SqlSampler#notice_sql メソッドを削除

代わりに、ユーザーはNewRelic::Agent::Datastores.notice_sqlを呼び出す必要があります。PR#3338

重大な変更: さまざまな NewRelic::エージェント::Datastores API から未使用の引数を削除

NewRelic::Agent::Datastoresクラスの次の API からメソッド引数が削除されました:

• NewRelic::Agent::Datastores.notice_sqlには、以前は 3 つの位置引数query 、 scoped_metric 、 elapsedがありました。現在はqueryのみになっています。
• NewRelic::Agent::Datastores.notice_statement、以前は 2 つの位置引数queryとelapsedがありました。現在はqueryのみになっています。
• NewRelic::Agent::Datastores.wrap プロセスが必要です。以前は、プロシージャは、yield の結果、最も具体的なスコープのメトリック名、および呼び出しの経過時間という 3 つの引数を受け取りました。 今では、yield の結果のみを受け取ります。

削除された引数の値は、呼び出し時の現在のセグメントから導出されます。PR#3347

重大な変更: 実験的機能の設定可能なセキュリティ ポリシー (CSP) を削除します。

実験的機能である設定可能なセキュリティ ポリシー (CSP) はサポートされなくなり、削除されました。 PR#3292

重大な変更: Puma バージョン '<' 3.9.0 のサポートを削除します

現在サポートされている Puma の最小バージョンは 3.9.0 以上です。PR#3326

重大な変更: 設定の検証と強制実行の改善

係数設定に提供された値を強制および検証するために使用される内部機能は、よりパフォーマンスが向上し、より正確になりました。

• nil がサポートされていない設定の設定値として指定された場合、警告メッセージが newrelic_agent.log ファイルに記録されるようになりました。
• フロート設定タイプには整数値が許可されます
• フロート値は整数設定型で許可されます
• 無効な入力値を置き換えるデフォルト値が見つかると、致命的な中断が防止されますPR#3341

重大な変更: ディストリビューティッド（分散）トレーシング リモート親サンプラーの「default」オプションを「adaptive」に置き換えます。

以前は、 distributed_tracing.sampler.remote_parent_sampledとdistributed_tracing.sampler.remote_parent_not_sampledデフォルト オプションはdefaultであり、既存のアダプティブ サンプラーが使用されていました。defaultオプションの名前がadaptiveに変更されました。PR#3363

機能: logger依存関係として追加

継続的なログ機能と Ruby 4.0.0 以降のバージョンのサポートを確保するために、 logger gem がエージェントの依存関係としてリストされるようになりました。PR#3293

機能: Active Support 通知許可リストの設定オプションを追加

新しい設定オプションinstrumentation.active_support_notifications.active_support_events使用すると、ユーザーはエージェントが購読するアクティブ サポート通知イベント名の許可リストを定義できます。 デフォルトでは、エージェントはすべてのActive Support: CachingおよびActive Support: Messagesイベントをサブスクライブします。PR#3327

機能: Ruby の組み込み Gzip 圧縮を使用する

エージェントは、以前のカスタム実装に代わって、Ruby 標準ライブラリの組み込みZlib.gzipメソッドを圧縮に使用するようになりました。PR#3332

機能: NewRelic::Agent#record_custom_event API の引数検証を追加

無効なevent_typeが指定された場合、 NewRelic::Agent#record_custom_event API はArgumentErrorを発生させるようになりました。有効なイベント タイプは、英数字、アンダースコア (_)、コロン (:)、またはスペース ( ) のみで構成されている必要があります。PR#3319

機能: ルートサンプリング設定オプションを追加

distributed_tracing.sampler.rootを使用して、現在のサービス内で生成されたトレースのサンプリング動作を構成できるようになりました。PR#3330

利用できるモードは 4 つあります。

機能: トレース ID 比率ベースのサンプリング オプションを追加

エージェントは、 OpenTelemetry ID Ratio Based サンプラー アルゴリズムを使用してトレースをサンプリングできるようになりました。 PR#3330トレース ID に基づいて 0.0 ～ 1.0 の確率でトレースをサンプリングします。

このオプションを使用するには、まずディストリビューティッド（分散）トレーシング サンプラー設定をtrace_id_ratio_basedに設定し、次に対応するdistributed_tracing.sampler.*.trace_id_ratio_based.ratioサンプラーを 0.0 ～ 1.0 のフロートに設定する必要があります。

例えば：

distributed_tracing.sampler.remote_parent_sampled: 'trace_id_ratio_based'
  distributed_tracing.sampler.remote_parent_sampled.trace_id_ratio_based.ratio': 0.5

この設定では、リモートの親がサンプリングされるすべてのトレースについて、トレースの約 50% がサンプリングされます。

このオプションは以下で利用可能です:

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

機能: エンティティ GUID をAgent Controlヘルス チェック ファイルに追加します

Agent Control環境内でエージェントが開始されると、各プロセスの構成されたファイルの場所にヘルス チェック ファイルが作成されます。 このファイルには、利用可能な場合、エージェントに関連するエンティティの GUID が含まれるようになりました。PR#3371

バグ修正: GCP 使用率検出におけるNoMethodErrorを解決しました。

GCP メタデータ検出ロジックは、 nilまたは予期しない値を適切に処理し、サービス初期化のクラッシュを防ぐようになりました。PR#3388

機能: SqlSampler#notice_sql API の廃止に関するお知らせ

NewRelic::Agent::SqlSampler#notice_sqlメソッドは非推奨であり、将来のメジャー バージョンで削除される予定です。代わりに、ユーザーはNewRelic::Agent::Datastores.notice_sqlを呼び出す必要があります。PR#3345

機能: Datastores.notice_sql の 2 番目と 3 番目の引数の非推奨通知API

NewRelic::Agent::Datastores.notice_sqlメソッドの 2 番目 (scoped_metric) および 3 番目 (elapsed) の引数は非推奨です。それらはしばらくの間、この方法では使用されていません。代わりに、これらの値は、API が呼び出されたときに現在のセグメントに基づいて設定されます。PR#3345

機能: Datastores.notice_statement の 2 番目の引数の非推奨通知API

NewRelic::Agent::Datastores.notice_statementメソッドの 2 番目の引数 (elapsed) は非推奨です。この方法は、しばらくの間使用されていません。代わりに、この値は API が呼び出されたときに現在のセグメントに基づいて設定されます。PR#3346

機能: Datastores.wrap API の proc の 2 番目と 3 番目の引数の非推奨通知

NewRelic::Agent::Datastores.wrapメソッドは変更されています。将来のメジャー バージョンでは、proc は単一の引数 (yield の結果) のみを受け入れるようになります。スコープ付きメトリック名と経過引数は、 Datastores.notice_sqlメソッドから削除されるため削除されます。 スコープ付きメトリック名と経過値は、ラップが実行されるときに現在のセグメントから導出されます。 PR#3346

機能: sidekiq.ignore_retry_errors を追加設定オプション

Sidekiq ジョブの再試行をキャプチャするかどうかを制御するための新しい設定オプションsidekiq.ignore_retry_errorsが追加されました。 再試行エラーはデフォルトでキャプチャされますが、 sidekiq.ignore_retry_errors trueに設定されている場合、エージェントは Sidekiq の再試行中に発生した例外を無視し、ジョブが永続的に失敗した場合にのみエラーを報告します。この改善点を認識し、解決策を提供してくれたDonGiulioに感謝します。PR#3317

機能: Capistrano を使用したデプロイメントの記録の廃止に関するお知らせ

Capistrano レシピを使用したアプリケーション デプロイメント情報の送信は非推奨となり、エージェント バージョン 10.0.0 で削除される予定です。 デプロイメントの記録については、利用可能なオプションのリストについては、変更追跡 (変更追跡機能)のガイドを参照してください。

機能: リモート親サンプリング設定を使用して、より多くのシナリオで意思決定を行う

以前は、 traceparentおよびtracestateヘッダーが存在する場合にのみ、 distributed_tracing.sampler.remote_parent_sampledおよびdistributed_tracing.sampler.remote_parent_not_sampled設定オプションがサンプリング決定に使用されていました。 現在、これらの設定オプションは、 tracestateヘッダーが欠落しており、 newrelicヘッダーのみが使用可能な場合に適用されます。 この変更により、ディストリビューティッド（分散）トレーシング サンプリングがより一貫性があり、予測可能になります。 PR#3306