npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

appmetrics-statsd-client

v1.1.4

Published

StatsD connector for Node Application Metrics

Downloads

3

Readme

StatsD Connector for Node Application Metrics

A connector that collects data using 'appmetrics' and sends it to a configured StatsD server using 'node-statsd'.

Getting Started

Installation

The StatsD Connector for Node Application Metrics can be installed via npm:

$ npm install appmetrics-statsd-client

Configuring the StatsD Connector for Node Application Metrics

The connector can be used in your application by requiring it as the first line of your application:

var appstatsd = require('appmetrics-statsd-client').StatsD();

Configuration of the connection to the StatsD server is possible by passing parameters to the StatsD() function. These are passed directly though to the StatsD constructor in the node-statsd module. Information for that module is available here: https://www.npmjs.com/package/node-statsd

Additional data may also be sent to StatsD using the standard node-statsd module Client APIs, eg.

var statsd = require('appmetrics-statsd-client').StatsD();

statsd.gauge('gauge', 10.4);

Data Provided

The connector sends the following data values to StatsD from Node Application Metrics:

CPU

Gauges

  • cpu.process the CPU usage of the application as a percentage of total machine CPU
  • cpu.system the CPU usage of the system as a percentage of total machine CPU

System Memory

Gauges

  • memory.process.private the amount of memory used by the Node.js application that cannot be shared with other processes, in bytes.
  • memory.process.physical the amount of RAM used by the Node.js application in bytes.
  • memory.process.virtual the memory address space used by Node.js application in bytes.
  • memory.system.used the total amount of RAM in use on the system in bytes.
  • memory.system.total the total amount of RAM available on the system in bytes.

####Event Loop

  • eventloop.latency.min the shortest sampled latency for processing an event
  • eventloop.latency.max the longest sampled latency for processing an event
  • eventloop.latency.avg the mean sampled latency for processing an event

####Garbage Collection

Gauges

  • gc.size the size of the JavaScript heap in bytes.
  • gc.used the amount of memory used on the JavaScript heap in bytes.

Timers

  • gc.duration the duration of the GC cycle in milliseconds.

####HTTP Requests

Timers

  • http the time taken for the HTTP request to be responded to in ms.

####Socket.io

Timers

  • socketio.broadcast.<event> the time taken for the broadcast to all clients of the named socketio event.
  • socketio.emit.<event> the time taken for the emit to a single client of the named socketio event.
  • socketio.receive.<event> the time taken for a received named socketio event to be handled.

####MySQL Queries

Timers

  • mysql the time taken for the given MySQL query to be responded to in ms.

####MongoDB Queries

Timers

  • mongo the time taken for the given MongoDB query to be responded to in ms.

####Leveldown Queries

Timers

  • levedown.get the time taken for the Leveldown get to be responded to in ms.
  • levedown.put the time taken for the Leveldown put to be responded to in ms.
  • levedown.del the time taken for the Leveldown del to be responded to in ms.
  • levedown.batch the time taken for the Leveldown batch to be run in ms.

####Redis Queries

Timers

  • redis.<cmd> the time taken for the given Redis command to be responded to in ms.

####Memcached Operations

Timers

  • memcached.<method> the time taken for the given Memcached method to be responded to in ms.

####PostgreSQL Queries

Timers

  • postgres the time taken for the given PostgresSQL query to be responded to in ms.

####MQTT Messaging

Timers

  • mqtt.<method>.<topic> the time taken for a MQTT message to handled on a given topic in ms.

####MQLight Messaging

Timers

  • mqlight.<method>.<topic> the time taken for a MQLight message to handled on a given topic in ms.

License

The Node Application Metrics to StatsD Connector is licensed using an Apache v2.0 License.

Version

1.1.3

Version History

1.1.4 Fix documentation 1.1.2 Fix broken link 1.1.1 Upgrade appmetrics version and migrate to statsd-client package 1.0.1 Add support for Event Loop, HTTP, Socketio, MongoDB, MySQL, Leveldown, Redis, Memcached, POstgreSQL, MQTT and MQLight
1.0.0 Initial release