Struct WideEventGuard 

pub struct WideEventGuard(/* private fields */);

RAII guard that emits the wide event when dropped.

Implements Deref<Target = WideEvent> so you can call setters directly.

let req = WideEventGuard::new("http");
req.set_str("method", "GET");
req.set_u64("status", 200);
// emitted automatically when `req` drops

Implementations

impl WideEventGuard

pub fn new(subsystem: &'static str) -> Self

Create a new guard that emits on drop.

Methods from Deref<Target = WideEvent>

pub fn set_emit_hook(&self, hook: EmitHook)

Set a hook called with the accumulated fields just before emit.

pub fn has_key(&self, key: &str) -> bool

Returns true if the given key exists in the accumulated fields.

pub fn set_str(&self, key: &'static str, val: &str)

Set a string field (copies val; use set_string to move an owned String).

pub fn set_string(&self, key: &'static str, val: String)

Set a string field from an owned String (avoids a copy).

pub fn set_i64(&self, key: &'static str, val: i64)

Set a signed 64-bit integer field.

pub fn set_u64(&self, key: &'static str, val: u64)

Set an unsigned 64-bit integer field.

pub fn set_f64(&self, key: &'static str, val: f64)

Set a 64-bit floating-point field (NaN / Inf are stored as null).

pub fn set_bool(&self, key: &'static str, val: bool)

Set a boolean field.

pub fn set_value(&self, key: &'static str, val: Value)

Set a field from a raw serde_json::Value.

pub fn incr(&self, key: &'static str)

Increment an integer counter field by 1 (initialized to 1 if absent).

pub fn set_error(&self, err_type: &str, message: &str)

Set error = true, error.type, and error.message.

pub fn emit(&self)

Emit the wide event through the tracing pipeline.

The tracing target is {target_prefix}::{subsystem} where target_prefix defaults to wide_event. Configure the prefix on WideEventLayer::with_target_prefix.

Calling emit() more than once is a no-op.

Trait Implementations

impl Deref for WideEventGuard

type Target = WideEvent

The resulting type after dereferencing.

fn deref(&self) -> &WideEvent

Dereferences the value.

impl Drop for WideEventGuard

fn drop(&mut self)

Executes the destructor for this type.