Struct ErrorFrame 

pub struct ErrorFrame {
    pub message: ErrorSensitivityLabel<String>,
    pub error: Box<dyn Error + Send + Sync + 'static>,
    pub source: SourceLocation,
    pub date_time: DateTime<Utc>,
    pub suggestions: Vec<ErrorSensitivityLabel<String>>,
    pub context: ErrorSensitivityLabel<String>,
    pub attachments: HashMap<String, Box<ErrorSensitivityLabel<ErrorAttachment>>>,
    pub backtrace: Backtrace,
    pub span: Span,
    pub span_trace: SpanTrace,
}

A single frame in an error chain, capturing one error with its full context.

Each ErrorFrame records:

• The error message and original error object
• Source location (file, line, column) via #[track_caller]
• Timestamp of when the frame was created
• Backtrace at the point of creation
• Current tracing span and span trace
• Arbitrary key-value attachments with sensitivity labels

Frames are collected inside an ErrorReport.

Fields

message: ErrorSensitivityLabel<String>

Error message text, wrapped in a sensitivity label.

error: Box<dyn Error + Send + Sync + 'static>

The original error object.

source: SourceLocation

Source code location where this frame was created.

date_time: DateTime<Utc>

Timestamp of when this error frame was created (UTC).

suggestions: Vec<ErrorSensitivityLabel<String>>

Suggestions that could help resolve the error.

context: ErrorSensitivityLabel<String>

Context/circumstances the error occurred in.

attachments: HashMap<String, Box<ErrorSensitivityLabel<ErrorAttachment>>>

Key-value attachments with sensitivity labels for additional diagnostic data.

backtrace: Backtrace

Captured backtrace at the point this frame was created. Should always be considered Internal sensitivity.

span: Span

The current tracing Span when this frame was created. Should always be considered Internal sensitivity. This can be used instead of Backtrace for creating a stack.

span_trace: SpanTrace

The span trace captured from tracing-error.

Implementations

impl ErrorFrame

pub fn new<E: Error + Send + Sync + 'static>(error: E) -> Self

Create a new error frame from any error type.

Captures source location, backtrace, timestamp, and current tracing span.

pub fn from_dyn_error(error: Box<dyn Error + Send + Sync + 'static>) -> Self

Create a new error frame from a boxed dynamic error.

pub fn from_message<S: Into<String>>(msg: S) -> Self

Create an error frame from a plain message string.

The message is labeled as Internal.

pub fn get_error_title(&self) -> String

Get the error message as a string.

pub fn get_span_list(&self) -> Vec<&'static Metadata<'static>>

Get the list of tracing span metadata from the span trace.

pub fn create_backtrace_string(&self) -> String

Resolve and format the backtrace as a human-readable string.

Cleans up paths by removing the current directory prefix, cargo registry paths, and rustlib paths to keep output concise.

Trait Implementations

impl Debug for ErrorFrame

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

Formats the value using the given formatter.

impl ErrorFmt for ErrorFrame

fn create_format_obj( &self, settings: ErrorFmtSettings, ) -> ResultER<ErrorFormatObj>

Convert this value into a structured format object.

fn stringify(&self, settings: ErrorFmtSettings) -> ResultER<String>

Convert to string by first creating a format object, then stringifying it.

fn stringify_obj( format_obj: ErrorFormatObj, settings: ErrorFmtSettings, ) -> ResultER<String>

Stringify an existing format object directly.