New Relic の Ruby エージェントは、 Sinatra 1.2.x 以上で動作します。New Relic の UI では、Sinatra のアクションはコントローラのアクションと同様に表示されます。UI 上のアクションは、マッチングに使用されるパターン式に対応しています。HTTP 操作は区別されません。複数のマッチはすべて別のアクションとして追跡されます。
はじめに
Sinatraを設定するには
最新の
newrelic_rpm
gem をインストールしてください。Sinatra アプリで、Sinatra
require
ディレクティブのすぐ下に以下を追加します。require 'newrelic_rpm'RACK_ENV
を、newrelic.yml
ファイル内の構成定義に対応する環境 (開発、ステージング、本番など) に設定します。
Note: 開発者モードは Rails でのみ機能します。
ミドルウェアのインストール
Ruby エージェントのバージョン 3.6.3 より前の クロスアプリケーショントレースやなどの特定の機能を有効にするには、New Relic ミドルウェアを手動で追加する必要がありました。 必要なミドルウェアの詳細については、 「 Rack ミドルウェア 」を参照するか、最新の Ruby エージェントにアップグレードしてください。
ルートの無視
Ruby エージェント バージョン 3.6.3Rails コントローラーのインストルメンテーションで以前に利用可能だったものと同様に、特定のルートを無視する以上のサポート。これらの値を指定するには、Sinatra アプリケーションの定義に使用するルートと同じスタイルを使用します。たとえば、Sinatra アプリでping
ルートを無視するには、アプリに次のコードを含めます。
newrelic_ignore '/ping'
get '/ping' do # ... end
アプリケーション全体を無視する場合 (マウントされたアプリケーションなど)、パラメータを指定せずにnewrelic_ignore
を呼び出します。
newrelic_ignore
さらに、 newrelic_ignore_apdex
とnewrelic_ignore_enduser
がサポートされています。
newrelic_ignore_apdex
呼び出しは、特定のルートを Apdex 計算全体の考慮から除外します。newrelic_ignore_enduser
呼び出しは、ルートがレンダリングされるときのページ読み込みタイミング JavaScript の自動挿入を防ぎます。
Padrino
Padrino は、Sinatra の上に構築されたフレームワークです。Ruby エージェントのバージョン 3.6.3 以降、New Relic の Sinatra インスツルメンテーションは Padrino のバージョン 0.10.x 以上で動作します。
ショットガン(非対応)
New Relic の Ruby エージェントは、 ショットガン で動作しません。ディスパッチャーのプロセスが終了する前に接続することができません。デベロッパーモードもモニターモードも動作しません。