Crate influxive

High-level Rust integration of opentelemetry metrics and InfluxDB.

Examples

Easy, zero-configuration InfluxDB as a child process

let tmp = tempfile::tempdir().unwrap();

// create our meter provider
let (_influxive, meter_provider) = influxive::influxive_child_process_meter_provider(
    influxive::InfluxiveChildSvcConfig::default()
        .with_database_path(Some(tmp.path().to_owned())),
    influxive::InfluxiveMeterProviderConfig::default(),
).await.unwrap();

// register our meter provider
opentelemetry_api::global::set_meter_provider(meter_provider);

// create a metric
let m = opentelemetry_api::global::meter("my.meter")
    .f64_histogram("my.metric")
    .init();

// make a recording
m.record(3.14, &[]);

Connecting to an already running InfluxDB system process

// create our meter provider
let meter_provider = influxive::influxive_external_meter_provider_token_auth(
    influxive::InfluxiveWriterConfig::default(),
    influxive::InfluxiveMeterProviderConfig::default(),
    "http://127.0.0.1:8086",
    "my.bucket",
    "my.token",
);

// register our meter provider
opentelemetry_api::global::set_meter_provider(meter_provider);

// create a metric
let m = opentelemetry_api::global::meter("my.meter")
    .f64_histogram("my.metric")
    .init();

// make a recording
m.record(3.14, &[]);

Structs

InfluxiveChildSvcConfig

Configure the child process.

InfluxiveMeterProviderConfig

Influxive InfluxDB Meter Provider Configuration.

InfluxiveWriterConfig

InfluxDB metric writer configuration.

Functions

influxive_child_process_meter_provider

Create an opentelemetry_api MeterProvider ready to provide metrics to a running child process instance of InfluxDB.

influxive_external_meter_provider_token_auth

Create an opentelemetry_api MeterProvider ready to provide metrics to an InfluxDB instance that is already running as a separate process.