Struct CaptureExceptionOptions 

pub struct CaptureExceptionOptions { /* private fields */ }

Optional context for capture_exception_with: person identity, custom properties, groups, trace context, and exception fingerprint/level.

All fields are optional. An empty options set (new() / Default) captures the exception personlessly with no extra context. With the trace-context provider configured on ErrorTrackingOptions, its trace and span IDs are attached automatically; values set here take precedence.

Examples

use posthog_rs::CaptureExceptionOptions;

let options = CaptureExceptionOptions::new()
    .distinct_id("user-123")
    .property("route", "/checkout")?
    .group("company", "acme")
    .trace_context(
        "00000000000000000000000000000123",
        "0000000000000456",
    )
    .fingerprint("checkout-error")
    .level("warning");

Implementations

impl CaptureExceptionOptions

pub fn new() -> Self

Create an empty options set: personless, no extra context.

pub fn distinct_id<S: Into<String>>(self, distinct_id: S) -> Self

Associate the exception with a person.

pub fn property<K: Into<String>, V: Serialize>( self, key: K, value: V, ) -> Result<Self, Error>

Add a custom property to the exception event.

pub fn group<N: Into<String>, I: Into<String>>( self, group_name: N, group_id: I, ) -> Self

Capture the exception as a group event.

pub fn trace_context<T: Into<String>, S: Into<String>>( self, trace_id: T, span_id: S, ) -> Self

Associate the exception with a span in a distributed trace.

The IDs are accepted together so an exception can never combine a trace ID and span ID from different contexts. This pair overrides any context returned by the client’s trace-context provider.

pub fn fingerprint<S: Into<String>>(self, fingerprint: S) -> Self

Set a custom exception fingerprint.

pub fn level<S: Into<String>>(self, level: S) -> Self

Set the exception severity level. Defaults to "error".

Trait Implementations

impl Clone for CaptureExceptionOptions

fn clone(&self) -> CaptureExceptionOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CaptureExceptionOptions

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

Formats the value using the given formatter.

impl Default for CaptureExceptionOptions

fn default() -> CaptureExceptionOptions

Returns the “default value” for a type.