As of version 3.10.0, the New Relic Ruby agent has built-in support for instrumenting Grape applications. The minimum Grape version that the Ruby agent will instrument automatically is 0.2.0.
Usage with third-party gem
newrelic-grape is a third-party gem that provides Grape instrumentation support as an add-on to the Ruby agent. If the
newrelic-grape gem is detected, the Ruby agent will not install New Relic's built-in Grape instrumentation, and a log message like this will appear at startup:
INFO : Not installing New Relic supported Grape instrumentation because the third party newrelic-grape gem is present
If you want to use New Relic's official (built-in) Grape instrumentation, remove the
newrelic-grape gem. (The transaction names captured by New Relic's official Grape instrumentation contain more detail. For example, they include the API version even if you are using non-path-based versioning.) However, if you want to continue using the
newrelic-grape instrumentation to preserve your existing transaction names, you may safely ignore this message.
Parameter capture with Grape
capture_params configuration setting, you can configure the Ruby agent to automatically capture request parameters on incoming API requests serviced by Grape. This will attach the captured parameters to transaction traces and traced errors.
Note: If you are using Grape's declared parameters, the captured parameters will be the raw
params before passing through the
Grape and cross application tracing
New Relic's Cross Application Tracing feature allows you to better understand calls between multiple applications that are all monitored with New Relic agents on the same account. This is usefule, for example, to see which other applications are making calls into your Grape API. Cross application tracing should work automatically for any Rack application, including Grape apps.
Exception: If you have explicitly set the
disable_middleware_instrumentation configuration setting to disable instrumention of third-party Rack middlewares, you will need to manually include the