rrd-sys
| Crates.io | rrd-sys |
| lib.rs | rrd-sys |
| version | 0.1.1 |
| created_at | 2024-12-22 14:16:25.937895+00 |
| updated_at | 2025-01-24 06:58:35.910433+00 |
| description | Bindings to librrd to create and interact with round robin databases created with Tobias Oetiker's rrdtool (https://www.rrdtool.org/). |
| homepage | https://github.com/cygnus9/rrd-rust |
| repository | https://github.com/cygnus9/rrd-rust |
| max_upload_size | |
| id | 1491960 |
| size | 33,517 |
Marshall Pierce (marshallpierce)
documentation
README
rrd
Bindings to librrd to create and interact with round robin databases created with Tobias
Oetiker's rrdtool.
RRDtool is the OpenSource industry standard, high performance data logging and graphing system for time series data. RRDtool can be easily integrated in shell scripts, perl, python, ruby, lua or tcl applications.
And now also from Rust.
Supported operations
This library provides high level APIs for the core RRD operations:
- Create - make a new round robin database (RRD)
- Update - add data to an RRD
- Fetch - get data from an RRD
- Graph - generate graphs from an RRD
- Info - get RRD metadata
There are other operations available in the upstream rrdtool (e.g.
exporting to XML, tuning parameters, etc), but as they are generally more administrative in nature, this library doesn't
expose them (yet?).
Getting Started
Make sure rrdtool (or at least librrd8) is installed on your system.
Any reasonable package manager should have librrd packages available, or check here for instructions on building from source.
Then add rrd as a dependency to your project.
[dependencies]
rrd = "0.1.0"
Windows
To link to librrd-8.dll you'll need a .lib file, which is not
shipped with the pre-build binaries shipped here.
Follow these steps to create the .lib file:
- Download
librrd-8.def - From a VS dev shell:
lib /def:librrd-8.def /out:librrd-8.lib /machine:x64 - Set the
LIBRRDenvironment variable to the full path oflibrrd-8.lib
License
This project is licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or https://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in rrd by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.
Checking with multiple OSs
Run ./scripts/check-with-different-versions.sh to run tests in several different linux systems with varying librrd versions.