New RelicのRubyエージェントをインストールする前に、互換OSに対する要件、セキュリティ要件、およびサポート対象のフレームワークを満たしていることを確認してください。
New Relicアカウントをまだお持ちでない場合は、New Relicアカウントを作成することから始めます。永久無料です。
オペレーティングシステム
Rubyエージェントは、Linux、Solaris、FreeBSD、macOSといったUNIX系のオペレーティングシステムをサポートします。
セキュリティ要件
標準的なデータ収集のセキュリティ対策として、アプリサーバーはSHA-2（256ビット）をサポートしている必要があります。SHA-1はサポートされていません。New Relicでは、すべてのインバウンド接続にTLS 1.2以上が必要です。
Rubyバージョン
New Relic Rubyエージェントは、実験的なバージョンをサポートしません。RubyエージェントがサポートするRubyバージョンは以下のとおりです。
Rubyバージョン | サポート対象 | 非推奨 |
|---|---|---|
JRuby |
|
|
CRuby |
|
|
ウェブサーバー
Rubyエージェントでサポートされるウェブサーバーは以下のとおりです。
ウェブサーバー | サポート対象 | 非推奨 |
|---|---|---|
Passenger |
|
|
Puma |
|
|
Rainbows! |
| 4.5.0：最後にサポートされたエージェントは、8.16.0です。 |
Thin |
| |
Unicorn |
|
|
Webrick | Rubyのエージェントをサポートする全バージョンがサポート対象 |
ウェブフレームワーク
Rubyエージェントは、実験的なバージョンをサポートしていません。Rubyエージェントでサポートされているウェブフレームワークは、以下のとおりです。Grape、Padrino、Sinatraは、Ruby 3.0+ではサポートされていません。
ウェブフレームワーク | サポート対象 | 非推奨 |
|---|---|---|
Grape |
|
|
Padrino |
|
|
Rack |
|
|
Rails |
|
|
Roda |
| |
Sinatra |
|
|
データベース
Rubyエージェントは、実験的なバージョンをサポートしていません。Rubyエージェントがサポートするデータベースは以下のとおりです。
データベース | サポート対象 | 非推奨 |
|---|---|---|
アクティブレコード |
|
|
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クライアントは以下のとおりです。
- Async::HTTP：0.59.0以降
- Curb：0.8.1以降
- Ethon：0.12.0以降
- Excon：0.19.0以降（エージェントバージョン8.16.0で最後にサポートされた0.55.0以前のバージョン）
- gRPC：1.0.0以降
- HttpClient：2.2.0以降（エージェントバージョン8.16.0で最後にサポートされた2.2.0～2.8.0のバージョン）
- HttpRb：0.9.9以降（エージェントバージョン8.16.0で最後にサポートされた0.9.9～2.2.1のバージョン）
- HTTPX：1.0.0以降
- Net::HTTP：Rubyのエージェントをサポートする全バージョンがサポート対象
- Typhoeus：0.5.3以降（エージェントバージョン8.16.0で最後にサポートされた0.5.3～1.2.xのバージョン）
メッセージキューイング
メッセージキューのインストゥルメンテーションは、Rubyエージェントのバージョン4.3.0以降でのみ利用可能です。現在サポートされているメッセージブローカー：
- RabbitMQ
メッセージブローカーを容易にする現在サポートされているgem：
- Bunny：2.0以降（エージェントバージョン8.16.0で最後にサポートされた2.0.x～2.6.xのバージョン）
その他
APMのRubyエージェントは以下の項目もサポートします。
- ActiveMerchant: 1.25.0 以上 (バージョン 1.25.0 - 1.64.x はエージェント バージョン 8.16.0 で最後にサポートされました)
- Acts_as_Solr: エージェントバージョン 8.16.0 で最後にサポートされました
- authlogic: エージェントバージョン 8.16.0 で最後にサポートされました
- concurrent-ruby: 1.1.5 以上
- Stripe: 5.38.0以上
- Sunspot: エージェントバージョン 8.16.0 で最後にサポートされました
- Tilt: Ruby 2.2 以上の場合は 2.x、Ruby 2.7 以下の場合は 1.x
- Yajl-Ruby: 1.1.0 以上
エージェントを他のNew Relicパーツに接続する
Rubyエージェントは他のNew Relic製品と統合して、エンドツーエンドの可視性を提供します。
機能 | 機能 |
|---|---|
Ruby エージェントと | |
自動インストゥルメンテーションを有効にする と、Ruby エージェントはbrowser JavaScript エージェントを自動的に挿入します。browserインジェクションを有効にすると、 APMサマリー ページで データを表示し、特定のアプリのAPMとブラウザデータをすばやく切り替えることができます。 設定オプションとマニュアルの説明については、 browserとRubyエージェントのドキュメントを参照してください。 | |
インフラストラクチャとAPMエージェントを同じホストにインストールすると、それらは自動的にお互いを検出します。その後、APM UIにホストのリストを表示し、Infrastructure UIのAPMアプリ別にホストをフィルタリングできます。詳細については、Infrastructure UIのAPMデータを参照してください。 | |
合成トランザクショントレースは、合成モニターからのリクエストを基盤となるAPMトランザクションに接続します。 |