fvdm/nodejs-vnstat-dumpdb

Node.js wrapper for vnStat --dumpdb, with error handling and the same output structure on each system

vnstat-dumpdb

Get network traffic statistics from vnStat.

Example

var vnstat = require ('vnstat-dumpdb') ();

// Get traffic per day
vnstat.getStats ('eth0', function (err, data) {
  if (err) {
    console.log (err);
    return;
  }

  console.log (data.traffic.days);
});

// Read config setting
vnstat.getConfig (function (err, config) {
  if (err) {
    console.log (err);
    return;
  }

  console.log ('Interfaces updating every ' + config.UpdateInterval + ' minutes');
});

Installation

Make sure you have vnStat v1.13 or later.

npm install vnstat-dumpdb

Configuration

The module loads as a function to override the defaults:

setting	type	required	default	description
bin	string	no	vnstat	Path to vnstat binary
iface	string	no		i.e. eth0 or false to list all

Callback & errors

Each method below takes a callback function which gets two arguments:

• err - Instance of Error or null
• data - Result object or not set when error

function myCallback (err, data) {
  if (err) {
    console.log (err);
    console.log (err.stack);
    return;
  }

  console.log (data);
}

Errors

message	description	additional
no config	Can't load config for getConfig	err.details, err.error
invalid data	Can't read stats for getStats	err.details
invalid interface	iface is invalid or not set up

getStats ( [iface], callback )

Get statistics for one, multiple or all interfaces.

• One: vnstat.getStats ('eth0', callback)
• All: vnstat.getStats (false, callback)

// Get traffic for interface en1
vnstat.getStats ('en1', console.log);

// Output
{ id: 'en1',
  nick: 'en1',
  created: { date: { year: 2012, month: 11, day: 21 } },
  updated:
   { date: { year: 2013, month: 10, day: 28 },
     time: { hour: 3, minute: 25 } },
  traffic:
   { total: { rx: 593576855, tx: 63746811 },
     days:
      [ { id: 0,
          date: { year: 2013, month: 10, day: 28 },
          rx: 4083261,
          tx: 119674 },
        { id: 1,
          date: { year: 2013, month: 10, day: 27 },
          rx: 2206367,
          tx: 52314 },
        ...
      ],
     months:
      [ { id: 0,
          date: { year: 2013, month: 10 },
          rx: 158176326,
          tx: 7740561 },
        { id: 1,
          date: { year: 2013, month: 9 },
          rx: 119230002,
          tx: 3394278 },
        ...
      ],
     tops:
      [ { id: 0,
          date: { year: 2013, month: 10, day: 5 },
          time: { hour: 0, minute: 10 },
          rx: 22445455,
          tx: 601967 },
        { id: 1,
          date: { year: 2013, month: 9, day: 23 },
          time: { hour: 0, minute: 0 },
          rx: 20201102,
          tx: 461492 },
        ...
      ],
      hours: []
  }
}

getConfig ( callback )

Get vnStat configuration.

vnstat.getConfig (function (err, config) {
  if (err) {
    console.log (err);
    return;
  }

  console.log ('Interfaces updating every ' + config.UpdateInterval + ' seconds');
});

Unlicense

This is free and unencumbered software released into the public domain.

Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.

In jurisdictions that recognize copyright laws, the author or authors of this software dedicate any and all copyright interest in the software to the public domain. We make this dedication for the benefit of the public at large and to the detriment of our heirs and successors. We intend this dedication to be an overt act of relinquishment in perpetuity of all present and future rights to this software under copyright law.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

For more information, please refer to http://unlicense.org

Author

Franklin van de Meent

nodejs-vnstat-dumpdb's Issues

[Bug]Preinstall fails when vnstat version has higher major but lower Minor (like 2.6)

in preinstall script, your check if version is higher or equal to 1.13 fails for version 2.6 for example.

if( major === 1 && minor >= 13 || major > 1) return;

should work better.
I had to dowgrade my vnstat version so that it works.

Version 10 of node.js has been released

Version 10 of Node.js (code name Dubnium) has been released! 🎊

To see what happens to your code in Node.js 10, Greenkeeper has created a branch with the following changes:

• Added the new Node.js version to your .travis.yml
• The new Node.js version is in-range for the engines in 1 of your package.json files, so that was left alone

If you’re interested in upgrading this repo to Node.js 10, you can open a PR with these changes. Please note that this issue is just intended as a friendly reminder and the PR as a possible starting point for getting your code running on Node.js 10.

More information on this issue

Greenkeeper has checked the engines key in any package.json file, the .nvmrc file, and the .travis.yml file, if present.

• engines was only updated if it defined a single version, not a range.
• .nvmrc was updated to Node.js 10
• .travis.yml was only changed if there was a root-level node_js that didn’t already include Node.js 10, such as node or lts/*. In this case, the new version was appended to the list. We didn’t touch job or matrix configurations because these tend to be quite specific and complex, and it’s difficult to infer what the intentions were.

For many simpler .travis.yml configurations, this PR should suffice as-is, but depending on what you’re doing it may require additional work or may not be applicable at all. We’re also aware that you may have good reasons to not update to Node.js 10, which is why this was sent as an issue and not a pull request. Feel free to delete it without comment, I’m a humble robot and won’t feel rejected 🤖

---

FAQ and help

There is a collection of frequently asked questions. If those don’t help, you can always ask the humans behind Greenkeeper.

---

Your Greenkeeper Bot 🌴

An in-range update of dotest is breaking the build 🚨

The devDependency dotest was updated from 2.5.0 to 2.6.0.

🚨 View failing branch.

This version is covered by your current version range and after updating it in your project the build failed.

dotest is a devDependency of this project. It might not break your production code or affect downstream projects, but probably breaks your build or test tools, which may prevent deploying or publishing.

Status Details

• ❌ continuous-integration/travis-ci/push: The Travis CI build failed (Details).

---

Commits

The new version differs by 12 commits.

• e8d3095 2.6.0
• 85f85d9 Docs(changelog): Update changelog
• 330083e Refactor: Replaced istanbul with nyc
• 0bcf073 Chore(package): Update dependencies
• f138e11 Chore(package): Update minimum node version
• d48e381 Docs: Minor clean up
• 2892933 Test: Improve coverage for error() and fail()
• 786d1ca Feat: Add log() dontCount argument
• 0fb58f7 Test(config): Update Travis node versions
• 57bfb71 Test(config): Update ESLint ES version to 2017
• 9a4401d chore(package): update eslint to version 5.15.2 (#30)
• 667f55d Fix(runner): Incorrect Codacy env check

See the full diff

FAQ and help

There is a collection of frequently asked questions. If those don’t help, you can always ask the humans behind Greenkeeper.

---

Your Greenkeeper Bot 🌴