The New Relic Infrastructure Integration for Elasticsearch captures critical performance metrics and inventory reported by Elasticsearch clusters. Data on the cluster, nodes, shards, and indices is collected.
Inventory data is obtained from the elasticsearch.yml file, and metrics and additional inventory data is obtained from the REST API.
No additional requirements
- download an archive file for the
ElasticsearchIntegration - extract
elasticsearch-definition.ymland/bindirectory into/var/db/newrelic-infra/newrelic-integrations - add execute permissions for the binary file
nr-elasticsearch(if required) - extract
elasticsearch-config.yml.sampleinto/etc/newrelic-infra/integrations.d
This is the description about how to run the ElasticSearch Integration with New Relic Infrastructure agent, so it is required to have the agent installed (see agent installation).
In order to use the ElasticSearch Integration it is required to configure elasticsearch-config.yml.sample file. Firstly, rename the file to elasticsearch-config.yml. Then, depending on your needs, specify all instances that you want to monitor. Once this is done, restart the Infrastructure agent.
You can view your data in Insights by creating your own custom NRQL queries. To do so use the ElasticsearchClusterSample, ElasticsearchIndexSample, ElasticsearchNodeSample event type.
- Supported OS: No limitations
- elasticsearch versions: 5.0+
Assuming that you have source code you can build and run the Elasticsearch Integration locally.
- Go to directory of the Elasticsearch Integration and build it
$ make- The command above will execute tests for the Elasticsearch Integration and build an executable file called
nr-elasticsearchinbindirectory.
$ ./bin/nr-elasticsearch- If you want to know more about usage of
./nr-elasticsearchcheck
$ ./bin/nr-elasticsearch -helpFor managing external dependencies govendor tool is used. It is required to lock all external dependencies to specific version (if possible) into vendor directory.