Struct cadence::StatsdClientBuilder
source · [−]pub struct StatsdClientBuilder { /* private fields */ }
Expand description
Builder for creating and customizing StatsdClient
instances.
Instances of the builder should be created by calling the ::builder()
method on the StatsClient
struct.
Example
use cadence::prelude::*;
use cadence::{MetricError, StatsdClient, NopMetricSink};
fn my_error_handler(err: MetricError) {
println!("Metric error! {}", err);
}
let client = StatsdClient::builder("prefix", NopMetricSink)
.with_error_handler(my_error_handler)
.build();
client.count("something", 123);
client.count_with_tags("some.counter", 42)
.with_tag("region", "us-east-2")
.send();
Implementations
sourceimpl StatsdClientBuilder
impl StatsdClientBuilder
sourcepub fn with_error_handler<F>(self, errors: F) -> Self where
F: Fn(MetricError) + Sync + Send + RefUnwindSafe + 'static,
pub fn with_error_handler<F>(self, errors: F) -> Self where
F: Fn(MetricError) + Sync + Send + RefUnwindSafe + 'static,
Set an error handler to use for metrics sent via MetricBuilder::send()
The error handler is only invoked when metrics are not able to be sent
correctly. Either due to invalid input, I/O errors encountered when trying
to send them via a MetricSink
, or some other reason.
The error handler should consume the error without panicking. The error may be logged, printed to stderr, discarded, etc. - this is up to the implementation.
sourcepub fn build(self) -> StatsdClient
pub fn build(self) -> StatsdClient
Construct a new StatsdClient
instance based on current settings.
Auto Trait Implementations
impl RefUnwindSafe for StatsdClientBuilder
impl Send for StatsdClientBuilder
impl Sync for StatsdClientBuilder
impl Unpin for StatsdClientBuilder
impl !UnwindSafe for StatsdClientBuilder
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more