https://github.com/ctiedt/influx_client
A Rust library to interact with InfluxDB
https://github.com/ctiedt/influx_client
database influxdb influxdb-client rust
Last synced: 12 months ago
JSON representation
A Rust library to interact with InfluxDB
- Host: GitHub
- URL: https://github.com/ctiedt/influx_client
- Owner: ctiedt
- License: mit
- Created: 2021-02-21T20:53:45.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2023-01-24T21:12:14.000Z (over 3 years ago)
- Last Synced: 2025-06-09T01:57:58.723Z (about 1 year ago)
- Topics: database, influxdb, influxdb-client, rust
- Language: Rust
- Homepage: https://crates.io/crates/influx-client
- Size: 29.3 KB
- Stars: 3
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# influx_client
[](https://crates.io/crates/influx_client) [](https://docs.rs/influx_client)
A Rust library to interact with [InfluxDB](https://www.influxdata.com/) databases.
It is still early in development, so expect bugs and missing features.
## Things that work
- Writing data to a bucket
- Querying data in a certain time range (only relative so far)
- Using filters in queries
## Examples
Writing to a bucket:
```rust
use std::{collections::HashMap, time::SystemTime};
use influx_client::{
Client, InfluxError, Precision, WriteQuery,
};
fn main() -> Result<(), InfluxError> {
let client = Client::from_env("http://localhost:8086").expect("INFLUXDB_TOKEN not set");
let mut tags = HashMap::new();
tags.insert("t1", "v1");
tags.insert("t2", "v2");
let data = WriteQuery {
name: "test",
tags,
field_name: "i",
value: 42,
timestamp: Some((SystemTime::now(), Precision::ns)),
};
client.insert("home", "home", Precision::ms, data)?;
}
```
Reading from a bucket:
```rust
use influx_client::{
flux::functions::{NumericFilter, Range, StringFilter},
Client, InfluxError, Precision, ReadQuery,
};
fn main() -> Result<(), InfluxError> {
let client = Client::from_env("http://localhost:8086").expect("INFLUXDB_TOKEN not set");
let q = ReadQuery::new("home")
.range(Range::new(Some((-12, Precision::h)), None))
.filter(StringFilter::Eq("_measurement", "test"))
.filter(NumericFilter::Lt("_value", 99));
println!("{}", client.get("home", q)?);
Ok(())
}
```