Awesome
Memcached Ruby Plugin for New Relic
Prerequisites
- A New Relic account. Signup for a free account at http://newrelic.com
- A server running Memcached v1.4 or greater. Download the latest version of Memcached for free here.
- Ruby version 1.8.7 or better
Installation
The Memcached plugin can be installed manually or automatically with Chef and Puppet. For Chef and Puppet support see the New Relic plugin's Chef Cookbook and Puppet Module.
Additional information on using Chef and Puppet with New Relic is available in New Relic's documentation.
Running the Agent
- Download the latest
newrelic_memcached_plugin-X.Y.Z.tar.gz
from the tags list - Extract the downloaded archive to the location you want to run the Memcached agent from
- Run
bundle install
to install required gems - Copy
config/template_newrelic_plugin.yml
toconfig/newrelic_plugin.yml
- 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' - Edit the
config/newrelic_plugin.yml
file by changing the name and endpoint fields to match your Memcached server configuration - From your shell run:
./newrelic_memcached_agent
- Wait a few minutes for New Relic to begin processing the data sent from your agent.
- Log into your New Relic account at http://newrelic.com and click on
Memcached
on the left hand nav bar to start seeing your Memcached metrics
Source Code
This plugin can be found at https://github.com/newrelic-platform/newrelic_memcached_plugin
Contributing
You are welcome to send pull requests to us - however, by doing so you agree that you are granting New Relic a non-exclusive, non-revokable, no-cost license to use the code, algorithms, patents, and ideas in that code in our products if we so choose. You also agree the code is provided as-is and you provide no warranties as to its fitness or correctness for any purpose.