Your data. Anywhere you go.

New Relic for iOS or Android

Download on the App Store    Android App on Google play

New Relic Insights App for iOS

Download on the App Store

Learn more

Close icon

Memcached - Ruby

Published and supported by New Relic Platform Team

Capture performance and usage data about your Memcached 1.4+ servers to give you insights and improve troubleshooting.

Key, real-time metrics provide an overview of your server as well as detailed measurements about system utilization, cache metrics, and items stored.


Cache Use: Cache miss ratios for all operations (e.g. get/incr/decr), total operations broken down by hits/misses

System Use: Total memory available and consumed, active connections to the service, CPU utilization, and thread use

Items: Average item size, total number of items stored, item creation rate, evictions and reclaims per second


To use this plugin, you must have:

  • A New Relic account
  • A server running Memcached v1.4 or greater
  • Ruby version 1.8.7 or better

Installation information

Manual Installation

  1. Download the latest newrelic_memcached_plugin-X.Y.Z.tar.gz from
  2. Extract the downloaded archive to the location you want to run the Memcached agent from
  3. Run bundle install to install required gems
  4. Copy config/template_newrelic_plugin.yml to config/newrelic_plugin.yml
  5. Edit config/newrelic_plugin.yml with your license key and to point to your instances of Memcached. You can add as many hosts as you'd like If your Memcached instances are bound to an external IP, use that value for the host field. If you omit the 'port' field it will default to '11211'
  6. Edit the config/newrelic_plugin.yml file by changing the name and endpoint fields to match your Memcached server configuration
  7. From your shell run: ./newrelic_memcached_agent
  8. Wait a few minutes for New Relic to begin processing the data sent from your agent.
  9. Log into your New Relic account and click on Memcached on the left hand nav bar to start seeing your Memcached metrics

Installation with Chef/Puppet

Chef and Puppet are tools that automate software installation. The Memcached plugin has installation support for both:

  • Chef:
  • Puppet:

Note: For more information on using Chef and Puppet with New Relic, see the New Relic docs:

More in-depth installation and configuration details are included in the README file packaged with the plugin.

The source code is available on GitHub for full review. New Relic's Memcached plugin is offered under the MIT license.

Github Repository

Additional information regarding this plugin can be located in the README file on its Github project page:


Plugin support or troubleshooting assistance is available by clicking the "Support site" link in the upper right-hand corner of the page, or go directly to

The Memcached - Ruby plugin extends the power of New Relic's monitoring capabilities.

Get This Plugin

Already have a New Relic account? Log in and begin using this plugin.

If you don't have a New Relic account, follow these three simple steps:

How To Install A Plugin

Installing a plugin is simple and fast.

a Plugin
  1. Step One

    Sign in to your New Relic account

  2. Step Two

    Select and install plugin

  3. Step Three

    Start seeing data

That’s it. You’re done. Simple.

Sign Up for New Relic

Back to top icon