Struct Resource

pub struct Resource { /* private fields */ }

An immutable representation of the entity producing telemetry as attributes. Utilizes Arc for efficient sharing and cloning.

Implementations

impl Resource

pub fn empty() -> Resource

Creates an empty resource. This is the basic constructor that initializes a resource with no attributes and no schema URL.

pub fn new<T>(kvs: T) -> Resource

where T: IntoIterator<Item = KeyValue>,

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 new_with_defaults<T>(keys: T) -> Resource

where T: IntoIterator<Item = KeyValue>,

Create a new Resource::default() and merge with provided 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_schema_url<KV, S>(kvs: KV, schema_url: S) -> Resource

where KV: IntoIterator<Item = KeyValue>, S: Into<Cow<'static, str>>,

Create a new Resource from a key value pairs and schema url.

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

schema_url must be a valid URL using HTTP or HTTPS protocol.

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

Create a new Resource from resource detectors.

timeout will be applied to each detector.

pub fn merge<T>(&self, other: T) -> Resource

where T: Deref<Target = Resource>,

Create a new Resource by combining two resources.

Key value pairs

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

Schema url

If both of the resource are not empty. Schema url is determined by the following rules, in order:

1. If this resource has a schema url, it will be used.
2. If this resource does not have a schema url, and the other resource has a schema url, it will be used.
3. If both resources have a schema url and it’s the same, it will be used.
4. If both resources have a schema url and it’s different, the schema url will be empty.
5. If both resources do not have a schema url, the schema url will be empty.

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

Return the schema url of the resource. If the resource does not have a schema url, return None.

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.

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

Retrieve the value from resource associate with given key.

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<(), Error>

Formats the value using the given formatter.

impl Default for Resource

fn default() -> Resource

Returns the “default value” for a type.

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) -> <&'a Resource as IntoIterator>::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 StructuralPartialEq for Resource