Rubyエージェントの要件とサポート対象のフレームワーク

New RelicのRubyエージェントをインストールする前に、お使いのシステムが互換性のある OS、セキュリティプロトコル、 Rubyバージョン、サポートされているフレームワーク/ライブラリの要件を満たしていることを確認してください。

New Relicアカウントをまだお持ちでない場合は、New Relicアカウントを作成することから始めます。永久無料です。

オペレーティングシステム

Rubyエージェントは、Linux、Solaris、FreeBSD、macOS などの UNIX 系 OS をサポートしています。 Windows本番環境では正式にサポートされていませんが、開発では動作する可能性があります。

セキュリティ要件

データ収集:データ収集の標準的なセキュリティ対策として、アプリケーションサーバーは New Relic との SSL 通信用に SHA-2 (256 ビット) をサポートする必要があります。SHA-1はサポートされていません。
TLS: New Relic では、エージェントからのすべての受信接続に TLS 1.2 以上が必要です。

Rubyバージョン

New Relic Ruby エージェントは、実験的なバージョンや非公式の Ruby バージョンをサポートしていません。エージェントは公式の Ruby リリースに対して継続的にテストされます。

Ruby実装	サポート対象	メモ
CRuby（MRI）	3.4.x、3.3.x、3.2.x、3.1.x、3.0.x、2.7.x、2.6.x、2.5.x、2.4.x	Ruby 2.3.x、2.2.x:最後にエージェント v8.16.0 で完全にサポートされました。 Ruby 2.1.x、2.0.x:エージェント v6.15.0 で完全にサポートされました。 Ruby 1.9.3: ラストエージェント v3.18.1。 Ruby 1.8.7: ラストエージェント v3.18.1。
JRuby	9.x	JRuby 1.7.x:ラストエージェント v3.18.1。古いバージョンはサポートされていません。

注: 「エージェント vX.YZ によって最後に完全にサポートされました」とは、エージェントバージョン XYZ がサポートを保証する最後のバージョンであったことを意味します。新しいエージェントは引き続き機能する可能性がありますが、古い Ruby バージョンに対しては積極的にテストされていません。

ウェブサーバー

Ruby エージェントは次の Web サーバーをサポートしています。計装は通常、 Rackにフックされます。

ウェブサーバー	サポート対象	メモ
Puma	6.x、5.x、4.x、3.x	バージョン '<' 3.x: サポートは異なる場合があります。
Unicorn	6.x、5.x	バージョン '<' 4.x: サポートは異なる場合があります。
Passenger	6.x、5.x	バージョン '<' 5.x: サポートは異なる場合があります。
Thin	1.x
Webrick	サポートされているRubyバージョンにバンドルされています	一般的に、開発および基本的な Rack アプリでサポートされています。
Falcon	0.30.x以上

ウェブフレームワーク

Rubyエージェントは、これらの Web フレームワークに堅牢な計装を提供します。

フレームワーク	サポート対象	メモ
Rails	8.0.x、7.1.x、7.0.x、6.1.x、6.0.x、5.2.x	Rails 5.1.x、5.0.x、4.2.x も広範囲にテストされています。 Rails 3.2.x:最後にエージェント v8.16.0 で完全にサポートされました。古いバージョン（例：2.x、3.0.x、3.1.x)最近のエージェントではサポートされていません。
Sinatra	3.x、2.x	シナトラ 1.4.x:最後にエージェント v8.16.0 で完全にサポートされました。古いバージョンはサポートされていません。
Rack	5.x、4.x、3.x
Grape	1.7.x、1.6.x、1.5.x、1.4.x、1.3.x、1.2.x	Grape 0.2.0: 最後にエージェント v8.16.0 で完全にサポートされました。古いバージョンは完全にサポートされない可能性があります。
Padrino	0.15.x	古いバージョン (例: 0.14.x) は、エージェント v8.16.0 で完全にサポートされます。
Roda	3.x

データストアとORM

エージェントインストゥルメントは、さまざまなデータベースとオブジェクトリレーショナルマッパーを使用しました。

データストア / ORM	宝石名	サポート対象	メモ
ActiveRecord	`activerecord`	Railsのバージョンを見る	スタンドアロンでの使用もサポートされています。Redshift アダプターが認識されました。
Sequel	`sequel`	5.17.0以上	続編3.37.x、4.0.x:最後にエージェント v8.16.0 で完全にサポートされました。
MongoDB	`mongo`	2.4.0以上	Mongo 1.8.x - 2.3.x:最後にエージェント v8.16.0 で完全にサポートされました。
Redis	`redis`	5.x、4.x、3.x	`redis-client` (redis-rb 5+ で使用) もインストゥルメントされました。
Memcached（ダリ）	`dalli`	3.x、2.7.x
Memcached (memcached gem)	`memcached`	1.8.x
Elasticsearch	`elasticsearch`	8.x、7.x	`elasticsearch.capture_cluster_name` 利用可能な設定オプション。
オープンサーチ	`opensearch-ruby`	3.x、2.1.x	実験的なサポート。Elasticsearch Elasticsearch類似したテレメトリを提供します。
DynamoDB (AWS SDK)	`aws-sdk-dynamodb`	3.x

New Relicは様々なデータベースとデータベースドライバのインスタンス詳細を収集します。APMで特定のインスタンスおよびデータベース情報のタイプを表示する能力は、New Relicエージェントのバージョンによって異なります。

以下のアダプタをサポートしています:

データベース	アダプタGem名
PostgreSQL	`pg`
MySQL	`mysql2`, `trilogy`
SQLite	`sqlite3`

これは包括的なリストではありません。

現在、New Relicエージェントにリストされてないデータストアからインスタンスレベルの情報をリクエストするには、support.newrelic.comまでお問い合わせください。

バックグラウンドジョブとメッセージングシステム

人気のバックグラウンドジョブ処理とメッセージキューライブラリの計装。

システム/ライブラリ	宝石名	サポート対象	メモ
Sidekiq	`sidekiq`	8.x、7.x、6.x、5.x	Sidekiq 4.2.x:最後にエージェント v8.16.0 で完全にサポートされました。 `sidekiq-delay_extensions`もサポートされています。
Resque	`resque`	2.x、1.27.x	`FORK_PER_JOB`のサポート。
遅延::ジョブ	`delayed_job`	4.1.x	Active Record と Mongoid バックエンド。 Delayed_Job 2.0.x - 4.0.x:最後にエージェント v8.16.0 で完全にサポートされました。
アクティブジョブ	`activejob`	Railsのバージョンを見る
Bunny （ RabbitMQ ）	`bunny`	2.x	Bunny 2.0.x - 2.6.x: 最後にエージェント v8.16.0 で完全にサポートされました。
カフカ (ruby-kafka)	`ruby-kafka`	1.x
カフカ（rdkafka）	`rdkafka`	0.15.x以降
キネシス（AWS SDK）	`aws-sdk-kinesis`	3.x
ファイアホース（AWS SDK）	`aws-sdk-firehose`	3.x
SQS (AWS SDK)	`aws-sdk-sqs`	3.x
ソリッドキュー	`solid_queue`	ActiveJobを参照	ActiveJob で使用されます。`ThreadError: queue empty`デフォルトでは無視されます。

HTTPクライアントとネットワーク

エージェントインストゥルメントされたさまざまな外部サービス用のHTTPクライアントライブラリを監視します。

ライブラリ	宝石名	サポート対象	メモ
Net::HTTP	(Ruby標準ライブラリ)	サポートされているRubyバージョンにバンドルされています	コア HTTP クライアント。
HTTPClient	`httpclient`	2.8.3以上	HttpClient 2.2.0 - 2.8.0 (現在の 2.8.x より前):最後にエージェント v8.16.0 で完全にサポートされました。
タイフーン	`typhoeus`	1.4.x以上	Typhoeus 0.5.3 - 1.2.x:最後にエージェント v8.16.0 で完全にサポートされました。 Hydraのサポート。
エキソン	`excon`	0.56.0以降	Excon '<' 0.55.0:最後にエージェント v8.16.0 で完全にサポートされました。
イーソン	`ethon`	0.12.0以上
縁石	`curb`	0.9.x以上
HTTPX	`httpx`	1.0.0以上
HTTP.rb (http gem)	`http`	5.x、4.x、3.x、2.x	HttpRb 0.9.9 - 2.2.1:最後にエージェント v8.16.0 で完全にサポートされました。
ファラデー	`faraday`		計装はインストゥルメント化されたアダプター (Net::HTTP、Excon など) を介して機能します。
非同期::HTTP	`async-http`	0.59.0以上
gRPC	`grpc`	1.48.0以上	gRPCサーバーとクライアントの計装。

AIおよび機械学習ライブラリ

New Relic は AI/ML ライブラリのサポートを拡張しています。

ライブラリ	宝石名	サポート対象	メモ
オープンAI	`ruby-openai`	3.4.0 以降	`ai_monitoring.enabled = true`が必要です。埋め込みおよびチャット完了エンドポイントへの呼び出しをキャプチャします。カスタムアトリビュートは、 `llm.`プレフィックスを付けて追加できます。

その他のライブラリとテクノロジー

ライブラリ	宝石名	サポート対象	メモ
アクションケーブル	`actioncable`	Railsのバージョンを見る
ActiveMerchant	`activemerchant`	1.65.0以上	ActiveMerchant 1.25.0 - 1.64.x:最後にエージェント v8.16.0 で完全にサポートされました。
カピストラノ	`capistrano`	2.15.5以上
並行Ruby	`concurrent-ruby`	1.1.5以上
ファイバ			Rubyの Fiber クラスの計装。
GraphQL	`graphql`		計装提供： GraphQL gem
Lambda（AWS SDK）	`aws-sdk-lambda`		詳細については、 AWS Lambda監視」を参照してください。
ロガー	`logger`		のロガーライブラリを使用した APMログ転送のサポート。Ruby
ログスタッシャー	`logstasher`	1.xx以上	APM ログ転送のサポート。
ストライプ	`stripe`	5.38.0以上
糸			Rubyの Thread クラスの計装。
ビューコンポーネント		2.53.x以上
ヤジル・ルビー	`yajl-ruby`	1.2.1以上

サポートされているバージョンに関する注意事項

エージェントは、明示的にリストされているバージョンよりも広範囲のバージョン (古いバージョンまたは新しいバージョン) と互換性がある場合があります。ただし、リストされているバージョンは最も厳密なテストを受けています。
新しくサポートされるバージョンや廃止されるバージョンに関する最新情報については、必ずRuby エージェントのリリースノートを参照してください。
ライブラリがリストされていない場合でも、そのライブラリがインストゥルメント化されている基盤テクノロジ (たとえば、* *上に構築されたフレームワーク、または標準データベースRack アダプタを使用した ORM) に依存している場合は、依然としてインストゥルメント化されている可能性があります。リストに掲載されていない重要なライブラリについては、カスタムインストゥルメンテーションを探索するか、機能リクエストを送信できます。

ここで取り上げられていない特定のバージョンやライブラリについて質問がある場合は、 Explorers Hub コミュニティフォーラムにアクセスしてください。

その他のAPMソフトウェア

アプリケーションが当社のエージェント以外にその他のアプリケーションパフォーマンスモニタリング (APM)ソフトウェアを使用している場合は、エージェントが正しく動作することを保証できないため、技術サポートは提供できません。詳細については、その他のモニタリングソフトウェアを使用中のエラーを参照してください。

エージェントを他のNew Relicパーツに接続する

Rubyエージェントは他のNew Relic製品と統合して、エンドツーエンドの可視性を提供します。

機能	説明
AIモニタリング	Ruby エージェントと`ruby-openai` gemを使用して AI データを収集できます。この機能は Ruby エージェントバージョン 9.8.0 で導入され、 `ruby-openai`バージョン 3.4.0 をサポートします。以上。
ブラウザのモニタリング	自動インストゥルメンテーションを有効にすると、Ruby エージェントはbrowser JavaScript エージェントを自動的に挿入します。browserインジェクションを有効にすると、 APMサマリーページでデータを表示し、特定のアプリのAPMとブラウザデータをすばやく切り替えることができます。設定オプションとマニュアルの説明については、 browserとRubyエージェントのドキュメントを参照してください。
インフラストラクチャのモニタリング	インフラストラクチャとAPMエージェントを同じホストにインストールすると、それらは自動的にお互いを検出します。その後、APM UIにホストのリストを表示し、Infrastructure UIのAPMアプリ別にホストをフィルタリングできます。詳細については、Infrastructure UIのAPMデータを参照してください。
合成モニタリング	合成トランザクショントレースは、合成モニターからのリクエストを基盤となるAPMトランザクションに接続します。

この機械翻訳は、参考として提供されています。