Struct SpanCollector 

pub struct SpanCollector {
    pub capture_span_for_reports_with_children: bool,
}

Attachment collector for capturing tracing spans.

When registered as a report creation hook, this collector automatically captures the current tracing span and attaches it as a Span attachment.

Examples

Basic usage with default settings:

use rootcause::hooks::Hooks;
use rootcause_tracing::SpanCollector;

Hooks::new()
    .report_creation_hook(SpanCollector::new())
    .install()
    .expect("failed to install hooks");

Custom configuration:

use rootcause::hooks::Hooks;
use rootcause_tracing::SpanCollector;

let collector = SpanCollector {
    capture_span_for_reports_with_children: true,
};

Hooks::new()
    .report_creation_hook(collector)
    .install()
    .expect("failed to install hooks");

Fields

capture_span_for_reports_with_children: bool

Whether to capture spans for all reports or only leaf reports (those without children).

When true, all reports get span attachments. When false, only leaf reports do.

Implementations

impl SpanCollector

pub fn new() -> Self

Creates a new SpanCollector with default settings.

Configuration is controlled by environment variables.

Environment Variables

• ROOTCAUSE_TRACING - Comma-separated options:
  • leafs - Only capture tracing spans for leaf errors (errors without children)

Examples

use rootcause::hooks::Hooks;
use rootcause_tracing::SpanCollector;

// Respects ROOTCAUSE_TRACING environment variable
Hooks::new()
    .report_creation_hook(SpanCollector::new())
    .install()
    .expect("failed to install hooks");

Trait Implementations

impl Clone for SpanCollector

fn clone(&self) -> SpanCollector

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for SpanCollector

fn default() -> Self

Returns the “default value” for a type.

impl ReportCreationHook for SpanCollector

fn on_local_creation(&self, report: ReportMut<'_, Dynamic, Local>)

Called when a Local report is created.

fn on_sendsync_creation(&self, report: ReportMut<'_, Dynamic, SendSync>)

Called when a SendSync report is created.

impl Copy for SpanCollector