Ruby agent release notesRSS

重大な変更: 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

機能: Kubernetesのワンステップ計装

Kubernetes APM 、インストゥルメントされたアプリケーションを自動的に自動アタッチし、 Kubernetesデプロイメント内のアップグレードを管理します。 この機能はプレビューを終了し、一般利用可能になりました。Kubernetes の自動接続の詳細をご覧ください。PR#2635 PR#3287

機能: Ruby 2.4 および Ruby 2.5 の非推奨に関するお知らせ

Ruby バージョン 2.4 および 2.5 に対する Ruby エージェントのサポートは非推奨となり、エージェント バージョン 10.0.0 で削除されます。新しい最低限必要な Ruby バージョンは Ruby 2.6 となり、Ruby 2.4 および 2.5 でのテストは停止されます。PR#3288

機能: newrelic deploymentsコマンドの廃止に関するお知らせ

newrelic deploymentsコマンドを使用したデプロイメントの記録のサポートは廃止され、エージェント バージョン 10.0.0 では削除されます。

今後、New Relic に変更を記録するための自動および手動の方法がいくつかある予定です。利用可能なオプションのリストについては、変更追跡 (変更追跡機能)のガイドをご覧ください。 PR#3262

機能: クロスアプリケーショントレースの廃止に関するお知らせ

クロスアプリケーション トレースは、Ruby エージェントのメジャー バージョン 8.0.0 以降では非推奨になっています。エージェントのバージョン 10.0.0 では、そのサポートは完全に削除されます。PR#3288

機能: Ruby 3.5 の Method#source_location の変更との互換性を確保

Ruby 3.5 で 2 要素から 5 要素の配列に変更される Method#source_location の戻り値を正しく解析するようにエージェントを更新しました。この変更により、将来のリリースのサポートが追加されながら、古い Ruby バージョンのサポートが維持されます。PR#3257