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 |
|
|
MRI |
|
|
ウェブサーバー
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 |
| |
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クライアントは以下のとおりです。
- Net::HTTP：Rubyのエージェントをサポートする全バージョンがサポート対象
- Curb：0.8.1以降
- Excon：0.10.1以降
- HttpClient：2.2.0以降
- HttpRb：0.9.9以降
- Typhoeus：0.5.3以降
メッセージキューイング
メッセージキューのインストゥルメンテーションは、Rubyエージェントのバージョン4.3.0以降でのみ利用可能です。現在サポートされているメッセージブローカー：
- RabbitMQ
その他
APMのRubyエージェントは以下の項目もサポートします。
- ActiveMerchant：1.25.0以降
- Acts_as_Solr
- authlogic
- Bunny：2.0以降
- Dalli
- Memcache-Client
- Sunspot
- Yajl-Ruby:1.1.0 以降
エージェントを他のNew Relicパーツに接続する
Rubyエージェントは他のNew Relic製品と統合して、エンドツーエンドの可視性を提供します。
機能 | インテグレーション |
|---|---|
自動インストゥルメンテーションを有効化すると、Rubyエージェントは自動的にブラウザJavaScriptエージェントを投入します。ブラウザインジェクションを有効化すると、APMの概要ページでブラウザデータを表示でき、特定のアプリに対してAPMとブラウザデータを素早く切り替えできます。設定オプションと手動インストゥルメンテーションについては、BrowserとRubyエージェントのドキュメントをご覧ください。 | |
インフラストラクチャとAPMエージェントを同じホストにインストールすると、それぞれが自動的に相互に検出します。その後、APM UIにホストのリストを表示し、インフラストラクチャUIでAPMアプリでインフラストラクチャホストをフィルタリングできます。詳しくは、インフラストラクチャモニターにおけるAPMデータをご覧ください。 | |
SyntheticトランザクショントレースはSyntheticsモニターからのリクエストを基になるAPMトランザクションに結びつけます。 |
その他のヘルプ
さらに支援が必要な場合は、これらのサポートと学習リソースを確認してください：
- Explorers Hubでは、コミュニティからのサポートを受けたり、ディスカッションに参加したりすることができます。
- 当社サイトで答えを見つけて、サポートポータルの使用方法を確認してください。
- Linux、Windows、およびmacOS向けトラブルシューティングツールであるNew Relic Diagnosticsを実行してください。
- New Relicの とandドキュメント をご確認ください。