influxdb-cxx-fork

This is a fork of the now archived influxdb access library written by https://github.com/awegrzyn/influxdb-cxx.git.

A large number of IoT applications rely on simple REST APIs with minimum requirements on the http implementation. The goal of this fork is to support such applications with a small footprint and self-contained influxdb client library by removing dependencies to boost and curl from the original library.

InfluxDB C++ client library

• Batch write
• Data exploration
• Supported embedded transports
  • HTTP with Basic Auth
  • UDP
• Supported with external library dependencies
  • HTTPS with Basic Auth
  • Unix datagram socket

Installation

Build requirements

• CMake 3.12+
• C++17 compliler

In CMakeLists.txt configure external library dependencies:

option(USE_CURL "Enable curl dependency" OFF)      # switch ON if you need https
option(USE_BOOST "Enable boost dependency" OFF)    # switch ON if you need Unix datagram sockets

Generic

git clone https://github.com/ralfogit/influxdb-cxx-fork.git
cd influxdb-cxx-fork; mkdir build
cd build
cmake ..
sudo make install

macOS

brew install awegrzyn/influxdata/influxdb-cxx

Quick start

Basic write

// Provide complete URI
auto influxdb = influxdb::InfluxDBFactory::Get("http://localhost:8086/?db=test");
influxdb->write(Point{"test"}
  .addField("value", 10)
  .addTag("host", "localhost")
);

Batch write

// Provide complete URI
auto influxdb = influxdb::InfluxDBFactory::Get("http://localhost:8086/?db=test");
// Write batches of 100 points
influxdb->batchOf(100);

for (;;) {
  influxdb->write(Point{"test"}.addField("value", 10));
}

Query

// Available over HTTP only
auto influxdb = influxdb::InfluxDBFactory::Get("http://localhost:8086/?db=test");
/// Pass an IFQL to get list of points
std::vector<Point> points = idb->query("SELECT * FROM test");

Transports

An underlying session protocol is fully configurable by passing an URI:

[protocol]://[username:password@]host:port[/?db=database]

List of supported protocols:

Name	Dependency	URI protocol	Sample URI
HTTP	none	http	http://localhost:8086/?db=<db>
UDP	none	udp	udp://localhost:8094
HTTPS	libcurl,libssl,libcrypto	https	https://localhost:8086/?db=<db>
Unix datagram socket	boost	unix	unix:///tmp/telegraf.sock