Skip to content
A simple node.js module to count, report and plot application metrics.
JavaScript Makefile
Latest commit 362a104 Feb 27, 2015 @TheDeveloper 0.2.4
Failed to load latest commit information.
lib Merge branch 'master' of github.com:TheDeveloper/abacus Aug 12, 2014
test Debug option Oct 3, 2013
.gitignore Default config Sep 21, 2012
LICENSE License Apr 26, 2013
Makefile List reporter Oct 3, 2013
README.md add printOnFlush option Aug 12, 2014
package.json

README.md

Abacus

A simple node.js module to count, report, and plot application metrics.

Install

npm install abacus

Usage

var Abacus = require('abacus');

var config = {
  statsD: {
    connection:{
      host: 'localhost',
      port: 5007
    },
    // This is the prefix for all metric names sent to statsD / graphite
    metricPrefix: 'apps.abacus.'
  },
  flushFrequency: 60000,
  printFrequency: 10000,
  resetOnFlush: true, // set all values to 0 on flush
  deleteOnFlush: false, // delete all values on flush (will not send 0's)
  printEmpty: true, // whether or not to print empty objects (default false)
  printOnFlush: false, // print the metrics just before flushing them (default false)
  debug: console.log // Prints messages from abacus to STDOUT
};

var metrics = new Abacus(config);

// increment by 1
metrics.increment('metricName');

// increment by 5
metrics.increment('metricName', 5);

// set value of metric
metrics.set('metricName', 153);

// Get value of metric
metrics.get('metricName');

// Print a summary of counters to STDOUT every 10 seconds. This is automatically setup if config.printFrequency is set.
metrics.printPeriodically(10000);

// Periodically flush counters to statsD. This is opposed to sending the counter each time it is changed
// If config.resetOnFlush is false, the counters will be cumulative. Otherwise, they're reset to 0 on each flush.
// This is automatically setup if config.flushFrequency is set.
metrics.flushPeriodically(60000); // in milliseconds. Flush every 60 seconds

Configuration

You can pass a configuration object directly to abacus on instantiation: new Abacus(config);. See usage example.

StatsD

Abacus can be configured to send its counters to an instance of StatsD. You can configure the StatsD connection as shown in the example.

Logging

The debug option allows you to pass in a function that will be invoked each time abacus logs something. If not set, the log will be silently discarded.

Something went wrong with that request. Please try again.