Struct Resource

pub struct Resource { /* private fields */ }

Describes an entity about which identifying information and metadata is exposed.

Items are sorted by their key, and are only overwritten if the value is an empty string.

Implementations

impl Resource

pub fn empty() -> Self

Creates an empty resource.

pub fn new<T: IntoIterator<Item = KeyValue>>(kvs: T) -> Self

Create a new Resource from key value pairs.

Values are de-duplicated by key, and the first key-value pair with a non-empty string value will be retained

pub fn from_detectors( timeout: Duration, detectors: Vec<Box<dyn ResourceDetector>>, ) -> Self

Create a new Resource from resource detectors.

timeout will be applied to each detector.

pub fn merge<T: Deref<Target = Self>>(&self, other: T) -> Self

Create a new Resource by combining two resources.

Keys from the other resource have priority over keys from this resource, even if the updated value is empty.

pub fn len(&self) -> usize

Returns the number of attributes for this resource

pub fn is_empty(&self) -> bool

Returns true if the resource contains no attributes.

pub fn iter(&self) -> Iter<'_>

Gets an iterator over the attributes of this resource, sorted by key.

pub fn get(&self, key: Key) -> Option<Value>

Retrieve the value from resource associate with given key.

pub fn encoded(&self, encoder: &dyn Encoder) -> String

Available on crate feature metrics only.

Encoded attributes

Trait Implementations

impl Clone for Resource

fn clone(&self) -> Resource

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Resource

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

Formats the value using the given formatter.

impl Default for Resource

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Resource

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'a> IntoIterator for &'a Resource

type Item = (&'a Key, &'a Value)

The type of the elements being iterated over.

type IntoIter = Iter<'a>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl IntoIterator for Resource

type Item = (Key, Value)

The type of the elements being iterated over.

type IntoIter = IntoIter

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl PartialEq for Resource

fn eq(&self, other: &Resource) -> 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 Serialize for Resource

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Resource