Struct Carbon 

pub struct Carbon { /* private fields */ }

A structure that is used to submit values to carbon

Internally it uses a state machine to communicate to the underlying network connection(s)

Implementations

impl Carbon

pub fn new(config: &Arc<Config>) -> (Carbon, Init)

This creates an instance of the Carbon public interface and Init structure that can be used to initialize a Proto instance

pub fn add_value<N, V>(&self, name: N, value: V)

where N: Display, V: Num + Display,

Add any numeric value for carbon with current timestamp

Example

carbon.add_value("my.metric", 1);
carbon.add_value(
    format_args!("metrics.{host}.cpu", host),
    27);

Panics

• When either name or value can’t be formatted (Display’d)
• When formatted name contains a whitespace or a newline

pub fn add_value_at<N, V>(&self, name: N, value: V, ts: SystemTime)

where N: Display, V: Num + Display,

Add any numeric value for carbon with specific timestamp

Example

let timestamp = SystemTime::now();
carbon.add_value_at("my.metric", 1, timestamp);
carbon.add_value_at(
    format_args!("metrics.{host}.cpu", host),
    27, timestamp);

Panics

• When either name or value can’t be formatted (Display’d)
• When formatted name contains a whitespace or a newline
• If timestamp is smaller than UNIX_EPOCH

Trait Implementations

impl Clone for Carbon

fn clone(&self) -> Carbon

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Carbon

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.