Ruby エージェントは、アプリケーションまたはスクリプトによって行われた送信 HTTP リクエストを追跡して、次のことを行うことができます。
- HTTPリクエストの所要時間や、どのホストにヒットしているかなどのメトリクスを記録します。
- トランザクションのトレースに、各HTTPリクエストのノードをアノテートします。
- New Relic で計測されたアプリケーション間のリクエストの分散トレースを提供します。
対応するHTTPクライアントライブラリ
現在、RubyエージェントがサポートしているHTTPクライアントライブラリは以下の通りです。
名前 | 最小限の対応バージョン | メモ |
|---|---|---|
0.59.0 | ||
0.9.3 | Curl::Multi のリクエストは部分的に計測されます。 Curb notes を参照してください。 | |
0.12.0 | Ethon のノートを参照してください。 | |
0.56.0 | エキソンノート を参照してください。 | |
2.8.3 | 非同期のリクエストのインストゥルメンテーションはサポートされていません。 | |
2.2.2 | ||
1.0.0 | ||
Net::HTTP | 該当なし（Ruby標準ライブラリの一部） | また、 httparty など、Net::HTTP をベースにしたライブラリも含まれています。 |
1.3.0 |
イーソンノート
Ethon を保守し、その機能を Ethon に依存している同じチームが Typhoeus も保守しています。各 HTTP リクエストの重複レポートを防ぐため、エージェントは Typhoeus を検出すると Ethon インストルメンテーションを無効にします。
エキソンノート
Ruby エージェントは Excon バージョン0.56.0 以降をサポートします。Excon インストルメンテーションは、Excon ミドルウェアをExcon.defaultsの:middlewaresキーに追加する機能に依存しているため、アプリケーションでExcon.defaultsを変更する場合は、必ず:middlewaresキーの値を保持する必要があります。
カーブノート
Ruby エージェントは、Curb バージョン0.9.3 以降をサポートします。JRuby のカーブ計測はサポートされていません。
Curl::Multi API 経由で行われたリクエストは現在、部分的な分散トレースのみをサポートしています。Ruby エージェントはバッチ全体を表す単一のトランザクション トレース ノードを記録しますが、バッチ内の個々のリクエストの詳細を確認することはできません。