influx

node-influx

An InfluxDB Node.js Client

Installation

$ npm install influx@next

Features

• Simple API for nearly all Influx operations
• Fully supported in Node and the browser
• Performant, processing millions of rows/sec on modest hardware
• Zero dependencies

Compatibility

Version 5.x.x is compatible with InfluxDB 1.x on Node 6 and modern browsers

Version 4.x.x is compatible with InfluxDB 0.9.x - 0.13.x on Node 0.12 and onwards

Version 3.x.x is compatible with InfluxDB 0.8.x - 3.x will no longer have updates by core contributers, please consider upgrading.

Usage

• API Documentation
• Tutorials & Examples
• Changelog

Changelog

2016-10-15, 5.0.0-alpha.1

5.0.0 is a port/rewrite of node-influx to TypeScript, aiming to provide a stronger foundation while fixing many of the pain points and bugs which currently exist. These include issues with escaping data passed to node-influx, date handling difficulties, quirks in the connection, and the lack of complete unit tests. We also take the opportunity to build a more modern, promise-based API. Concretely, here's what we've got for you:

• A modern promise based API;
• Order-of-magnitude performance increases (varying per situation);
• A more consistent API with predictable and consistent escaping;
• The ability to correctly and accurately deal with times;
• The ability to correctly and accurately deal with all data types;
• Fix some methods plain not working;
• Isomorphism, allowing the adapter to work in both Node and the browser;
• Less weird connection pool failures;
• Much better and more complete documentation;

Please see the documentation linked in the readme for more information. The following is a list of breaking changes:

• breaking: all methods have been modified to return promises
• breaking: result output for grouped results has changed
• breaking: data passed into Influx, except where otherwise noted, will be escaped automatically
• breaking: the point structure for .write* methods has changed
• breaking: the .writePoint method has been removed
• breaking: .writeSeries as been more appropriately renamed writeMeasurement
• breaking: write methods now write in nanosecond precision by default
• breaking: .getSeriesNames has been renamed .getSeries
• breaking: the old .getSeries method has been removed in favor of the behaviour exhibited by getSeriesNames
• breaking: the InfluxDB client must now be invoked as new InfluxDB
• breaking: the connection pool configuration has changed