Incompatible gems


You are using a Ruby gem that is incompatible with the New Relic Ruby agent.


While New Relic strives to be compatible with all gems, there are some that will not work properly with the Ruby agent. This details incompatible gems and known workarounds.


Problem: The db-charmer gem has incompatibilities in how it patches Rails controllers.

Solution: Force New Relic to load and start before DbCharmer.enable_controller_magic! is called. For example, add the following to your config/application.rb:

require 'newrelic_rpm' 


Problem: Use The escape_utils gem is incompatible with automatic instrumentation for New Relic's page load timing feature (sometimes referred to as real user monitoring or RUM). Due to the way escape_utils monkey-patches Rack, your whole HTML response may be escaped.

Solution: If you see HTML source instead of the rendered page, use either of these options:


Problem: If the right_http_connection gem is loaded after newrelic_rpm, it patches Net::HTTP class in a way that causes New Relic's Externals instrumentation to be missed.

Solution: Ensure that right_http_connection is required before newrelic_rpm.


Problem: The ar-octopus changes the way that ActiveRecord's connection management works, breaking the Ruby agent's ability to gather instance information, apply vendor-specific obfuscation to queries, and capture explain plans for long-running database queries.

Solution: No known workaround - either remove the ar-octopus gem, or continue to use it, in which case no explain plans will be captured.

For more help

Additional documentation resources include:

If you need more help, check out these support and learning resources: