New RelicのRubyエージェントをインストールする前に、互換OSに対する要件、セキュリティ要件、およびサポート対象のフレームワークを満たしていることを確認してください。
New Relicアカウントをまだお持ちでない場合は、New Relicアカウントを作成することから始めます。永久無料です。
オペレーティングシステム
Rubyエージェントは、Linux、Solaris、FreeBSD、macOSといったUNIX系のオペレーティングシステムをサポートします。
セキュリティ要件
標準的な データ収集のセキュリティ対策として、アプリサーバーはSHA-2(256ビット)をサポートしている必要があります。SHA-1はサポートされていません。
Rubyバージョン
New Relic Rubyエージェントは、実験的なバージョンをサポートしません。RubyエージェントがサポートするRubyバージョンは以下のとおりです。
Rubyバージョン | サポート対象 | 非推奨 |
---|---|---|
JRuby |
|
|
CRuby |
|
|
ウェブサーバー
Rubyエージェントでサポートされるウェブサーバーは以下のとおりです。
ウェブサーバー | サポート対象 | 非推奨 | 実験的 |
---|---|---|---|
Passenger |
| ||
Puma |
|
| |
Rainbows! |
| ||
Thin |
| ||
Unicorn |
|
| |
Webrick | Rubyのエージェントをサポートする全バージョンがサポート対象 |
ウェブフレームワーク
Rubyエージェントは、実験的なバージョンをサポートしません。RubyエージェントでサポートされているWebフレームワークは、以下のとおりです。Grape、Padrino、Sinatraは、Ruby 3.0+ではサポートされていません。
ウェブフレームワーク | サポート対象 | 非推奨 |
---|---|---|
Grape |
| |
Padrino |
| |
Rack |
|
|
Rails |
|
|
Sinatra |
|
|
データベース
Rubyエージェントは、実験的なバージョンをサポートしていません。Rubyエージェントがサポートするデータベースは以下のとおりです。
データベース | サポート対象 | 非推奨 |
---|---|---|
ActiveRecord |
|
|
DataMapper |
| |
Elasticsearch |
| |
Mongo |
| |
Redis |
| |
Sequel |
|
その他のAPMソフトウェア
アプリケーションが当社のエージェント以外にその他のアプリケーションパフォーマンスモニタリング (APM)ソフトウェアを使用している場合は、エージェントが正しく動作することを保証できないため、技術サポートは提供できません。詳細については、その他のモニタリングソフトウェアを使用中のエラーを参照してください。
インスタンスの詳細
New Relicは様々なデータベースとデータベースドライバのインスタンス詳細を収集します。APMで特定のインスタンスおよびデータベース情報のタイプを表示する能力は、New Relicエージェントのバージョンによって異なります。
New RelicのRubyエージェントバージョン3.17.0以降は、以下のORMデータベースをサポートします。
ORM | データベース | アダプター名 | エージェントの最小バージョン |
---|---|---|---|
ActiveRecord 5以降 | 3.17.0 | ||
3.17.0 | |||
ActiveRecord 2.1~4 | 3.17.0 | ||
3.17.0 | |||
3.17.0 |
Rubyエージェントも、次のgem
データベースをサポートします:
Gemデータベース | Gem名 | gemの最低バージョン | エージェントの最小バージョン |
---|---|---|---|
| 3.17.0 | ||
1.8.6 | 3.17.0 | ||
3.0.7 | 3.17.0 |
現在、New Relicエージェントにリストされてないデータストアからインスタンスレベルの情報をリクエストするには、support.newrelic.comまでお問い合わせください。
バックグラウンドジョブ
New Relic Rubyエージェントがサポートするバックグラウンドジョブは以下のとおりです。
バックグラウンドジョブ | サポート対象 | 非推奨 |
---|---|---|
Delayed_Job |
| |
Rake |
|
|
Resque |
|
|
Sidekiq |
|
|
HTTP/ネットワーククライアント
RubyエージェントがサポートするHTTPクライアントは以下のとおりです。
- Curb:0.8.1以降
- Excon:0.19.0以降(0.55.0未満のバージョンは非推奨)
- gRPC:1.0.0以降
- HttpClient:2.2.0以降(バージョン2.2.0~2.8.0は非推奨)
- HttpRb:0.9.9以降(バージョン0.9.9~2.2.1は非推奨)
- Net::HTTP:Rubyのエージェントをサポートする全バージョンがサポート対象
- Typhoeus:0.5.3以降(バージョン0.5.3~1.2.xは非推奨)
メッセージキューイング
メッセージキューのインストゥルメンテーションは、Rubyエージェントのバージョン4.3.0以降でのみ利用可能です。現在サポートされているメッセージブローカー:
- RabbitMQ
メッセージブローカーを容易にする現在サポートされているgem:
- Bunny:2.0以降(バージョン2.0.x~2.6.xは非推奨)
その他
APMのRubyエージェントは以下の項目もサポートします。
- ActiveMerchant:1.25.0以降(バージョン1.25.0~1.64.xは非推奨)
- Acts_as_Solr:非推奨
- authlogic:非推奨
- concurrent-ruby:1.1.5 以降
- Sunspot:非推奨
- Tilt:Ruby 2.2以降、Ruby 2.7以下は1.x
- Yajl-Ruby:1.1.0 以降
エージェントを他のNew Relicパーツに接続する
Rubyエージェントは他のNew Relic製品と統合して、エンドツーエンドの可視性を提供します。
機能 | インテグレーション |
---|---|
自動インストゥルメンテーションを有効化すると、Rubyエージェントは自動的にブラウザJavaScriptエージェントを投入します。ブラウザインジェクションを有効化すると、APMの概要ページでブラウザデータを表示でき、特定のアプリに対してAPMとブラウザデータを素早く切り替えできます。設定オプションと手動インストゥルメンテーションについては、BrowserとRubyエージェントのドキュメントをご覧ください。 | |
インフラストラクチャとAPMエージェントを同じホストにインストールすると、それぞれが自動的に相互に検出します。その後、APM UIにホストのリストを表示し、インフラストラクチャUIでAPMアプリでインフラストラクチャホストをフィルタリングできます。詳しくは、インフラストラクチャモニターにおけるAPMデータをご覧ください。 | |
合成トランザクショントレースは、合成モニターからのリクエストを基盤となるAPMトランザクションに接続します。 |