Struct ValueListBuilder

pub struct ValueListBuilder<'a> { /* private fields */ }

Creates a value list to report values to collectd.

Implementations

impl<'a> ValueListBuilder<'a>

pub fn new<T: Into<&'a str>, U: Into<&'a str>>( plugin: T, type_: U, ) -> ValueListBuilder<'a>

Primes a value list for submission. plugin will most likely be the name from the PluginManager and type_ is the datatype found in types.db

pub fn values(self, values: &'a [Value]) -> ValueListBuilder<'a>

A set of observed values that belong to the same plugin and type instance

pub fn plugin_instance<T: Into<&'a str>>( self, plugin_instance: T, ) -> ValueListBuilder<'a>

Distinguishes entities that yield metrics. Each core would be a different instance of the same plugin, as each core reports “idle”, “user”, “system” metrics.

pub fn type_instance<T: Into<&'a str>>( self, type_instance: T, ) -> ValueListBuilder<'a>

The type instance is used to separate values of identical type which nonetheless belong to one another. For instance, even though “free”, “used”, and “total” all have types of “Memory” they are different type instances.

pub fn host<T: Into<&'a str>>(self, host: T) -> ValueListBuilder<'a>

Override the machine’s hostname that the observed values will be attributed to. Best to override when observing values from another machine

pub fn time(self, dt: DateTime<Utc>) -> ValueListBuilder<'a>

The timestamp at which the value was collected. Overrides the default time, which is when collectd receives the values from submit. Use only if there is a significant delay is metrics gathering or if submitting values from the past.

pub fn interval(self, interval: Duration) -> ValueListBuilder<'a>

The interval in which new values are to be expected. This is typically handled at a global or plugin level. Use at your own discretion.

pub fn metadata(self, key: &'a str, value: MetaValue) -> ValueListBuilder<'a>

Add a metadata entry.

Multiple entries can be added by calling this method. If the same key is used, only the last entry is kept.

pub fn submit(self) -> Result<(), SubmitError>

Submits the observed values to collectd and returns errors if encountered

Trait Implementations

impl<'a> Clone for ValueListBuilder<'a>

fn clone(&self) -> ValueListBuilder<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for ValueListBuilder<'a>

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

Formats the value using the given formatter.

impl<'a> PartialEq for ValueListBuilder<'a>

fn eq(&self, other: &ValueListBuilder<'a>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> StructuralPartialEq for ValueListBuilder<'a>