Skip to main content

PrometheusEncoder

Struct PrometheusEncoder 

Source
pub struct PrometheusEncoder { /* private fields */ }
Expand description

Encoder for Prometheus text exposition snapshots.

The encoder is intentionally transport-agnostic: callers can write the returned text to a file, serve it from their own HTTP endpoint, or pass it to another delivery mechanism without enabling the pushgateway feature.

Implementations§

Source§

impl PrometheusEncoder

Source

pub const DEFAULT_PREFIX: &'static str = "iperf3"

Default metric prefix used by the CLI, PrometheusEncoder, and Pushgateway helpers.

Source

pub fn new(metric_prefix: impl Into<String>) -> Result<Self>

Build an encoder with a custom metric name prefix.

Source

pub fn with_labels<I, K, V>( metric_prefix: impl Into<String>, labels: I, ) -> Result<Self>
where I: IntoIterator<Item = (K, V)>, K: Into<String>, V: Into<String>,

Build an encoder with fixed labels on every emitted sample.

Source

pub fn metric_prefix(&self) -> &str

Return the metric prefix used by this encoder.

Source

pub fn labels(&self) -> &[(String, String)]

Return fixed labels applied to every emitted sample.

Source

pub fn encode_interval(&self, metrics: &Metrics) -> String

Encode one immediate interval sample as Prometheus text exposition.

Source

pub fn encode_window(&self, metrics: &WindowMetrics) -> String

Encode one aggregated window summary as Prometheus text exposition.

Trait Implementations§

Source§

impl Clone for PrometheusEncoder

Source§

fn clone(&self) -> PrometheusEncoder

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for PrometheusEncoder

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for PrometheusEncoder

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl PartialEq for PrometheusEncoder

Source§

fn eq(&self, other: &PrometheusEncoder) -> bool

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

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

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

impl Eq for PrometheusEncoder

Source§

impl StructuralPartialEq for PrometheusEncoder

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more