KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #ai-agent #claude-code #mcp #typescript #codex #cli #rust #deepseek-harness

influxdb-cpp

★ 183 Open GitHub ↗

💜 C++ client for InfluxDB.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# influxdb-cpp

A header-only C++ query & write client for InfluxDB.

[![license](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat)](https://github.com/orca-zhang/influxdb-cpp/blob/master/LICENSE) [![Build Status](https://orca-zhang.semaphoreci.com/badges/influxdb-cpp/branches/master.svg?style=shields)](https://orca-zhang.semaphoreci.com/projects/influxdb-cpp)  [![Build status](https://ci.appveyor.com/api/projects/status/gusrrn0mn67q2yaj?svg=true)](https://ci.appveyor.com/project/orca-zhang/influxdb-cpp)

- Support versions:
  - InfluxDB v0.9 ~ 2.0+
  - Check yourself while using other versions.

### Why use influxdb-cpp?

- **Exactly-small**:
  - Less than 300 lines and only 10KB+.
- **Easy-to-use**:
  - It's designed to be used without extra studies.
- **Easy-to-assemble**:
  - Only a tiny header file needs to be included.
- **No-dependencies**:
  - Unless STL and std C libraries.

### Examples

#### Before using

- The very simple thing you should do before using is only:

```cpp
    #include "influxdb.hpp"
    ```

#### Writing example

- You should refer to the [write syntax](https://docs.influxdata.com/influxdb/v1.4/write_protocols/line_protocol_reference/) while writing series(metrics).

```
    measurement[,tag-key=tag-value...] field-key=field-value[,field2-key=field2-value...] [unix-nano-timestamp]
    ```

- You can rapidly start writing serires by according to the following example.

```cpp
    influxdb_cpp::server_info si("127.0.0.1", 8086, "db", "usr", "pwd");
    influxdb_cpp::builder()
        .meas("foo")
        .tag("k", "v")
        .tag("x", "y")
        .field("x", 10)
        .field("y", 10.3, 2)
        .field("z", 10.3456)
        .field("b", !!10)
        .timestamp(1512722735522840439)
        .post_http(si);
    ```

- **Remarks**: 
    - 3rd parameter `precision` of `field()` is optional for floating point value, and default precision is `2`. 
    - `usr` and `pwd` is optional for authorization.

- The series sent is:

```
    foo,k=v,x=y x=10i,y=10.30,z=10.35,b=t 1512722735522840439
    ```

- You could change `post_http` to `send_udp` for udp request. And only `host` and `port` is required for udp.

```cpp
    influxdb_cpp::builder()
        .meas("foo")
        .field("x", 10)
        .send_udp("127.0.0.1", 8091);
    ```

- Bulk/batch/multiple insert also supports:

```cpp
    influxdb_cpp::builder()
        .meas("foo")  // series 1
        .field("x", 10)

.meas("bar")  // series 2
        .field("y", 10.3)
        .send_udp("127.0.0.1", 8091);
    ```

- The series sent are:

```
    foo x=10i
    bar y=10.30
    ```

#### Query example

- And you can query series by according to the following example.

```cpp
  influxdb_cpp::server_info si("127.0.0.1", 8086, "db", "usr", "pwd");

string resp;
  influxdb_cpp::query(resp, "select * from t", si);
  ```

- You can use [xpjson](https://github.com/ez8-co/xpjson) to parse the result refer to [issue #3](https://github.com/orca-zhang/influxdb-cpp/issues/3).

### **Remarks for Windows**

- You should **init socket environment by yourself** under Windows.
  - FYR: [MSDN doc for `WSAStartup`](https://msdn.microsoft.com/en-us/library/windows/desktop/ms742213(v=vs.85).aspx)

### **Remarks for Special Characters in Password**

- You should do URL encode first.

``` c++
  string encoded_pwd;
  influxdb_cpp::url_encode(encoded_pwd, pwd);
  ```
 
### Return code cheat-sheet

### TODO

- Add more test cases.
- Supports DSN initializatin for server_info.
- Do not need to connect every time.

### Misc

- Please feel free to use influxdb-cpp.
- Looking forward to your suggestions.
- If your project is using influxdb-cpp, you can show your project or company here by creating a issue or let me know.

influxdb-cpp

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README