RawOrigin

Struct RawOrigin 

Source
pub struct RawOrigin<'a> { /* private fields */ }
Expand description

A raw representation of an origin.

Metrics contain metadata about their origin, in terms of the metric’s reason for existing: the metric was ingested via DogStatsD, or was generated by an integration, and so on. However, there is also the concept of a metric originating from a particular entity, such as a specific Kubernetes container. This relates directly to the specific sender of the metric, which is used to enrich the metric with additional tags describing the origin entity.

The origin entity will generally be the process ID of the metric sender, or the container ID, both of which are then generally mapped to the relevant information for the metric, such as the orchestrator-level tags for the container/pod/deployment.

Implementations§

Source§

impl<'a> RawOrigin<'a>

Source

pub fn is_empty(&self) -> bool

Returns true if the origin information is empty.

Source

pub fn clear_process_id(&mut self)

Unsets the process ID of the sender.

Source

pub fn set_process_id(&mut self, process_id: u32)

Sets the process ID of the sender.

Must be a non-zero value. If the value is zero, it is silently ignored.

Source

pub fn process_id(&self) -> Option<u32>

Returns the process ID of the sender.

Source

pub fn set_container_id(&mut self, container_id: impl Into<Option<&'a str>>)

Sets the container ID of the sender.

Source

pub fn container_id(&self) -> Option<&str>

Returns the container ID of the sender.

Source

pub fn set_pod_uid(&mut self, pod_uid: impl Into<Option<&'a str>>)

Sets the pod UID of the sender.

Source

pub fn pod_uid(&self) -> Option<&str>

Returns the pod UID of the sender.

Source

pub fn set_cardinality( &mut self, cardinality: impl Into<Option<OriginTagCardinality>>, )

Sets the desired cardinality of any tags associated with the entity.

Source

pub fn cardinality(&self) -> Option<OriginTagCardinality>

Returns the desired cardinality of any tags associated with the entity.

Source

pub fn set_external_data(&mut self, external_data: impl Into<Option<&'a str>>)

Sets the external data of the sender.

Source

pub fn external_data(&self) -> Option<&RawExternalData<'a>>

Returns the external data of the sender.

Trait Implementations§

Source§

impl<'a> Clone for RawOrigin<'a>

Source§

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

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<'a> Debug for RawOrigin<'a>

Source§

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

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

impl<'a> Default for RawOrigin<'a>

Source§

fn default() -> RawOrigin<'a>

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

impl Display for RawOrigin<'_>

Source§

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

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

impl<'a> Hash for RawOrigin<'a>

Source§

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher. Read more
1.3.0 · Source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
Source§

impl<'a> PartialEq for RawOrigin<'a>

Source§

fn eq(&self, other: &RawOrigin<'a>) -> 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<'a> Eq for RawOrigin<'a>

Source§

impl<'a> StructuralPartialEq for RawOrigin<'a>

Auto Trait Implementations§

§

impl<'a> Freeze for RawOrigin<'a>

§

impl<'a> RefUnwindSafe for RawOrigin<'a>

§

impl<'a> Send for RawOrigin<'a>

§

impl<'a> Sync for RawOrigin<'a>

§

impl<'a> Unpin for RawOrigin<'a>

§

impl<'a> UnwindSafe for RawOrigin<'a>

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<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

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

Source§

fn from_ref(input: &T) -> T

Converts to this type from a reference to the input type.
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> Same for T

Source§

type Output = T

Should always be Self
§

impl<T> Stringable for T
where T: Display,

§

fn to_shared_string(&self) -> Cow<'static, str>

Converts the given value to a SharedString.
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> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
§

impl<T> Track for T

§

fn track_allocations(self, token: AllocationGroupToken) -> Tracked<Self>

Instruments this type by attaching the given allocation group token, returning a Tracked wrapper. Read more
§

fn in_current_allocation_group(self) -> Tracked<Self>

Instruments this type by attaching the current allocation group, returning a Tracked wrapper. 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