Skip to content
Elasticsearch monitoring through New Relic
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

New Relic Elasticsearch Plugin

Monitors Elasticsearch, a flexible and powerful open source, distributed real-time search and analytics engine for the cloud.


In order to use this plugin, you must have an active New Relic account.

Plugin should work on any generic Unix environment with the following software components installed:


Please check config/newrelic_plugin.yml.example for any changes

Instructions for running the Elasticsearch plugin agent

  1. run bundle install to install required gems
  2. Copy config/newrelic_plugin.yml.example to config/newrelic_plugin.yml
  3. Edit config/newrelic_plugin.yml and replace YOUR_LICENSE_KEY_HERE with your New Relic license key
  4. Edit the config/newrelic_plugin.yml file and add Elasticsearch URL
  5. Running the plugin

In order to check your configuration, you can launch the plugin in foreground mode, with all output going to stdout:


Carefully check plugin's output for any possible error messages. In case of success, collected data should appear in the New Relic user interface shortly after starting.

Plugin can also be started as a daemon using the following command:

./newrelic_elasticsearch_agent.daemon start

In this case you can check its status by running:

./newrelic_elasticsearch_agent.daemon status

The daemon can be stopped by running:

./newrelic_elasticsearch_agent.daemon stop

Monit example

# /etc/monit/conf.d/newrelic_elasticsearch_agent.conf
check process newrelic_elasticsearch_agent
  with pidfile /home/ubuntu/newrelic_elasticsearch_agent/
  start program = "/bin/su - ubuntu -c '/home/ubuntu/newrelic_elasticsearch_agent/newrelic_elasticsearch_agent.daemon start'" with timeout 90 seconds
  stop program = "/bin/su - ubuntu -c '/home/ubuntu/newrelic_elasticsearch_agent/newrelic_elasticsearch_agent.daemon stop'" with timeout 90 seconds
  if totalmem is greater than 250 MB for 2 cycles then restart
  group newrelic_agent

Supervisord example

command = bash -c ./newrelic_elasticsearch_agent
directory = /home/ubuntu/newrelic_elasticsearch_agent
autostart = true
autorestart = true
startretries = 10
user = ubuntu
startsecs = 10
redirect_stderr = true
stdout_logfile_maxbytes = 50MB
stopwaitsecs = 10
You can’t perform that action at this time.