Sign Up for Free

RunKit +

Try any Node.js package right in your browser

This is a playground to test code. It runs a full Node.js environment and already has all of npm’s 400,000 packages pre-installed, including @nearform/stats-to-elasticsearch with all npm packages installed. Try it out:

var statsToElasticsearch = require("@nearform/stats-to-elasticsearch")

This service is provided by RunKit and is not affiliated with npm, Inc or the package authors.

@nearform/stats-to-elasticsearch v1.0.0

Collect and send stats about your node.js process to elasticsearch


Build Status

Collect and send stats about your node.js process to elasticsearch.

This module exposes a function which initialises a connection to elasticsearch and creates a stats event emitter to gather useful in process stats to be sent via the connection.

Intro to the nearform stats tooling

Created with the purpose to make creating visualisations about your process easy. At nearform, we achieve this using the modules stats, stats-to-elasticsearch and create-stats-dashboard. This makes it very easy to collect process stats in elasticsearch and visualise them in a dashboard in kibana, similar to that below:

a kibana stats dashboard screenshot

Once your dashboard is setup with create-stats-dashboard, all you should need to do is require the stats-to-elasticsearch module and point it at the dashboard to get cool (and useful) visualisations!


npm i -s @nearform/stats-to-elasticsearch


const StatsToElastic = require('@nearform/stats-to-elasticsearch')
const statsToElastic = StatsToElastic({elaticsearchConfig: {...}, statsConfig: {...}})

Or you can preload your process with this module like so:

ES_HOST=localhost ES_PORT=9200 node -r @nearform/stats-to-elasticsearch index.js



Returns: An object configured with an open connection to elasticsearch and a stats event emitter to gather stats from.

Opts is an object which can contain the following properties:

  • elasticsearchConfig: a configuration object which is passed to the elasticsearch module when initialising the connection. Configured with the following defaults:
    •   {
          host: 'localhost:9200',
          log: 'error',
          maxRetries: Number.MAX_SAFE_INTEGER,
          sniffOnStart: true,
          keepAlive: true,
          sniffOnConnectionFault: true

The host property can be modified using the ES_HOST and ES_PORT env variables. Useful if preloading your process.

  • statsConfig: A configuration object which is passed to the stats module when initialising the stats event emitter. Configured to use the standard stats defaults.

The object which was returned contains the following methods:


Starts the stats event emitter emitting stats to be sent to elasticsearch - NOTE: Called automatically on startup, only neccessary if you stop emitting events


Stops the stats event emitter emitting stats


Closes the connection to elasticsearch and stop the event emitter emitting stats, so you can cleanly exit your process


Reconnects to elasticsearch if no longer connected. NOTE: this doesn't call start, so call start() yourself if you need to.

Useful links


Apache 2.0


RunKit is a free, in-browser JavaScript dev environment for prototyping Node.js code, with every npm package installed. Sign up to share your code.
Sign Up for Free