{"_id":"node-statsd","_rev":"326576","name":"node-statsd","description":"node client for Etsy'd StatsD server","dist-tags":{"latest":"0.1.1"},"maintainers":[{"name":"devdazed","email":"rbradberry@gmail.com"},{"name":"dieter","email":"dieter@plaetinck.be"},{"name":"steveivy","email":"steveivy@gmail.com"}],"time":{"modified":"2021-06-07T02:44:52.000Z","created":"2011-02-25T01:39:53.918Z","0.1.1":"2014-12-15T18:56:21.818Z","0.1.0":"2014-11-17T15:09:10.159Z","0.0.7":"2013-04-16T16:55:47.271Z","0.0.6":"2013-03-27T16:08:30.767Z","0.0.5":"2013-03-26T15:42:47.541Z","0.0.4":"2013-03-25T17:33:28.285Z","0.0.3":"2012-09-12T07:57:45.127Z","0.0.2":"2011-08-09T12:49:20.979Z","0.0.1":"2011-02-25T01:39:53.918Z"},"users":{"piron_t":true,"aw":true,"sahilsk":true,"passcod":true,"leizongmin":true,"hugojosefson":true,"antanst":true,"roman-io":true,"wangnan0610":true,"shreyawhiz":true,"rmanalan":true,"swift2728":true,"joselcs":true},"author":{"name":"Steve Ivy"},"repository":{"type":"git","url":"git://github.com/sivy/node-statsd.git"},"versions":{"0.1.1":{"name":"node-statsd","description":"node client for Etsy'd StatsD server","version":"0.1.1","author":{"name":"Steve Ivy"},"contributors":[{"name":"Russ Bradberry","email":"rbradberry@gmail.com"}],"repository":{"type":"git","url":"git://github.com/sivy/node-statsd.git"},"bugs":{"url":"https://github.com/sivy/node-statsd/issues"},"directories":{"lib":"./lib/"},"engines":{"node":">=0.1.97"},"scripts":{"test":"mocha -R spec"},"dependencies":{},"devDependencies":{"mocha":"*"},"licenses":[{"type":"MIT","url":"http://github.com/sivy/node-stats/raw/master/LICENSE"}],"gitHead":"f9fac424543661b2ee2a9348a5fe02f684f4c02f","homepage":"https://github.com/sivy/node-statsd","_id":"node-statsd@0.1.1","_shasum":"27a59348763d0af7a037ac2a031fef3f051013d3","_from":".","_npmVersion":"1.4.23","_npmUser":{"name":"devdazed","email":"rbradberry@gmail.com"},"maintainers":[{"name":"devdazed","email":"rbradberry@gmail.com"},{"name":"dieter","email":"dieter@plaetinck.be"},{"name":"steveivy","email":"steveivy@gmail.com"}],"dist":{"shasum":"27a59348763d0af7a037ac2a031fef3f051013d3","size":4552,"noattachment":false,"key":"/node-statsd/-/node-statsd-0.1.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/node-statsd/download/node-statsd-0.1.1.tgz"},"publish_time":1418669781818,"_cnpm_publish_time":1418669781818,"_hasShrinkwrap":false},"0.1.0":{"name":"node-statsd","description":"node client for Etsy'd StatsD server","version":"0.1.0","author":{"name":"Steve Ivy"},"contributors":[{"name":"Russ Bradberry","email":"rbradberry@gmail.com"}],"repository":{"type":"git","url":"git://github.com/sivy/node-statsd.git"},"bugs":{"url":"https://github.com/sivy/node-statsd/issues"},"directories":{"lib":"./lib/"},"engines":{"node":">=0.1.97"},"scripts":{"test":"mocha -R spec"},"dependencies":{},"devDependencies":{"mocha":"*"},"licenses":[{"type":"MIT","url":"http://github.com/sivy/node-stats/raw/master/LICENSE"}],"gitHead":"032a03ab6d993c9002d91333c3a117be2377d3ca","homepage":"https://github.com/sivy/node-statsd","_id":"node-statsd@0.1.0","_shasum":"3c19db2d051b732936da1067d844306d08732bac","_from":".","_npmVersion":"1.4.23","_npmUser":{"name":"devdazed","email":"rbradberry@gmail.com"},"maintainers":[{"name":"devdazed","email":"rbradberry@gmail.com"},{"name":"dieter","email":"dieter@plaetinck.be"},{"name":"steveivy","email":"steveivy@gmail.com"}],"dist":{"shasum":"3c19db2d051b732936da1067d844306d08732bac","size":4424,"noattachment":false,"key":"/node-statsd/-/node-statsd-0.1.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/node-statsd/download/node-statsd-0.1.0.tgz"},"publish_time":1416236950159,"_cnpm_publish_time":1416236950159,"_hasShrinkwrap":false},"0.0.7":{"name":"node-statsd","description":"node client for Etsy'd StatsD server","version":"0.0.7","author":{"name":"Steve Ivy"},"contributors":[{"name":"Russ Bradberry","email":"rbradberry@gmail.com"}],"repository":{"type":"git","url":"git://github.com/sivy/node-statsd.git"},"bugs":{"url":"https://github.com/sivy/node-statsd/issues"},"directories":{"lib":"./lib/"},"engines":{"node":">=0.1.97"},"scripts":{"test":"node ./node_modules/mocha/bin/mocha -R spec"},"dependencies":{},"devDependencies":{"mocha":"*"},"licenses":[{"type":"MIT","url":"http://github.com/sivy/node-stats/raw/master/LICENSE"}],"readmeFilename":"README.md","_id":"node-statsd@0.0.7","dist":{"shasum":"96d4bbd21dff2d798b3374a3e9329cfecce3afa8","size":6103,"noattachment":false,"key":"/node-statsd/-/node-statsd-0.0.7.tgz","tarball":"http://registry.cnpm.dingdandao.com/node-statsd/download/node-statsd-0.0.7.tgz"},"_from":".","_npmVersion":"1.2.14","_npmUser":{"name":"devdazed","email":"rbradberry@gmail.com"},"maintainers":[{"name":"devdazed","email":"rbradberry@gmail.com"},{"name":"dieter","email":"dieter@plaetinck.be"},{"name":"steveivy","email":"steveivy@gmail.com"}],"publish_time":1366131347271,"_cnpm_publish_time":1366131347271,"_hasShrinkwrap":false},"0.0.6":{"name":"node-statsd","description":"node client for Etsy'd StatsD server","version":"0.0.6","author":{"name":"Steve Ivy"},"contributors":[{"name":"Russ Bradberry","email":"rbradberry@gmail.com"}],"repository":{"type":"git","url":"git://github.com/sivy/node-statsd.git"},"bugs":{"url":"https://github.com/sivy/node-statsd/issues"},"directories":{"lib":"./lib/"},"engines":{"node":">=0.1.97"},"scripts":{"test":"node ./node_modules/mocha/bin/mocha -R spec"},"dependencies":{},"devDependencies":{"mocha":"*"},"licenses":[{"type":"MIT","url":"http://github.com/sivy/node-stats/raw/master/LICENSE"}],"readmeFilename":"README.md","_id":"node-statsd@0.0.6","dist":{"shasum":"18de193a1c7dffec6435c78441e3a109eb08f627","size":6004,"noattachment":false,"key":"/node-statsd/-/node-statsd-0.0.6.tgz","tarball":"http://registry.cnpm.dingdandao.com/node-statsd/download/node-statsd-0.0.6.tgz"},"_from":".","_npmVersion":"1.2.14","_npmUser":{"name":"devdazed","email":"rbradberry@gmail.com"},"maintainers":[{"name":"devdazed","email":"rbradberry@gmail.com"},{"name":"dieter","email":"dieter@plaetinck.be"},{"name":"steveivy","email":"steveivy@gmail.com"}],"publish_time":1364400510767,"_cnpm_publish_time":1364400510767,"_hasShrinkwrap":false},"0.0.5":{"name":"node-statsd","description":"node client for Etsy'd StatsD server","version":"0.0.5","author":{"name":"Steve Ivy"},"contributors":[{"name":"Russ Bradberry","email":"rbradberry@gmail.com"}],"repository":{"type":"git","url":"git://github.com/sivy/node-statsd.git"},"bugs":{"url":"https://github.com/sivy/node-statsd/issues"},"directories":{"lib":"./lib/"},"engines":{"node":">=0.1.97"},"scripts":{"test":"node ./node_modules/mocha/bin/mocha -R spec"},"dependencies":{},"devDependencies":{"mocha":"*"},"licenses":[{"type":"MIT","url":"http://github.com/sivy/node-stats/raw/master/LICENSE"}],"readmeFilename":"README.md","_id":"node-statsd@0.0.5","dist":{"shasum":"7e32898cd7d448b50f37b7f83f0968d7be31f3ef","size":5443,"noattachment":false,"key":"/node-statsd/-/node-statsd-0.0.5.tgz","tarball":"http://registry.cnpm.dingdandao.com/node-statsd/download/node-statsd-0.0.5.tgz"},"_from":".","_npmVersion":"1.2.14","_npmUser":{"name":"devdazed","email":"rbradberry@gmail.com"},"maintainers":[{"name":"devdazed","email":"rbradberry@gmail.com"},{"name":"dieter","email":"dieter@plaetinck.be"},{"name":"steveivy","email":"steveivy@gmail.com"}],"publish_time":1364312567541,"_cnpm_publish_time":1364312567541,"_hasShrinkwrap":false},"0.0.4":{"name":"node-statsd","description":"node client for Etsy'd StatsD server","version":"0.0.4","author":{"name":"Steve Ivy"},"contributors":[{"name":"Russ Bradberry","email":"rbradberry@gmail.com"}],"repository":{"type":"git","url":"git://github.com/sivy/node-statsd.git"},"bugs":{"url":"https://github.com/sivy/node-statsd/issues"},"directories":{"lib":"./lib/"},"engines":{"node":">=0.1.97"},"scripts":{"test":"node ./node_modules/mocha/bin/mocha -R spec"},"dependencies":{},"devDependencies":{"mocha":"*"},"licenses":[{"type":"MIT","url":"http://github.com/sivy/node-stats/raw/master/LICENSE"}],"readmeFilename":"README.md","_id":"node-statsd@0.0.4","dist":{"shasum":"13078eaa193654da4414483efa72e98de75b2933","size":4910,"noattachment":false,"key":"/node-statsd/-/node-statsd-0.0.4.tgz","tarball":"http://registry.cnpm.dingdandao.com/node-statsd/download/node-statsd-0.0.4.tgz"},"_from":".","_npmVersion":"1.2.14","_npmUser":{"name":"devdazed","email":"rbradberry@gmail.com"},"maintainers":[{"name":"devdazed","email":"rbradberry@gmail.com"},{"name":"dieter","email":"dieter@plaetinck.be"},{"name":"steveivy","email":"steveivy@gmail.com"}],"publish_time":1364232808285,"_cnpm_publish_time":1364232808285,"_hasShrinkwrap":false},"0.0.3":{"name":"node-statsd","description":"node client for Etsy'd StatsD server","version":"0.0.3","author":{"name":"Steve Ivy"},"repository":{"type":"git","url":"git://github.com/sivy/node-statsd.git"},"bugs":{"url":"https://github.com/sivy/node-statsd/issues"},"os":["linux","darwin","freebsd"],"directories":{"lib":"./lib/"},"main":"./lib/statsd","engines":{"node":">=0.1.97"},"dependencies":{"mersenne":"*"},"licenses":[{"type":"MIT","url":"http://github.com/sivy/node-stats/raw/master/LICENSE"}],"_id":"node-statsd@0.0.3","dist":{"shasum":"46a6fc98bf1a73af6744247b7d5f6521687e5ebc","size":2420,"noattachment":false,"key":"/node-statsd/-/node-statsd-0.0.3.tgz","tarball":"http://registry.cnpm.dingdandao.com/node-statsd/download/node-statsd-0.0.3.tgz"},"_npmVersion":"1.1.59","_npmUser":{"name":"dieter","email":"dieter@plaetinck.be"},"maintainers":[{"name":"devdazed","email":"rbradberry@gmail.com"},{"name":"dieter","email":"dieter@plaetinck.be"},{"name":"steveivy","email":"steveivy@gmail.com"}],"publish_time":1347436665127,"_cnpm_publish_time":1347436665127,"_hasShrinkwrap":false},"0.0.2":{"name":"node-statsd","description":"node client for Etsy'd StatsD server","version":"0.0.2","author":{"name":"Steve Ivy"},"repository":{"type":"git","url":"git://github.com/sivy/node-statsd.git"},"bugs":{"url":"https://github.com/sivy/node-statsd/issues"},"os":["linux","darwin","freebsd"],"directories":{"lib":"./lib/"},"main":"./lib/statsd","engines":{"node":">=0.1.97"},"dependencies":{"mersenne":"*"},"licenses":[{"type":"MIT","url":"http://github.com/sivy/node-stats/raw/master/LICENSE"}],"_id":"node-statsd@0.0.2","_engineSupported":true,"_npmVersion":"0.2.13","_nodeVersion":"v0.4.1","dist":{"shasum":"ba96c26d4ec22b4f9501bb332fdf740db5a40ee7","size":2209,"noattachment":false,"key":"/node-statsd/-/node-statsd-0.0.2.tgz","tarball":"http://registry.cnpm.dingdandao.com/node-statsd/download/node-statsd-0.0.2.tgz"},"maintainers":[{"name":"devdazed","email":"rbradberry@gmail.com"},{"name":"dieter","email":"dieter@plaetinck.be"},{"name":"steveivy","email":"steveivy@gmail.com"}],"publish_time":1312894160979,"_cnpm_publish_time":1312894160979,"_hasShrinkwrap":false},"0.0.1":{"name":"node-statsd","description":"node client for Etsy'd StatsD server","version":"0.0.1","author":{"name":"Steve Ivy"},"repository":{"type":"git","url":"git://github.com/sivy/node-statsd.git"},"bugs":{"url":"https://github.com/sivy/node-statsd/issues"},"os":["linux","darwin","freebsd"],"directories":{"lib":"./lib/"},"main":"./lib/apac","engines":{"node":">=0.1.97"},"dependencies":{"mersenne":"*"},"licenses":[{"type":"MIT","url":"http://github.com/sivy/node-stats/raw/master/LICENSE"}],"_id":"node-statsd@0.0.1","_engineSupported":true,"_npmVersion":"0.2.13","_nodeVersion":"v0.4.1","dist":{"shasum":"71d8049e2c5b51d7b1a3f9ee76af722a4ddf529e","size":2054,"noattachment":false,"key":"/node-statsd/-/node-statsd-0.0.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/node-statsd/download/node-statsd-0.0.1.tgz"},"publish_time":1298597993918,"maintainers":[{"name":"devdazed","email":"rbradberry@gmail.com"},{"name":"dieter","email":"dieter@plaetinck.be"},{"name":"steveivy","email":"steveivy@gmail.com"}],"_cnpm_publish_time":1298597993918,"_hasShrinkwrap":false}},"readme":"# node-statsd\n\nA node.js client for [Etsy](http://etsy.com)'s [StatsD](https://github.com/etsy/statsd) server.\n\nThis client will let you fire stats at your StatsD server from a node.js application.\n\nnode-statsd Runs and is tested on Node 0.6+ on all *nix platforms and 0.8+ on all platforms including Windows.\n\n[![Build Status](https://secure.travis-ci.org/sivy/node-statsd.png?branch=master)](http://travis-ci.org/sivy/node-statsd)\n\n## Installation\n\n```\n$ npm install node-statsd\n```\n\n## Usage\n\nAll initialization parameters are optional.\n\nParameters (specified as an options hash):\n* `host`:        The host to send stats to `default: localhost`\n* `port`:        The port to send stats to `default: 8125`\n* `prefix`:      What to prefix each stat name with `default: ''`\n* `suffix`:      What to suffix each stat name with `default: ''`\n* `globalize`:   Expose this StatsD instance globally? `default: false`\n* `cacheDns`:    Cache the initial dns lookup to *host* `default: false`\n* `mock`:        Create a mock StatsD instance, sending no stats to the server? `default: false`\n* `global_tags`: Optional tags that will be added to every metric `default: []`\n\nAll StatsD methods have the same API:\n* `name`:       Stat name `required`\n* `value`:      Stat value `required except in increment/decrement where it defaults to 1/-1 respectively`\n* `sampleRate`: Sends only a sample of data to StatsD `default: 1`\n* `tags`:       The Array of tags to add to metrics `default: []`\n* `callback`:   The callback to execute once the metric has been sent\n\nIf an array is specified as the `name` parameter each item in that array will be sent along with the specified value.\n\n```javascript\n  var StatsD = require('node-statsd'),\n      client = new StatsD();\n\n  // Timing: sends a timing command with the specified milliseconds\n  client.timing('response_time', 42);\n\n  // Increment: Increments a stat by a value (default is 1)\n  client.increment('my_counter');\n\n  // Decrement: Decrements a stat by a value (default is -1)\n  client.decrement('my_counter');\n\n  // Histogram: send data for histogram stat\n  client.histogram('my_histogram', 42);\n\n  // Gauge: Gauge a stat by a specified amount\n  client.gauge('my_gauge', 123.45);\n\n  // Set: Counts unique occurrences of a stat (alias of unique)\n  client.set('my_unique', 'foobar');\n  client.unique('my_unique', 'foobarbaz');\n\n  // Incrementing multiple items\n  client.increment(['these', 'are', 'different', 'stats']);\n\n  // Sampling, this will sample 25% of the time the StatsD Daemon will compensate for sampling\n  client.increment('my_counter', 1, 0.25);\n\n  // Tags, this will add user-defined tags to the data\n  client.histogram('my_histogram', 42, ['foo', 'bar']);\n\n  // Using the callback\n  client.set(['foo', 'bar'], 42, function(error, bytes){\n    //this only gets called once after all messages have been sent\n    if(error){\n      console.error('Oh noes! There was an error:', error);\n    } else {\n      console.log('Successfully sent', bytes, 'bytes');\n    }\n  });\n\n  // Sampling, tags and callback are optional and could be used in any combination\n  client.histogram('my_histogram', 42, 0.25); // 25% Sample Rate\n  client.histogram('my_histogram', 42, ['tag']); // User-defined tag\n  client.histogram('my_histogram', 42, next); // Callback\n  client.histogram('my_histogram', 42, 0.25, ['tag']);\n  client.histogram('my_histogram', 42, 0.25, next);\n  client.histogram('my_histogram', 42, ['tag'], next);\n  client.histogram('my_histogram', 42, 0.25, ['tag'], next);\n```\n\n## Errors\n\nIn the event that there is a socket error, `node-statsd` will allow this error to bubble up.  If you would like to catch the errors, just attach a listener to the socket property on the instance.\n\n```javascript\nclient.socket.on('error', function(error) {\n  return console.error(\"Error in socket: \", error);\n});\n```\n\nIf you want to catch errors in sending a message then use the callback provided.\n\n## License\n\nnode-statsd is licensed under the MIT license.\n\n","_attachments":{},"homepage":"https://github.com/sivy/node-statsd","bugs":{"url":"https://github.com/sivy/node-statsd/issues"}}