announcements管理者とデータアカウントおよびユーザーの管理データとAPIデータ辞書セキュリティとプライバシーライセンスこの機械翻訳は、参考として提供されています。英語版と翻訳版に矛盾がある場合は、英語版が優先されます。詳細については、このページを参照してください。問題を作成するRubyエージェント6.xから7.xへの移行ガイド概要このガイドでは、Rubyエージェントの6.xシリーズと7.xシリーズの主な変更点、アップグレード時に発生する可能性のある問題、およびバージョン7.xへの移行を成功させる方法について説明します。主な変更点は以下の通りです。2.0および2.1のサポートを終了しました。様々な6.xリリースで非推奨となっていたいくつかのAPIが削除されました。2.0および2.1のサポートを終了しました。リリースでこれらのバージョンのサポートを停止します。これらのバージョンが本質的に機能し続けることを妨げるような既知の変更はありませんが、今後もRubyエージェントが問題なく機能し続けることを保証するものではありません。引き続きご利用ください。エージェントは初期化に失敗し、データのレポートを開始できません。メッセージがログに報告されます。設定および依存関係検出メカニズムは、設定を通じて制御できるようになりました。戦略でアクティブ化されます。構成ファイルに設定がない場合、これらのライブラリのデフォルトの構成設定はautoであり、最適な戦略が選択されます。チェーンにフォールバックするようにエージェントに指示します。例にして、自動インストゥルメンテーションの設定セクションに加えた変更の詳細な説明です。chainコピーヒント使用例としては、未知のgemがコンフリクトしていることが判明した場合です。エージェントがコンフリクトを自動検出して処理するように更新されるまで、ユーザーはコンフリクトを処理するためにメソッド・チェインに戻すことができます。場合によっては、特定のジェムがprependと競合することがあります。このような場合には、自動的にchainにデグレードする自動設定オプションをデフォルトで提供しています。ほとんどの場合、初期設定はこのようになっています。設定ファイルでprepend戦略を指定することで、強制的にprepend戦略を使用することができます。prependコピーヒントこの使用例は、競合するgemの新しいバージョンがリリースされ、prepend戦略との競合がなくなったことがわかっている場合です。ガイドを参照してください。問題にコメントして、見つかったプリペンドの競合についてお知らせください。チェーンにフォールバックできるよう、フィードバックをお待ちしております。2.0において、メソッド定義をメソッド解決スタックの前段に挿入する手段としてprependが導入されました。これは、オリジナルのgemライブラリの実装にtrace/observabilityロジックを適用する際に、prependによってメソッドチェインを行う必要がなくなることを意図したものです。説明されているように、スタックレベルが深すぎるという既知のシナリオに陥る可能性があります。戦略を使用するようにアップデートしてきました。7.0のリリースでは、スタックレベルが深すぎるというエラーを引き起こす可能性がある既知のシナリオを除いて、メソッドチェインではなくプリペンドをデフォルトのストラテジーとして自動計測を行うようになりました。このシナリオにつながる矛盾した外部ジェムを特定するための最善の努力がなされましたが、私たちが特定していない他のものも存在するはずです。これまでは、ほとんどのGemを自動インストルメント化する方法は、メソッド・チェイニングしかありませんでした。7.0のリリースでは、ほとんどのGemをmethod-chainまたはprependのいずれかを使用してインストゥルメントすることができ、自動インストゥルメントされたすべてのGemの設定がこれを反映して更新されました。自動計測機能の近代化に伴い、依存性検出メカニズムにも新しい機能を導入しました。これにより、競合する外部ジェムを特定し、プリペンド戦略からメソッド・チェイニングへと自動的に切り替えることができます。これにより、他のgemのメンテナが、それらのgemと一緒にRubyエージェントを使いやすくするために、gemライブラリに変更を加えることに依存する必要がなくなりました。このような競合はユーザーから報告されるまでわかりません。そのため、これらの競合を自動検出してメソッド・チェイニング戦略に自動的に切り替えることができるのは、自動計測されたライブラリのうちのいくつかに限られます。このようなシナリオを聞き、将来のRubyエージェントのリリースに自動検出機能を追加するためには、皆様のご協力が必要です。接続の作成は適切に処理されていませんでした。エージェントに配布されました。証明書を標準的な方法でサポートしています。これにより、証明書バンドルをバンドルして配布する必要性が大幅に時代遅れになりました。バンドルされている証明書の大部分は期限切れになっているか、期限切れに近づいているため、この依存関係をエージェントから削除することにしました。以降のリリース用にそれらがインストールされていることを確認する必要があります。データが失われる可能性があります。これらは、ホストに応じてさまざまな方法でインストールできます。証明書をインストールするための役立つリンクです。:ca_bundle_path。証明書を参照してください。ブラック/ホワイトリストの属性は機能しなくなりました。whiteをallowedに変更します。無効にすることは機能しなくなりました。次の構成設定を変更します。表示されなくなりました。http.statusCodeに置き換えられました。:trace_onlyオプションをNewRelic::Agent.notice_errorに渡すことは機能しなくなりました。:trace_onlyを:expected属性に置き換えます。コードでエラーが発生します。代わりに、それぞれinsert_distributed_trace_headersとaccept_distributed_trace_headersを参照してください。2.0および2.1のサポートを終了しました。