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

api-benchmark

v1.0.1

Published

A simple nodejs tool to measure and compare performances of api services

Downloads

5,010

Readme

api-benchmark

Greenkeeper badge

A node.js tool that measures and compares performances of single and multiple apis inspired by BenchmarkJs. Gitter

Why all of this? (blog post)

https://raw.github.com/matteofigus/api-benchmark-www/master/public/images/screen-shot.png

To see an example of a request/response look at this gist.

If you want to benchmark your api via grunt take a look at grunt-api-benchmark.

Requirements

Node version: min: 4, recommended: 8

Build status: Unix: Build Status | Windows: Build status

NPM

Installation

npm i api-benchmark

Usage

measure(service, routes, [options], callback)

Measures performances of a given api for multiple routes

var apiBenchmark = require('api-benchmark');

var service = {
  server1: 'http://myserver:myport/mypath/'
};

var routes = { route1: 'route1', route2: 'route2' };

apiBenchmark.measure(service, routes, function(err, results) {
  console.log(results);
  // displays some stats!
});

compare(services, routes, [options], callback)

Compares performances of a given list of api servers with the same routes. Useful in case of load balancers, globalised services, deployment of new versions.

var apiBenchmark = require('api-benchmark');

var services = {
  server1: 'http://myserver:myport/mypath/',
  server2: 'http://myserver2:myport2/mypath2/'
};

var routes = { route1: 'route1', route2: 'route2' };

apiBenchmark.compare(services, routes, function(err, results) {
  console.log(results);
  // displays some stats, including the winner!
});

All the Http verbs and headers are supported.

var apiBenchmark = require('api-benchmark');

var services = {
  server1: 'http://myserver:myport/mypath/',
  server2: 'http://myserver2:myport2/mypath2/'
};

var routes = {
  route1: {
    method: 'get',
    route: 'getRoute',
    headers: {
      Cookie: 'cookieName=value',
      Accept: 'application/json'
    }
  },
  route2: 'getRoute2',
  route3: {
    method: 'post',
    route: 'postRoute',
    data: {
      test: true,
      moreData: 'aString'
    }
  }
};

apiBenchmark.compare(services, routes, function(err, results) {
  console.log(results);
  // displays some stats, including the winner!
});

getHtml(results, callback)

Given a results object, gets the html report.

var apiBenchmark = require('api-benchmark');

var service = {
  server1: 'http://myserver:myport/mypath/'
};

var routes = { route1: 'route1', route2: 'route2' };

apiBenchmark.measure(service, routes, function(err, results) {
  apiBenchmark.getHtml(results, function(error, html) {
    console.log(html);
    // now save it yourself to a file and enjoy
  });
});

Route object

method

(String, default 'get'): Http verb.

route

(String): the route to benchmark

headers

(Object): the headers to send. In case of function (that has to return an object) it will be evaulated for each request.

data

(Object): the data sent with the request. In case of function (that has to return an object) it will be evaulated for each request.

query

(Object): the query sent with the request. In case of function (that has to return an object) it will be evaulated for each request.

expectedStatusCode

(Number, default null): if it is a number, generates an error when the status code of the response is different

maxMean

(Number, default null): if it is a number, generates an error when the mean value for a benchmark cycle is major than the expected value

maxSingleMean

(Number, default null): if it is a number, generates an error when the mean across all the concurrent requests value is major than the expected value

Options object

debug

(Boolean, default false): Displays some info on the console.

runMode

(String, default 'sequence'): Can be 'sequence' (each request is made after receiving the previous response) or 'parallel' (all requests are made in parallel).

maxConcurrentRequests

(Number, default 100): When in runMode='parallel' it is the maximum number of concurrent requests are made.

delay

(Number, default 0): When in runMode='sequence', it is the delay between test cycles (secs).

maxTime

(Number, default 10): The maximum time a benchmark is allowed to run before finishing (secs). Note: Cycle delays aren't counted toward the maximum time.

minSamples

(Number, default 20): The minimum sample size required to perform statistical analysis.

stopOnError

(Boolean, default true): Stops the benchmark as soon as it receives an error. When false, the benchmark goes on and the errors are collected inside the callback.

Tuning

You should tune your machine to remove any OS limits in terms of opening and quickly recycling sockets.

Linux and Mac OS X

sudo sysctl -w kern.maxfiles=25000
sudo sysctl -w kern.maxfilesperproc=24500
sudo sysctl -w kern.ipc.somaxconn=20000
ulimit -S -n 20000

Docker version

Containerized version of api-benchmark is available here: docker-api-benchmark

Contributing

This project is actively looking for contributors. If you wish to be involved, please open an issue and get in touch. Thanks!

For the latest updates and release information follow @matteofigus on twitter. Feel free to open new Issues in case of Bugs or Feature requests. Pull requests are welcome: first run all the tests locally doing npm test.

Tests

npm test

TODO

  • Command-line simple interface
  • Multi-thread requests
  • SOAP
  • Killer mode - ask for details

License

MIT