Redis instrumentation

The New Relic Ruby agent automatically instruments the Redis gem (gem version 3.0.0 or higher). In APM, you can view Redis operations on the APM Overview page, in the Databases page, and in transaction traces.

Redis instrumentation requires Ruby agent version 3.13.0 or higher.

Interaction with newrelic-redis

newrelic-redis is a third-party gem that provides Redis instrumentation support as an add-on to the Ruby agent. If the Ruby agent detects newrelic-redis, it won't install the built-in Redis instrumentation and will record a log message like this at startup:

INFO : Not installing New Relic supported Redis instrumentation because the third party newrelic-redis gem is present

To use New Relic's built-in Redis instrumentation, remove the newrelic-redis gem.

Removing the newrelic-redis gem in favor of the built-in instrumentation will change your transaction names. To preserve your existing transaction names, ignore the log message and do not uninstall the gem.

Capture Redis command arguments

By default, the agent only captures Redis command names. To capture Redis command arguments, use the configuration below:

  record_redis_arguments: true

The agent limits the number of characters and arguments collected from each transaction trace node. The agent truncates items that exceed these limits.

For more help

Additional documentation resources include:

Join the discussion about Ruby in the New Relic Online Technical Community! The Technical Community is a public platform to discuss and troubleshoot your New Relic toolset.

If you need additional help, get support at