Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

influxdb-cpp-rest

Build status Build Status FOSSA Status

A naive C++(14) InfluxDB client via C++ REST SDK + a C wrapper of the asynchronous API as a shared library.

See the demo source for the current api example.

The unbatched aprroach (and without connection reuse) may not be sufficient in some situations, as without batching, about 200 lines/sec can be inserted.

A batching api leans towards thousands inserts per second. Behind the scenes, the API uses RxCpp and cppformat.

Status

  • Build and test ok on Win10/Ubuntu64/OSX.
  • Feel free to contribute, as the progress is rather sporadic due to lack of spare time.
  • tested with InfluxDB v1.2.4, v1.7.5, v1.7.6

Synchronous insertion

influxdb::api::simple_db simpledb("http://localhost:8086", "my_db");
db.insert(
	line("log", key_value_pairs("my_tag", 42L), key_value_pairs("value", "hello world!")));

Asynchronous insertion

The asynchronous API inserts the points on an active object with automatic batching, thus increasing throughput.

influxdb::async_api::simple_db asyncdb("http://localhost:8086", "my_db");

for (int i = 0; i < 123456; i++) {
  asyncdb.insert(
    line(
      "my_measurements",
      key_value_pairs("my_count", i % MAX_VALUES_PER_TAG),
      key_value_pairs("value", "hi!")
    ));
}

C API

see async_c_test.cpp and the related headers.

Timestamps

Timestamps can be added as the last parameter to the line constructor, and only need to return a serializable value on TTimestamp::now(). There is a default std::chrono-based implementation:

    line(
      "my_measurements",
      key_value_pairs("my_count", i % MAX_VALUES_PER_TAG),
      key_value_pairs("value", "hi!"),
      default_timestamp()
//    ^^^^^^^^^^^^^^^^^^^
    )

MAX_VALUES_PER_TAG for demo purposes here, as there is such a maximum and it has to be observed by the clients.

Multiple lines in synchronous API

Add lines using the () operator on the line:

  line
    ("multiple", key_value_pairs("v1", 1), key_value_pairs())
    ("multiple", key_value_pairs("v2", 2), key_value_pairs())

Query

influxdb::raw::db_utf8 raw_db("http://localhost:8086", "my_db");
auto query = std::string("select count(*) from my_db..my_measurements");
auto json_response = raw_db.get(query);

{"results":[{"series":[{"name":"asynctest","columns":["time","count_value"],"values":[["...Z",123456]]}]}]}

Authentication

Basic authentication can be used with all API variants

influxdb::raw::db_utf8 raw_db("http://localhost:8086", "my_db");
raw_db.with_authentication(username, password);
auto query = ...

Error Handling

  • Synchronous C++ API will throw exceptions on HTTP errors
  • Asynchronous APIs will drop inserts on HTTP errors and print to stderr
  • C api tries to catch CPP exceptions and
    • print exceptions to stderr
    • return non-zero int or nullptr where sensible
  • Open issue: #18

Build & Test

The library should be easy to build, given RxCpp and cpprestsdk can be found. The Visual Studio 2015 solution is self-contained. A locally running, authentication-free instance of InfluxDB is required to run the test.

Dependencies on Linux and OS X

cpprestsdk needs to be built and available, which in turn has platform-specific transient dependencies.

The easiest way to install it on MacOS X and Linux turned out to be via Homebrew and Linuxbrew respectively.

Once the install brew install cpprestsdk succeeds, build: make -C build/<platform>/gmake config=release_x64 and run the test.

If the build fails due to failed dependencies, check premake5.lua for the build config, and regenerate makefiles if necessary via premake/premake5<os-specific> gmake

Thanks to

  • @kirkshoop for indispensable help with RxCpp
  • @nikkov for pointing out the missing essential features
  • @promgamer, @garaemon for the identifiers PRs

License

FOSSA Status

About

Simple C++ InfluxDB client via MS C++ REST SDK + RxCpp for batching (Windows/OSX/Linux) + a C wrapper

Topics

Resources

License

Releases

No releases published

Packages

No packages published
You can’t perform that action at this time.