Struct ErrorTrackingOptionsBuilder 

pub struct ErrorTrackingOptionsBuilder { /* private fields */ }

Builder for ErrorTrackingOptions.

Implementations

impl ErrorTrackingOptionsBuilder

pub fn capture_stacktrace(&mut self, value: bool) -> &mut Self

Capture a stack trace at the capture_exception call site and attach it to the first entry of $exception_list (default: true).

The trace shows where the error was captured, not where it was created — a bubbled-up Err value carries no stack of its own. The error type/message chain in $exception_list is always sent regardless of this setting. Disabling it skips the stack walk and per-frame symbol resolution entirely, which can matter when capturing handled errors in high-volume paths.

pub fn in_app_include_paths(&mut self, value: Vec<String>) -> &mut Self

Treat only frames matching one of these patterns as in-app. Patterns are substring matches against a frame’s file path and function symbol, so both path fragments ("/service/") and crate prefixes ("my_service::") work. When empty, built-in defaults apply: frames from the cargo registry, the standard library, and vendored/target paths are library frames, everything else is in-app.

pub fn in_app_exclude_paths(&mut self, value: Vec<String>) -> &mut Self

Always mark matching frames as not in-app, taking precedence over includes and defaults. Same matching rules as in_app_include_paths — e.g. "other_crate::" excludes every frame of that crate.

pub fn capture_panics(&mut self, value: bool) -> &mut Self

When true, crate::init_global installs a process-wide panic hook that captures panics as $exception events through the global client. Defaults to false — panic autocapture is opt-in.

Only the global client installs a hook: a panic hook is process-global (std::panic::set_hook), so it pairs with the process-global client, and there is intentionally no per-Client panic API for now.

pub fn build( &self, ) -> Result<ErrorTrackingOptions, ErrorTrackingOptionsBuilderError>

Builds a new ErrorTrackingOptions.

Errors

If a required field has not been initialized.

impl ErrorTrackingOptionsBuilder

pub fn trace_context_provider<F>(&mut self, provider: F) -> &mut Self

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

Set a callback that returns the distributed trace context active at an exception’s capture site.

The callback runs synchronously during capture_exception. It must be fast, non-blocking, and must not call back into the PostHog SDK. Panics are caught and cause trace context to be omitted from that exception.

Trait Implementations

impl Clone for ErrorTrackingOptionsBuilder

fn clone(&self) -> ErrorTrackingOptionsBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for ErrorTrackingOptionsBuilder

fn default() -> Self

Returns the “default value” for a type.