Struct Scope

pub struct Scope { /* private fields */ }

Holds contextual data for the current scope.

The scope is an object that can be cloned efficiently and stores data that is locally relevant to an event. For instance the scope will hold recorded breadcrumbs and similar information.

The scope can be interacted with in two ways:

1. the scope is routinely updated with information by functions such as add_breadcrumb which will modify the currently top-most scope.
2. the topmost scope can also be configured through the configure_scope method.

Note that the scope can only be modified but not inspected. Only the client can use the scope to extract information currently.

Implementations

impl Scope

pub fn clear(&mut self)

Clear the scope.

By default a scope will inherit all values from the higher scope. In some situations this might not be what a user wants. Calling this method will wipe all data contained within.

pub fn clear_breadcrumbs(&mut self)

Deletes current breadcrumbs from the scope.

pub fn set_level(&mut self, level: Option<Level>)

Sets a level override.

pub fn set_fingerprint(&mut self, fingerprint: Option<&[&str]>)

Sets the fingerprint.

pub fn set_transaction(&mut self, transaction: Option<&str>)

Sets the transaction.

pub fn set_user(&mut self, user: Option<User>)

Sets the user for the current scope.

pub fn set_tag<V: ToString>(&mut self, key: &str, value: V)

Sets a tag to a specific value.

pub fn remove_tag(&mut self, key: &str)

Removes a tag.

If the tag is not set, does nothing.

pub fn set_context<C: Into<Context>>(&mut self, key: &str, value: C)

Sets a context for a key.

pub fn remove_context(&mut self, key: &str)

Removes a context for a key.

pub fn set_extra(&mut self, key: &str, value: Value)

Sets a extra to a specific value.

pub fn remove_extra(&mut self, key: &str)

Removes a extra.

pub fn add_event_processor<F>(&mut self, f: F)

where F: Fn(Event<'static>) -> Option<Event<'static>> + Send + Sync + 'static,

Add an event processor to the scope.

pub fn add_attachment(&mut self, attachment: Attachment)

Adds an attachment to the scope

pub fn clear_attachments(&mut self)

Clears attachments from the scope

pub fn apply_to_event(&self, event: Event<'static>) -> Option<Event<'static>>

Applies the contained scoped data to fill an event.

pub fn apply_to_transaction(&self, transaction: &mut Transaction<'static>)

Applies the contained scoped data to fill a transaction.

pub fn set_span(&mut self, span: Option<TransactionOrSpan>)

Set the given TransactionOrSpan as the active span for this scope.

pub fn get_span(&self) -> Option<TransactionOrSpan>

Returns the currently active span.

Trait Implementations

impl Clone for Scope

fn clone(&self) -> Scope

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Scope

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

Formats the value using the given formatter.

impl Default for Scope

fn default() -> Scope

Returns the “default value” for a type.